> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Configuración de la clave y de los atributos del diccionario
# Atributos del diccionario
Si usa un diccionario con ClickHouse Cloud, utilice la opción de consulta DDL para crear sus diccionarios y cree el diccionario como el usuario `default`.
Además, consulte la lista de orígenes de diccionario compatibles en la [guía de compatibilidad de Cloud](/es/products/cloud/guides/cloud-compatibility).
La cláusula `structure` describe la clave del diccionario y los campos disponibles para las consultas.
Descripción XML:
```xml theme={null}
Id
...
```
Los atributos se describen en los siguientes elementos:
* `` — Columna clave
* `` — Columna de datos: puede haber varios atributos.
Sentencia DDL:
```sql theme={null}
CREATE DICTIONARY dict_name (
Id UInt64,
-- atributos
)
PRIMARY KEY Id
...
```
Los atributos se describen en el cuerpo de la consulta:
* `PRIMARY KEY` — Columna clave
* `AttrName AttrType` — Columna de datos. Puede haber múltiples atributos.
## Clave
ClickHouse admite los siguientes tipos de claves:
* Clave numérica. `UInt64`. Se define en la etiqueta `` o mediante la palabra clave `PRIMARY KEY`.
* Clave compuesta. Conjunto de valores de distintos tipos. Se define en la etiqueta `` o mediante la palabra clave `PRIMARY KEY`.
Una estructura XML puede contener `` o ``. La sentencia DDL debe contener una única `PRIMARY KEY`.
No debe describir la clave como un atributo.
### Clave numérica
Tipo: `UInt64`.
Ejemplo de configuración:
```xml theme={null}
Id
```
Campos de configuración:
* `name` – El nombre de la columna con claves.
Para la sentencia DDL:
```sql theme={null}
CREATE DICTIONARY (
Id UInt64,
...
)
PRIMARY KEY Id
...
```
* `PRIMARY KEY` – El nombre de la columna que contiene las claves.
### Clave compuesta
La clave puede ser una `tuple` formada por campos de cualquier tipo. El [layout](/es/reference/statements/create/dictionary/layouts/overview) en este caso debe ser `complex_key_hashed` o `complex_key_cache`.
Una clave compuesta puede constar de un solo elemento. Esto permite, por ejemplo, usar una cadena como clave.
La estructura de la clave se define en el elemento ``. Los campos de la clave se especifican en el mismo formato que los [atributos](#attributes) del diccionario. Ejemplo:
```xml theme={null}
field1
String
field2
UInt32
...
...
```
o
```sql theme={null}
CREATE DICTIONARY (
field1 String,
field2 UInt32
...
)
PRIMARY KEY field1, field2
...
```
En una consulta a la función `dictGet*`, se pasa una tupla como clave. Ejemplo: `dictGetString('dict_name', 'attr_name', tuple('string for field1', num_for_field2))`.
## Atributos
Ejemplo de configuración:
```xml theme={null}
...
Name
ClickHouseDataType
rand64()
true
true
true
```
or
```sql theme={null}
CREATE DICTIONARY somename (
Name ClickHouseDataType DEFAULT '' EXPRESSION rand64() HIERARCHICAL INJECTIVE IS_OBJECT_ID
)
```
Campos de configuración:
| Etiqueta | Descripción | Obligatorio |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| `name` | Nombre de la columna. | Sí |
| `type` | Tipo de dato de ClickHouse: [UInt8](/es/reference/data-types/int-uint), [UInt16](/es/reference/data-types/int-uint), [UInt32](/es/reference/data-types/int-uint), [UInt64](/es/reference/data-types/int-uint), [Int8](/es/reference/data-types/int-uint), [Int16](/es/reference/data-types/int-uint), [Int32](/es/reference/data-types/int-uint), [Int64](/es/reference/data-types/int-uint), [Float32](/es/reference/data-types/float), [Float64](/es/reference/data-types/float), [UUID](/es/reference/data-types/uuid), [Decimal32](/es/reference/data-types/decimal), [Decimal64](/es/reference/data-types/decimal), [Decimal128](/es/reference/data-types/decimal), [Decimal256](/es/reference/data-types/decimal),[Date](/es/reference/data-types/date), [Date32](/es/reference/data-types/date32), [DateTime](/es/reference/data-types/datetime), [DateTime64](/es/reference/data-types/datetime64), [String](/es/reference/data-types/string), [Array](/es/reference/data-types/array).
ClickHouse intenta convertir el valor del diccionario al tipo de dato especificado. Por ejemplo, en MySQL, el field puede ser `TEXT`, `VARCHAR` o `BLOB` en la tabla de origen de MySQL, pero puede cargarse como `String` en ClickHouse.
Actualmente, [Nullable](/es/reference/data-types/nullable) se admite para los diccionarios [Flat](/es/reference/statements/create/dictionary/layouts/flat), [Hashed](/es/reference/statements/create/dictionary/layouts/hashed), [ComplexKeyHashed](/es/reference/statements/create/dictionary/layouts/hashed#complex_key_hashed), [Direct](/es/reference/statements/create/dictionary/layouts/direct), [ComplexKeyDirect](/es/reference/statements/create/dictionary/layouts/direct#complex_key_direct), [RangeHashed](/es/reference/statements/create/dictionary/layouts/range-hashed), Polygon, [Cache](/es/reference/statements/create/dictionary/layouts/cache), [ComplexKeyCache](/es/reference/statements/create/dictionary/layouts/cache), [SSDCache](/es/reference/statements/create/dictionary/layouts/ssd-cache), [SSDComplexKeyCache](/es/reference/statements/create/dictionary/layouts/ssd-cache#complex_key_ssd_cache). En los diccionarios [IPTrie](/es/reference/statements/create/dictionary/layouts/ip-trie), no se admiten tipos `Nullable`. | Sí |
| `null_value` | Valor predeterminado para un elemento que no existe.
En el ejemplo, es una cadena vacía. El valor [NULL](/es/reference/syntax#null) solo puede usarse para los tipos `Nullable` (consulte la línea anterior con la descripción de los tipos). | Sí |
| `expression` | [Expresión](/es/reference/syntax#expressions) que ClickHouse ejecuta sobre el valor.
La expresión puede ser un nombre de columna en la base de datos SQL remota. Por lo tanto, puede usarla para crear un alias para la columna remota.
Valor predeterminado: sin expresión. | No |
| `hierarchical` | Si es `true`, el atributo contiene el valor de la clave padre de la clave actual. Consulte [Hierarchical Dictionaries](/es/reference/statements/create/dictionary/layouts/hierarchical).
Valor predeterminado: `false`. | No |
| `injective` | Indicador que muestra si el mapeo `id -> attribute` es [inyectivo](https://en.wikipedia.org/wiki/Injective_function).
Si es `true`, ClickHouse puede colocar automáticamente, después de la cláusula `GROUP BY`, las solicitudes a diccionarios con esta propiedad. Por lo general, esto reduce significativamente la cantidad de dichas solicitudes.
Valor predeterminado: `false`. | No |
| `is_object_id` | Indicador que muestra si la consulta se ejecuta para un documento de MongoDB mediante `ObjectID`.
Valor predeterminado: `false`. | |