Skip to main content

​
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) — 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 de que a tabela é temporária.
  • data_paths (Array(String)) — Caminhos para os dados da tabela nos sistemas de arquivos.
  • metadata_path (String) — Caminho para os metadados da tabela no sistema de arquivos.
  • metadata_modification_time (DateTime) — Horário da última modificação dos metadados da tabela.
  • metadata_version (Int32) — Versão dos metadados para a 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) — Consulta usada para criar a tabela.
  • engine_full (String) — Parâmetros do mecanismo da tabela.
  • as_select (String) — Consulta SELECT da visão.
  • parameterized_view_parameters (Array(Tuple(name String, type String))) — Parâmetros da visão parametrizada.
  • partition_key (String) — Expressão da chave de partição especificada na tabela.
  • sorting_key (String) — Expressão da chave de ordenação especificada na tabela.
  • primary_key (String) — Expressão da chave primária especificada na tabela.
  • sampling_key (String) — Expressão da chave de amostragem especificada na tabela.
  • unique_key (String) — Expressão da chave única especificada na tabela (cláusula UNIQUE KEY).
  • skipping_indices_types (Array(String)) — Array dos tipos distintos de índices de omissão de dados definidos na tabela (por exemplo, minmax, set, bloom_filter, ngrambf_v1, tokenbf_v1, text, vector_similarity). Vazio para tabelas sem índices de omissão.
  • storage_policy (String) — Política de armazenamento. Relevante para tabelas que usam os mecanismos MergeTree e Distributed.
  • total_rows (Nullable(UInt64)) — Número total de linhas, se for 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 o armazenamento subjacente). Se a tabela armazena dados em disco, retorna o espaço em disco usado (ou seja, dados comprimidos). Se a tabela armazena 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 comprimidos, 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 considera 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 dinamicamente.
  • active_on_fly_alter_mutations (UInt64) — Número total de mutações ALTER ativas (MODIFY COLUMN) que podem ser aplicadas dinamicamente.
  • 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 a inicialização do servidor (somente para tabelas Buffer).
  • lifetime_bytes (Nullable(UInt64)) — Número total de bytes inseridos desde a inicialização do servidor (somente para tabelas Buffer).
  • comment (String) — O comentário da tabela.
  • has_own_data (UInt8) — Flag que indica se a própria tabela armazena dados em disco ou apenas acessa outra fonte.
  • loading_dependencies_database (Array(String)) — Dependências de 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 devem ser carregados antes do objeto atual).
  • loading_dependent_database (Array(String)) — Banco de dados dependente de carregamento.
  • loading_dependent_table (Array(String)) — Tabela dependente de carregamento.
  • target_database (String) — Para uma visão materializada, o banco de dados da tabela de destino na qual a visão grava (o destino TO ou a tabela implícita .inner.*). Vazio para outros motores.
  • target_table (String) — Para uma visão materializada, o nome da tabela de destino na qual a visão grava (o destino TO ou a tabela implícita .inner.*). Vazio para outros motores.
  • definer (String) — Nome do definidor de segurança SQL usado para a tabela.
Aliases:
  • table — Alias de name.

​
Exemplo

Última modificação em 14 de agosto de 2026