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 motor da tabela (sem parâmetros).
  • is_temporary (UInt8) — Flag que indica se 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) — Hora da modificação mais recente dos metadados da tabela.
  • metadata_version (Int32) — Versão dos metadados para tabela ReplicatedMergeTree, 0 para tabela que nã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 motor 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) — 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 da chave única especificada na tabela (cláusula UNIQUE KEY).
  • storage_policy (String) — A política de armazenamento. Relevante para tabelas que usam os motores 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 Buffer table 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, comprimido). Se a tabela armazenar dados em 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 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) adequadas para aplicação em tempo real.
  • active_on_fly_alter_mutations (UInt64) — Número total de mutações ALTER ativas (MODIFY COLUMN) adequadas para aplicação em tempo real.
  • active_on_fly_metadata_mutations (UInt64) — Número total de mutações de metadados ativas (RENAMEs) adequadas para aplicação em tempo real.
  • columns_descriptions_cache_size (UInt64) — Tamanho do cache de descrição de colunas para tabelas *MergeTree
  • lifetime_rows (Nullable(UInt64)) — Número total de linhas INSERTed desde a inicialização do servidor (somente para tabelas Buffer).
  • lifetime_bytes (Nullable(UInt64)) — Número total de bytes INSERTed 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 origem.
  • 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 para carregamento.
  • loading_dependent_table (Array(String)) — Tabela dependente para 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 SQL security usado para a 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 29 de junho de 2026