L’encodage des types numériques correspond à l’organisation en mémoire des processeurs little-endian comme AMD64 ou ARM64, ce qui permet un encodage et un décodage très efficaces.
| Type | Encodage |
|---|---|
| Entiers (Int/UInt) | 8, 16, 32, 64, 128 ou 256 bits en little-endian |
| Flottants (Float32/Float64) | Représentation binaire IEEE 754 |
| String | Tableau de chaînes sous la forme (len, value) |
| FixedString(N) | Tableau de séquences de N octets |
| IPv4 | Alias de UInt32, représenté sous forme de UInt32 |
| IPv6 | Alias de FixedString(16), représenté en binaire |
| Tuple | Tableau de colonnes encodées de manière contiguë. Exemple : Tuple(String, UInt8) = deux colonnes contiguës |
| Map | Map(K, V) = trois colonnes : Offsets ColUInt64, Keys K, Values V. Nombre de lignes dans Keys/Values = dernière valeur de Offsets |
| Array | Array(T) = deux colonnes : Offsets ColUInt64, Data T. Nombre de lignes dans Data = dernière valeur de Offsets |
| Nullable | Nullable(T) = deux colonnes : Nulls ColUInt8, Values T avec le même nombre de lignes. Nulls est un masque : 1=NULL, 0=valeur |
| UUID | Alias de FixedString(16), représenté en binaire |
| Enum | Alias de Int8 ou Int16, chaque entier étant associé à une valeur String |
| LowCardinality | LowCardinality(T) = deux colonnes : Index T, Keys K où K est UInt8/16/32/64. Index contient les valeurs uniques, Keys contient les index vers Index |
| Bool | Alias de UInt8 : 0=false, 1=true |
To encode [null, "", "hello", null, "world"]:
Values: ["", "", "hello", "", "world"] (len: 5)
Nulls: [ 1, 0, 0, 1, 0] (len: 5)
To encode ["Eko", "Eko", "Amadela", "Amadela", "Amadela", "Amadela"]:
Index: ["Eko", "Amadela"] (String)
Keys: [0, 0, 1, 1, 1, 1] (UInt8)