> ## 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.

> Documentación sobre DESCRIBE TABLE

# DESCRIBE TABLE

Devuelve información sobre las columnas de la tabla.

**Sintaxis**

```sql theme={null}
DESC|DESCRIBE TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]
```

La sentencia `DESCRIBE` devuelve una fila por cada columna de la tabla con los siguientes valores de tipo [String](/es/reference/data-types/string):

* `name` — El nombre de la columna.
* `type` — El tipo de la columna.
* `default_type` — Una cláusula utilizada en la [expresión predeterminada](/es/reference/statements/create/table) de la columna: `DEFAULT`, `MATERIALIZED` o `ALIAS`. Si no hay ninguna expresión predeterminada, se devuelve una cadena vacía.
* `default_expression` — Una expresión especificada después de la cláusula `DEFAULT`.
* `comment` — Un [comentario de columna](/es/reference/statements/alter/column#comment-column).
* `codec_expression` — Un [codec](/es/reference/statements/create/table#column_compression_codec) aplicado a la columna.
* `ttl_expression` — Una expresión [TTL](/es/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl).
* `is_subcolumn` — Un indicador cuyo valor es `1` para las subcolumnas internas. Solo se incluye en el resultado si la descripción de subcolumnas está habilitada mediante la configuración [describe\_include\_subcolumns](/es/reference/settings/session-settings#describe_include_subcolumns).

Todas las columnas de las estructuras de datos [Nested](/es/reference/data-types/nested-data-structures) se describen por separado. El nombre de cada columna lleva como prefijo el nombre de la columna padre y un punto.

Para mostrar las subcolumnas internas de otros tipos de datos, use la configuración [describe\_include\_subcolumns](/es/reference/settings/session-settings#describe_include_subcolumns).

**Ejemplo**

```sql title="Query" theme={null}
CREATE TABLE describe_example (
    id UInt64, text String DEFAULT 'unknown' CODEC(ZSTD),
    user Tuple (name String, age UInt8)
) ENGINE = MergeTree() ORDER BY id;

DESCRIBE TABLE describe_example;
DESCRIBE TABLE describe_example SETTINGS describe_include_subcolumns=1;
```

```text title="Response" theme={null}
┌─name─┬─type──────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ id   │ UInt64                        │              │                    │         │                  │                │
│ text │ String                        │ DEFAULT      │ 'unknown'          │         │ ZSTD(1)          │                │
│ user │ Tuple(name String, age UInt8) │              │                    │         │                  │                │
└──────┴───────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
```

La segunda consulta también muestra subcolumnas:

```text title="Response" theme={null}
┌─name──────┬─type──────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┬─is_subcolumn─┐
│ id        │ UInt64                        │              │                    │         │                  │                │            0 │
│ text      │ String                        │ DEFAULT      │ 'unknown'          │         │ ZSTD(1)          │                │            0 │
│ user      │ Tuple(name String, age UInt8) │              │                    │         │                  │                │            0 │
│ user.name │ String                        │              │                    │         │                  │                │            1 │
│ user.age  │ UInt8                         │              │                    │         │                  │                │            1 │
└───────────┴───────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┴──────────────┘
```

La sentencia DESCRIBE también puede usarse con subconsultas o expresiones escalares:

```SQL theme={null}
DESCRIBE SELECT 1 FORMAT TSV;
```

o

```SQL theme={null}
DESCRIBE (SELECT 1) FORMAT TSV;
```

```text title="Response" theme={null}
1       UInt8
```

Este uso devuelve metadatos sobre las columnas de resultados de la consulta o subconsulta especificada. Es útil para comprender la estructura de consultas complejas antes de ejecutarlas.

**Véase también**

* Ajuste [describe\_include\_subcolumns](/es/reference/settings/session-settings#describe_include_subcolumns).