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) — O tamanho dos dados comprimidos, em bytes.
  • data_uncompressed_bytes (UInt64) — O tamanho dos dados descomprimidos, em bytes.
  • marks_bytes (UInt64) — O 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) — Flag que indica se a coluna está na expressão de partição.
  • is_in_sorting_key (UInt8) — Flag que indica se a coluna está na expressão da chave de ordenação.
  • is_in_primary_key (UInt8) — Flag que indica se a coluna está na expressão da chave primária.
  • is_in_sampling_key (UInt8) — Flag que indica 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, 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, isso 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)) — A 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)) — A 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 dado, o valor NULL é retornado.
  • serialization_hint (Nullable(String)) — Uma indicação para a coluna escolher a serialização em inserts de acordo com as estatísticas.
  • statistics (String) — Os tipos de estatísticas criados nessas colunas.

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 29 de junho de 2026