Pular para o conteúdo principal

Descrição

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, mas para várias tabelas ao mesmo tempo. As colunas de tabelas temporárias ficam visíveis em system.columns apenas na sessão em que foram criadas. Elas são exibidas com o campo database vazio.

Colunas

  • database (String) — Nome do banco de dados.
  • table (String) — Nome da tabela.
  • name (String) — Nome da coluna.
  • type (String) — Tipo da coluna.
  • position (UInt64) — Posição ordinal de uma coluna em uma tabela, começando em 1.
  • default_kind (String) — Tipo de expressão (DEFAULT, MATERIALIZED, ALIAS) para o valor padrão, ou uma string vazia se não estiver definido.
  • default_expression (String) — Expressão do valor padrão, ou uma string vazia se não estiver definida.
  • data_compressed_bytes (UInt64) — Tamanho dos dados comprimidos, em bytes.
  • data_uncompressed_bytes (UInt64) — Tamanho dos dados descomprimidos, em bytes.
  • marks_bytes (UInt64) — Tamanho das marcas, em bytes.
  • comment (String) — Comentário da coluna, ou uma string vazia se não estiver definido.
  • is_in_partition_key (UInt8) — Indicador que informa se a coluna está na expressão de partição.
  • is_in_sorting_key (UInt8) — Indicador que informa se a coluna está na expressão da chave de ordenação.
  • is_in_primary_key (UInt8) — Indicador que informa se a coluna está na expressão da chave primária.
  • is_in_sampling_key (UInt8) — Indicador que informa se a coluna está na expressão da chave de amostragem.
  • compression_codec (String) — Nome do codec de compressão.
  • character_octet_length (Nullable(UInt64)) — 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)) — 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)) — 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)) — 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)) — Precisão decimal do tipo de dado DateTime64. Para outros tipos de dados, o valor NULL é retornado.
  • serialization_hint (Nullable(String)) — Uma sugestão para a coluna escolher a serialização nas inserções de acordo com as estatísticas.
  • statistics (String) — Tipos de estatísticas criados nesta coluna.

Exemplo

SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;
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:      ᴺᵁᴸᴸ
Última modificação em 10 de junho de 2026