> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tabela do sistema que contém informações sobre as colunas de todas as tabelas

# system.columns

<div id="description">
  ## Descrição
</div>

Contém informações sobre as colunas de todas as tabelas.

Você pode usar esta tabela para obter informações semelhantes às da consulta [DESCRIBE TABLE](/pt-BR/reference/statements/describe-table), mas para várias tabelas ao mesmo tempo.

As colunas de [tabelas temporárias](/pt-BR/reference/statements/create/table#temporary-tables) ficam visíveis em `system.columns` apenas na sessão em que foram criadas. Elas são exibidas com o campo `database` vazio.

<div id="columns">
  ## Colunas
</div>

* `database` ([String](/pt-BR/reference/data-types)) — Nome do banco de dados.
* `table` ([String](/pt-BR/reference/data-types)) — Nome da tabela.
* `name` ([String](/pt-BR/reference/data-types)) — Nome da coluna.
* `type` ([String](/pt-BR/reference/data-types)) — Tipo da coluna.
* `position` ([UInt64](/pt-BR/reference/data-types)) — Posição ordinal de uma coluna em uma tabela, começando em 1.
* `default_kind` ([String](/pt-BR/reference/data-types)) — Tipo de expressão (DEFAULT, MATERIALIZED, ALIAS) para o valor padrão, ou uma string vazia se não estiver definido.
* `default_expression` ([String](/pt-BR/reference/data-types)) — Expressão do valor padrão, ou uma string vazia se não estiver definida.
* `data_compressed_bytes` ([UInt64](/pt-BR/reference/data-types)) — Tamanho dos dados comprimidos, em bytes.
* `data_uncompressed_bytes` ([UInt64](/pt-BR/reference/data-types)) — Tamanho dos dados descomprimidos, em bytes.
* `marks_bytes` ([UInt64](/pt-BR/reference/data-types)) — Tamanho das marcas, em bytes.
* `comment` ([String](/pt-BR/reference/data-types)) — Comentário da coluna, ou uma string vazia se não estiver definido.
* `is_in_partition_key` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a coluna está na expressão de partição.
* `is_in_sorting_key` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a coluna está na expressão da chave de ordenação.
* `is_in_primary_key` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a coluna está na expressão da chave primária.
* `is_in_sampling_key` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a coluna está na expressão da chave de amostragem.
* `compression_codec` ([String](/pt-BR/reference/data-types)) — Nome do codec de compressão.
* `character_octet_length` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Comprimento máximo, em bytes, para dados binários, dados de caracteres ou dados de texto e imagens. No ClickHouse, isso só faz sentido para o tipo de dado FixedString. Caso contrário, o valor NULL é retornado.
* `numeric_precision` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Precisão de dados numéricos aproximados, dados numéricos exatos, dados inteiros ou dados monetários. No ClickHouse, corresponde à largura em bits para tipos inteiros e à precisão decimal para tipos Decimal. Caso contrário, o valor NULL é retornado.
* `numeric_precision_radix` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Base do sistema numérico da precisão de dados numéricos aproximados, dados numéricos exatos, dados inteiros ou dados monetários. No ClickHouse, é 2 para tipos inteiros e 10 para tipos Decimal. Caso contrário, o valor NULL é retornado.
* `numeric_scale` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Escala de dados numéricos aproximados, dados numéricos exatos, dados inteiros ou dados monetários. No ClickHouse, isso só faz sentido para tipos Decimal. Caso contrário, o valor NULL é retornado.
* `datetime_precision` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Precisão decimal do tipo de dado DateTime64. Para outros tipos de dados, o valor NULL é retornado.
* `serialization_hint` ([Nullable(String)](/pt-BR/reference/data-types)) — Uma sugestão para a coluna escolher a serialização nas inserções de acordo com as estatísticas.
* `statistics` ([String](/pt-BR/reference/data-types)) — Tipos de estatísticas criados nesta coluna.

<div id="example">
  ## Exemplo
</div>

```sql theme={null}
SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;
```

```text theme={null}
Row 1:
──────
database:                INFORMATION_SCHEMA
table:                   COLUMNS
name:                    table_catalog
type:                    String
position:                1
default_kind:
default_expression:
data_compressed_bytes:   0
data_uncompressed_bytes: 0
marks_bytes:             0
comment:
is_in_partition_key:     0
is_in_sorting_key:       0
is_in_primary_key:       0
is_in_sampling_key:      0
compression_codec:
character_octet_length:  ᴺᵁᴸᴸ
numeric_precision:       ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale:           ᴺᵁᴸᴸ
datetime_precision:      ᴺᵁᴸᴸ

Row 2:
──────
database:                INFORMATION_SCHEMA
table:                   COLUMNS
name:                    table_schema
type:                    String
position:                2
default_kind:
default_expression:
data_compressed_bytes:   0
data_uncompressed_bytes: 0
marks_bytes:             0
comment:
is_in_partition_key:     0
is_in_sorting_key:       0
is_in_primary_key:       0
is_in_sampling_key:      0
compression_codec:
character_octet_length:  ᴺᵁᴸᴸ
numeric_precision:       ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale:           ᴺᵁᴸᴸ
datetime_precision:      ᴺᵁᴸᴸ
```