Type énuméré composé de valeurs nommées.
Les valeurs nommées peuvent être déclarées sous forme de paires 'string' = integer ou simplement comme des noms 'string'. ClickHouse ne stocke que des nombres, mais permet d’effectuer des opérations sur les valeurs via leurs noms.
ClickHouse prend en charge :
Enum sur 8 bits. Il peut contenir jusqu’à 256 valeurs énumérées dans la plage [-128, 127].Enum sur 16 bits. Il peut contenir jusqu’à 65536 valeurs énumérées dans la plage [-32768, 32767].
ClickHouse choisit automatiquement le type de Enum lors de l’insertion des données. Vous pouvez également utiliser les types Enum8 ou Enum16 pour maîtriser la taille de stockage.
Nous créons ici une table avec une colonne de type Enum8('hello' = 1, 'world' = 2) :
CREATE TABLE t_enum
(
x Enum('hello' = 1, 'world' = 2)
)
ENGINE = TinyLog
CREATE TABLE t_enum
(
x Enum('hello', 'world')
)
ENGINE = TinyLog
CREATE TABLE t_enum
(
x Enum('hello' = 1, 'world')
)
ENGINE = TinyLog
CREATE TABLE t_enum
(
x Enum8('hello' = -129, 'world')
)
ENGINE = TinyLog
Exception on server:
Code: 69. DB::Exception: Value -129 for element 'hello' exceeds range of Enum8.
x ne peut stocker que les valeurs indiquées dans la définition du type : 'hello' ou 'world'. Si vous essayez d’enregistrer une autre valeur, ClickHouse lèvera une exception. Une taille de 8 bits est automatiquement choisie pour cet Enum.
INSERT INTO t_enum VALUES ('hello'), ('world'), ('hello')
INSERT INTO t_enum VALUES('a')
Exception on client:
Code: 49. DB::Exception: Unknown element 'a' for type Enum('hello' = 1, 'world' = 2)
Enum.
┌─x─────┐
│ hello │
│ world │
│ hello │
└───────┘
Enum en entier.
SELECT CAST(x, 'Int8') FROM t_enum
┌─CAST(x, 'Int8')─┐
│ 1 │
│ 2 │
│ 1 │
└─────────────────┘
CAST.
SELECT toTypeName(CAST('a', 'Enum(\'a\' = 1, \'b\' = 2)'))
┌─toTypeName(CAST('a', 'Enum(\'a\' = 1, \'b\' = 2)'))─┐
│ Enum8('a' = 1, 'b' = 2) │
└─────────────────────────────────────────────────────┘
Règles générales et utilisation
-128 ... 127 pour Enum8 ou entre -32768 ... 32767 pour Enum16. Toutes les chaînes et tous les nombres doivent être distincts. Une chaîne vide est autorisée. Si ce type est spécifié (dans une définition de table), les nombres peuvent être dans un ordre quelconque. Toutefois, l’ordre n’a aucune importance.
Ni la chaîne ni la valeur numérique d’un Enum ne peuvent être NULL.
Un Enum peut être inclus dans le type Nullable. Ainsi, si vous créez une table à l’aide de la requête
CREATE TABLE t_enum_nullable
(
x Nullable( Enum8('hello' = 1, 'world' = 2) )
)
ENGINE = TinyLog
'hello' et 'world', mais également NULL.
INSERT INTO t_enum_nullable VALUES('hello'),('world'),(NULL)
Enum est stockée de la même manière que Int8 ou Int16 avec les valeurs numériques correspondantes.
Lors de la lecture au format texte, ClickHouse analyse la valeur comme une chaîne et recherche la chaîne correspondante dans l’ensemble des valeurs de l’Enum. Si elle est introuvable, une exception est levée. Lors de la lecture au format texte, la chaîne est lue puis la valeur numérique correspondante est recherchée. Une exception est levée si elle est introuvable.
Lors de l’écriture au format texte, la valeur est écrite sous la forme de la chaîne correspondante. Si les données de la colonne contiennent des valeurs invalides (des nombres qui ne font pas partie de l’ensemble autorisé), une exception est levée. Lors de la lecture et de l’écriture sous forme binaire, le fonctionnement est le même que pour les types de données Int8 et Int16.
La valeur par défaut implicite est celle qui porte le plus petit nombre.
Lors de ORDER BY, GROUP BY, IN, DISTINCT, etc., les Enum se comportent comme les nombres correspondants. Par exemple, ORDER BY les trie numériquement. Les opérateurs d’égalité et de comparaison fonctionnent de la même façon sur les Enum que sur les valeurs numériques sous-jacentes.
Les valeurs Enum ne peuvent pas être comparées à des nombres. Les Enum peuvent être comparés à une chaîne constante. Si la chaîne de comparaison n’est pas une valeur valide pour l’Enum, une exception est levée. L’opérateur IN est pris en charge avec l’Enum à gauche et un ensemble de chaînes à droite. Les chaînes correspondent aux valeurs de l’Enum.
La plupart des opérations numériques et sur les chaînes ne sont pas définies pour les valeurs Enum, par ex. ajouter un nombre à un Enum ou concaténer une chaîne à un Enum.
Cependant, l’Enum dispose d’une fonction naturelle toString qui renvoie sa valeur sous forme de chaîne.
Les valeurs Enum peuvent également être converties en types numériques à l’aide de la fonction toT, où T est un type numérique. Lorsque T correspond au type numérique sous-jacent de l’Enum, cette conversion est sans coût.
Le type Enum peut être modifié sans coût à l’aide d’ALTER, si seul l’ensemble des valeurs est modifié. Il est possible d’ajouter et de supprimer des membres de l’Enum à l’aide d’ALTER (la suppression n’est sûre que si la valeur supprimée n’a jamais été utilisée dans la table). Par mesure de sécurité, modifier la valeur numérique d’un membre d’Enum précédemment défini lèvera une exception.
À l’aide d’ALTER, il est possible de remplacer un Enum8 par un Enum16, ou inversement, tout comme on remplace un Int8 par un Int16.
AJOUTER DES VALEURS À UN ENUM
CREATE TABLE enum
(
x Enum('One' = 1, 'Two', 'Three')
) ENGINE = Memory;
ALTER TABLE enum MODIFY COLUMN x ADD ENUM VALUES ('Zero' = 0, 'Four' = 4);
SHOW CREATE TABLE enum;
┌─statement────────────────────────────────────────────────────────────────┐
│CREATE TABLE default.enum │
│( │
│ `x` Enum8('Zero' = 0, 'One' = 1, 'Two' = 2, 'Three' = 3, 'Four' = 4) │
│) │
│ENGINE = Memory │
└──────────────────────────────────────────────────────────────────────────┘
Dernière modification le 25 juin 2026
