> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tabela de sistema que contém metadados de cada tabela conhecida pelo servidor.

# system.tables

<div id="description">
  ## Descrição
</div>

Contém os metadados de cada tabela conhecida pelo servidor.

As tabelas [Detached](/pt-BR/reference/statements/detach) não são exibidas em `system.tables`.

As [tabelas temporárias](/pt-BR/reference/statements/create/table#temporary-tables) 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.

<div id="columns">
  ## Colunas
</div>

* `database` ([String](/pt-BR/reference/data-types)) — O nome do banco de dados ao qual a tabela pertence.
* `name` ([String](/pt-BR/reference/data-types)) — Nome da tabela.
* `uuid` ([UUID](/pt-BR/reference/data-types)) — UUID da tabela (banco de dados Atomic).
* `engine` ([String](/pt-BR/reference/data-types)) — Nome do mecanismo da tabela (sem parâmetros).
* `is_temporary` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a tabela é temporária.
* `data_paths` ([Array(String)](/pt-BR/reference/data-types)) — Caminhos para os dados da tabela nos sistemas de arquivos.
* `metadata_path` ([String](/pt-BR/reference/data-types)) — Caminho dos metadados da tabela no sistema de arquivos.
* `metadata_modification_time` ([DateTime](/pt-BR/reference/data-types)) — Hora da última modificação dos metadados da tabela.
* `metadata_version` ([Int32](/pt-BR/reference/data-types)) — Versão dos metadados da tabela ReplicatedMergeTree; 0 para tabelas que não são ReplicatedMergeTree.
* `dependencies_database` ([Array(String)](/pt-BR/reference/data-types)) — Dependências do banco de dados.
* `dependencies_table` ([Array(String)](/pt-BR/reference/data-types)) — Dependências da tabela (visões materializadas da tabela atual).
* `create_table_query` ([String](/pt-BR/reference/data-types)) — A consulta usada para criar a tabela.
* `engine_full` ([String](/pt-BR/reference/data-types)) — Parâmetros do mecanismo da tabela.
* `as_select` ([String](/pt-BR/reference/data-types)) — consulta SELECT da view.
* `parameterized_view_parameters` ([Array(Tuple(name String, type String))](/pt-BR/reference/data-types)) — Parâmetros da view parametrizada.
* `partition_key` ([String](/pt-BR/reference/data-types)) — A expressão da chave de partição especificada na tabela.
* `sorting_key` ([String](/pt-BR/reference/data-types)) — A expressão da chave de ordenação especificada na tabela.
* `primary_key` ([String](/pt-BR/reference/data-types)) — A expressão da chave primária especificada na tabela.
* `sampling_key` ([String](/pt-BR/reference/data-types)) — A expressão da chave de amostragem especificada na tabela.
* `unique_key` ([String](/pt-BR/reference/data-types)) — A expressão de chave única definida na tabela (cláusula UNIQUE KEY).
* `storage_policy` ([String](/pt-BR/reference/data-types)) — Política de armazenamento. Relevante para tabelas que usam os motores MergeTree e Distributed.
* `total_rows` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — 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)](/pt-BR/reference/data-types)) — 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)](/pt-BR/reference/data-types)) — 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)](/pt-BR/reference/data-types)) — O número total de partes nesta tabela.
* `active_parts` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — O número de partes ativas nesta tabela.
* `total_marks` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — O número total de marcas em todas as partes desta tabela.
* `active_on_fly_data_mutations` ([UInt64](/pt-BR/reference/data-types)) — 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](/pt-BR/reference/data-types)) — Número total de mutações ALTER ativas (MODIFY COLUMN) que podem ser aplicadas imediatamente.
* `active_on_fly_metadata_mutations` ([UInt64](/pt-BR/reference/data-types)) — Número total de mutações de metadados ativas (RENAMEs) que podem ser aplicadas dinamicamente.
* `columns_descriptions_cache_size` ([UInt64](/pt-BR/reference/data-types)) — Tamanho do cache de descrições de colunas para tabelas \*MergeTree
* `lifetime_rows` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Número total de linhas inseridas desde o início do servidor (somente para tabelas Buffer).
* `lifetime_bytes` ([Nullable(UInt64)](/pt-BR/reference/data-types)) — Número total de bytes inseridos desde o início do servidor (apenas para tabelas Buffer).
* `comment` ([String](/pt-BR/reference/data-types)) — O comentário da tabela.
* `has_own_data` ([UInt8](/pt-BR/reference/data-types)) — Indicador que informa se a própria tabela armazena dados em disco ou apenas acessa outra fonte.
* `loading_dependencies_database` ([Array(String)](/pt-BR/reference/data-types)) — Dependências para carregamento do banco de dados (lista de objetos que devem ser carregados antes do objeto atual).
* `loading_dependencies_table` ([Array(String)](/pt-BR/reference/data-types)) — Dependências de carregamento da tabela (lista de objetos que precisam ser carregados antes do objeto atual).
* `loading_dependent_database` ([Array(String)](/pt-BR/reference/data-types)) — Banco de dados dependente em carregamento.
* `loading_dependent_table` ([Array(String)](/pt-BR/reference/data-types)) — Tabela dependente para carregamento.
* `definer` ([String](/pt-BR/reference/data-types)) — nome do definidor de SQL security usado na tabela.

<div id="example">
  ## Exemplo
</div>

```sql theme={null}
SELECT * FROM system.tables LIMIT 2 FORMAT Vertical;
```

```text theme={null}
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:       []
```
