Pular para o conteúdo principal

Descrição

Contém os metadados de cada tabela conhecida pelo servidor. As tabelas Detached não são exibidas em system.tables. As tabelas temporárias ficam visíveis em system.tables apenas na sessão em que foram criadas. Elas são exibidas com o campo database vazio e com a flag is_temporary ativada.

Colunas

  • database (String) — O nome do banco de dados ao qual a tabela pertence.
  • name (String) — Nome da tabela.
  • uuid (UUID) — UUID da tabela (banco de dados Atomic).
  • engine (String) — Nome do mecanismo da tabela (sem parâmetros).
  • is_temporary (UInt8) — Indicador que informa se a tabela é temporária.
  • data_paths (Array(String)) — Caminhos para os dados da tabela nos sistemas de arquivos.
  • metadata_path (String) — Caminho dos metadados da tabela no sistema de arquivos.
  • metadata_modification_time (DateTime) — Hora da última modificação dos metadados da tabela.
  • metadata_version (Int32) — Versão dos metadados da tabela ReplicatedMergeTree; 0 para tabelas que não são ReplicatedMergeTree.
  • dependencies_database (Array(String)) — Dependências do banco de dados.
  • dependencies_table (Array(String)) — Dependências da tabela (visões materializadas da tabela atual).
  • create_table_query (String) — A consulta usada para criar a tabela.
  • engine_full (String) — Parâmetros do mecanismo da tabela.
  • as_select (String) — consulta SELECT da view.
  • parameterized_view_parameters (Array(Tuple(name String, type String))) — Parâmetros da view parametrizada.
  • partition_key (String) — A expressão da chave de partição especificada na tabela.
  • sorting_key (String) — A expressão da chave de ordenação especificada na tabela.
  • primary_key (String) — A expressão da chave primária especificada na tabela.
  • sampling_key (String) — A expressão da chave de amostragem especificada na tabela.
  • unique_key (String) — A expressão de chave única definida na tabela (cláusula UNIQUE KEY).
  • storage_policy (String) — Política de armazenamento. Relevante para tabelas que usam os motores MergeTree e Distributed.
  • total_rows (Nullable(UInt64)) — Número total de linhas, caso seja possível determinar rapidamente o número exato de linhas da tabela; caso contrário, NULL (incluindo a tabela Buffer subjacente).
  • total_bytes (Nullable(UInt64)) — Número total de bytes, se for possível determinar rapidamente o número exato de bytes da tabela no armazenamento; caso contrário, NULL (não inclui nenhum armazenamento subjacente). Se a tabela armazenar dados em disco, retorna o espaço usado em disco (ou seja, compactado). Se a tabela armazenar dados na memória, retorna o número aproximado de bytes usados na memória.
  • total_bytes_uncompressed (Nullable(UInt64)) — Número total de bytes não compactados, se for possível determinar rapidamente o número exato de bytes a partir dos checksums das partes da tabela no armazenamento; caso contrário, NULL (não leva em conta o armazenamento subjacente, se houver).
  • parts (Nullable(UInt64)) — O número total de partes nesta tabela.
  • active_parts (Nullable(UInt64)) — O número de partes ativas nesta tabela.
  • total_marks (Nullable(UInt64)) — O número total de marcas em todas as partes desta tabela.
  • active_on_fly_data_mutations (UInt64) — Número total de mutações de dados ativas (UPDATEs e DELETEs) que podem ser aplicadas em tempo real.
  • active_on_fly_alter_mutations (UInt64) — Número total de mutações ALTER ativas (MODIFY COLUMN) que podem ser aplicadas imediatamente.
  • active_on_fly_metadata_mutations (UInt64) — Número total de mutações de metadados ativas (RENAMEs) que podem ser aplicadas dinamicamente.
  • columns_descriptions_cache_size (UInt64) — Tamanho do cache de descrições de colunas para tabelas *MergeTree
  • lifetime_rows (Nullable(UInt64)) — Número total de linhas inseridas desde o início do servidor (somente para tabelas Buffer).
  • lifetime_bytes (Nullable(UInt64)) — Número total de bytes inseridos desde o início do servidor (apenas para tabelas Buffer).
  • comment (String) — O comentário da tabela.
  • has_own_data (UInt8) — Indicador que informa se a própria tabela armazena dados em disco ou apenas acessa outra fonte.
  • loading_dependencies_database (Array(String)) — Dependências para carregamento do banco de dados (lista de objetos que devem ser carregados antes do objeto atual).
  • loading_dependencies_table (Array(String)) — Dependências de carregamento da tabela (lista de objetos que precisam ser carregados antes do objeto atual).
  • loading_dependent_database (Array(String)) — Banco de dados dependente em carregamento.
  • loading_dependent_table (Array(String)) — Tabela dependente para carregamento.
  • definer (String) — nome do definidor de SQL security usado na tabela.

Exemplo

SELECT * FROM system.tables LIMIT 2 FORMAT Vertical;
Row 1:
──────
database:                   base
name:                       t1
uuid:                       81b1c20a-b7c6-4116-a2ce-7583fb6b6736
engine:                     MergeTree
is_temporary:               0
data_paths:                 ['/var/lib/clickhouse/store/81b/81b1c20a-b7c6-4116-a2ce-7583fb6b6736/']
metadata_path:              /var/lib/clickhouse/store/461/461cf698-fd0b-406d-8c01-5d8fd5748a91/t1.sql
metadata_modification_time: 2021-01-25 19:14:32
dependencies_database:      []
dependencies_table:         []
create_table_query:         CREATE TABLE base.t1 (`n` UInt64) ENGINE = MergeTree ORDER BY n
engine_full:                MergeTree ORDER BY n
as_select:                  SELECT database AS table_catalog
partition_key:
sorting_key:                n
primary_key:                n
sampling_key:
storage_policy:             default
total_rows:                 1
total_bytes:                99
lifetime_rows:              ᴺᵁᴸᴸ
lifetime_bytes:             ᴺᵁᴸᴸ
comment:
has_own_data:               0
loading_dependencies_database: []
loading_dependencies_table:    []
loading_dependent_database:    []
loading_dependent_table:       []

Row 2:
──────
database:                   default
name:                       53r93yleapyears
uuid:                       00000000-0000-0000-0000-000000000000
engine:                     MergeTree
is_temporary:               0
data_paths:                 ['/var/lib/clickhouse/data/default/53r93yleapyears/']
metadata_path:              /var/lib/clickhouse/metadata/default/53r93yleapyears.sql
metadata_modification_time: 2020-09-23 09:05:36
dependencies_database:      []
dependencies_table:         []
create_table_query:         CREATE TABLE default.`53r93yleapyears` (`id` Int8, `febdays` Int8) ENGINE = MergeTree ORDER BY id
engine_full:                MergeTree ORDER BY id
as_select:                  SELECT name AS catalog_name
partition_key:
sorting_key:                id
primary_key:                id
sampling_key:
storage_policy:             default
total_rows:                 2
total_bytes:                155
lifetime_rows:              ᴺᵁᴸᴸ
lifetime_bytes:             ᴺᵁᴸᴸ
comment:
has_own_data:               0
loading_dependencies_database: []
loading_dependencies_table:    []
loading_dependent_database:    []
loading_dependent_table:       []
Última modificação em 10 de junho de 2026