> ## 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.
> Configuration de la clé et des attributs du dictionnaire
# Attributs du dictionnaire
Si vous utilisez un dictionary avec ClickHouse Cloud, utilisez l’option DDL query pour créer vos dictionaries, et créez votre dictionary en tant qu’utilisateur `default`.
Vérifiez également la liste des dictionary sources prises en charge dans le [guide de compatibilité Cloud](/fr/products/cloud/guides/cloud-compatibility).
La clause `structure` décrit la clé du dictionnaire et les champs disponibles pour les requêtes.
Description XML :
```xml theme={null}
Id
...
```
Les attributs sont décrits dans les éléments :
* `` — colonne clé
* `` — colonne de données : il peut y avoir plusieurs attributs.
Requête DDL :
```sql theme={null}
CREATE DICTIONARY dict_name (
Id UInt64,
-- attributes
)
PRIMARY KEY Id
...
```
Les attributs sont décrits dans le corps de la requête :
* `PRIMARY KEY` — Colonne clé
* `AttrName AttrType` — Colonne de données. Il peut y avoir plusieurs attributs.
## Clé
ClickHouse prend en charge les types de clés suivants :
* Clé numérique. `UInt64`. Définie dans la balise `` ou à l’aide du mot-clé `PRIMARY KEY`.
* Clé composite. Ensemble de valeurs de types différents. Définie dans la balise `` ou à l’aide du mot-clé `PRIMARY KEY`.
Une structure XML peut contenir soit ``, soit ``. La requête DDL ne doit contenir qu’une seule `PRIMARY KEY`.
Vous ne devez pas décrire une clé comme un attribut.
### Clé numérique
Type : `UInt64`.
Exemple de configuration :
```xml theme={null}
Id
```
Champs de configuration :
* `name` – Le nom de la colonne contenant les clés.
Pour la requête DDL :
```sql theme={null}
CREATE DICTIONARY (
Id UInt64,
...
)
PRIMARY KEY Id
...
```
* `PRIMARY KEY` – Le nom de la colonne contenant les clés.
### Clé composite
La clé peut être un `tuple` composé de champs de n’importe quel type. Le [layout](/fr/reference/statements/create/dictionary/layouts/overview) doit alors être `complex_key_hashed` ou `complex_key_cache`.
Une clé composite peut être constituée d’un seul élément. Cela permet par exemple d’utiliser une chaîne comme clé.
La structure de la clé est définie dans l’élément ``. Les champs de la clé sont spécifiés dans le même format que les [attributs](#attributes) du dictionnaire. Exemple :
```xml theme={null}
field1
String
field2
UInt32
...
...
```
ou
```sql theme={null}
CREATE DICTIONARY (
field1 String,
field2 UInt32
...
)
PRIMARY KEY field1, field2
...
```
Pour une requête adressée à la fonction `dictGet*`, un tuple est utilisé comme clé. Exemple : `dictGetString('dict_name', 'attr_name', tuple('string for field1', num_for_field2))`.
## Attributs
Exemple de configuration :
```xml theme={null}
...
Name
ClickHouseDataType
rand64()
true
true
true
```
ou
```sql theme={null}
CREATE DICTIONARY somename (
Name ClickHouseDataType DEFAULT '' EXPRESSION rand64() HIERARCHICAL INJECTIVE IS_OBJECT_ID
)
```
Champs de configuration :
| Balise | Description | Obligatoire |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| `name` | Nom de la colonne. | Oui |
| `type` | Type de données ClickHouse : [UInt8](/fr/reference/data-types/int-uint), [UInt16](/fr/reference/data-types/int-uint), [UInt32](/fr/reference/data-types/int-uint), [UInt64](/fr/reference/data-types/int-uint), [Int8](/fr/reference/data-types/int-uint), [Int16](/fr/reference/data-types/int-uint), [Int32](/fr/reference/data-types/int-uint), [Int64](/fr/reference/data-types/int-uint), [Float32](/fr/reference/data-types/float), [Float64](/fr/reference/data-types/float), [UUID](/fr/reference/data-types/uuid), [Decimal32](/fr/reference/data-types/decimal), [Decimal64](/fr/reference/data-types/decimal), [Decimal128](/fr/reference/data-types/decimal), [Decimal256](/fr/reference/data-types/decimal),[Date](/fr/reference/data-types/date), [Date32](/fr/reference/data-types/date32), [DateTime](/fr/reference/data-types/datetime), [DateTime64](/fr/reference/data-types/datetime64), [String](/fr/reference/data-types/string), [Array](/fr/reference/data-types/array).
ClickHouse essaie de convertir la valeur du dictionnaire dans le type de données spécifié. Par exemple, avec MySQL, le champ peut être de type `TEXT`, `VARCHAR` ou `BLOB` dans la table source MySQL, mais être importé en tant que `String` dans ClickHouse.
[Nullable](/fr/reference/data-types/nullable) est actuellement pris en charge pour les dictionnaires [Flat](/fr/reference/statements/create/dictionary/layouts/flat), [Hashed](/fr/reference/statements/create/dictionary/layouts/hashed), [ComplexKeyHashed](/fr/reference/statements/create/dictionary/layouts/hashed#complex_key_hashed), [Direct](/fr/reference/statements/create/dictionary/layouts/direct), [ComplexKeyDirect](/fr/reference/statements/create/dictionary/layouts/direct#complex_key_direct), [RangeHashed](/fr/reference/statements/create/dictionary/layouts/range-hashed), Polygon, [Cache](/fr/reference/statements/create/dictionary/layouts/cache), [ComplexKeyCache](/fr/reference/statements/create/dictionary/layouts/cache), [SSDCache](/fr/reference/statements/create/dictionary/layouts/ssd-cache), [SSDComplexKeyCache](/fr/reference/statements/create/dictionary/layouts/ssd-cache#complex_key_ssd_cache). Dans les dictionnaires [IPTrie](/fr/reference/statements/create/dictionary/layouts/ip-trie), les types `Nullable` ne sont pas pris en charge. | Oui |
| `null_value` | Valeur par défaut pour un élément inexistant.
Dans l'exemple, il s'agit d'une chaîne vide. La valeur [NULL](/fr/reference/syntax#null) ne peut être utilisée que pour les types `Nullable` (voir la ligne précédente décrivant les types). | Oui |
| `expression` | [Expression](/fr/reference/syntax#expressions) que ClickHouse exécute sur la valeur.
L'expression peut être un nom de colonne dans la base de données SQL distante. Vous pouvez donc l'utiliser pour créer un alias pour la colonne distante.
Valeur par défaut : aucune expression. | Non |
| `hierarchical` | Si `true`, l'attribut contient la valeur d'une clé parente pour la clé actuelle. Voir [Dictionnaires hiérarchiques](/fr/reference/statements/create/dictionary/layouts/hierarchical).
Valeur par défaut : `false`. | Non |
| `injective` | Indicateur signalant si l'application `id -> attribute` est [injective](https://en.wikipedia.org/wiki/Injective_function).
Si `true`, ClickHouse peut automatiquement placer, après la clause `GROUP BY`, les requêtes adressées aux dictionnaires dont l'application est injective. Cela réduit généralement de manière significative le nombre de ces requêtes.
Valeur par défaut : `false`. | Non |
| `is_object_id` | Indicateur signalant si la requête est exécutée sur un document MongoDB via `ObjectID`.
Valeur par défaut : `false`. | |