> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Calculs de bitmap ou d’agrégation à partir d’une colonne d’entiers non signés ; renvoie une cardinalité de type UInt64. Si vous ajoutez le suffixe -State, renvoie alors un objet bitmap

# groupBitmap

<div id="groupBitmap">
  ## groupBitmap
</div>

Introduit dans : v20.1.0

Crée un bitmap (tableau de bits) à partir d’une colonne d’entiers non signés, puis renvoie le nombre de valeurs uniques (cardinalité) de ce bitmap.
En ajoutant le suffixe de combinator `-State`, au lieu de renvoyer ce nombre, cette fonction renvoie l’[objet bitmap](/fr/reference/functions/regular-functions/bitmap-functions) lui-même.

**Syntaxe**

```sql theme={null}
groupBitmap(expr)
groupBitmapState(expr)
```

**Arguments**

* `expr` — expression dont le résultat est de type `UInt*`. [`UInt*`](/fr/reference/data-types/int-uint)

**Valeur renvoyée**

Renvoie un nombre de type `UInt64`, ou un objet bitmap lors de l'utilisation de `-State`. [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
CREATE TABLE t (UserID UInt32) ENGINE = Memory;
INSERT INTO t VALUES (1), (1), (2), (3);

SELECT groupBitmap(UserID) AS num FROM t;
```

```response title=Response theme={null}
┌─num─┐
│   3 │
└─────┘
```