Pular para o conteúdo principal
SHOW CREATE (TABLE|DATABASE|USER) oculta segredos, a menos que as seguintes configurações estejam ativadas:Além disso, o usuário deve ter o privilégio displaySecretsInShowAndSelect.

SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE

Essas instruções retornam uma única coluna do tipo String, contendo a consulta CREATE usada para criar o objeto especificado.

Sintaxe

Syntax
SHOW [CREATE] TABLE | TEMPORARY TABLE | DICTIONARY | VIEW | DATABASE [db.]table|view [INTO OUTFILE filename] [FORMAT format]
Se você usar esta instrução para obter a consulta CREATE das tabelas de sistema, receberá uma consulta falsa, que apenas declara a estrutura da tabela, mas não pode ser usada para criar uma tabela.

SHOW DATABASES

Esta instrução exibe uma lista de todos os bancos de dados.

Sintaxe

Syntax
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
É idêntica à consulta:
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]

Exemplos

Neste exemplo, usamos SHOW para obter os nomes dos bancos de dados que contêm a sequência de caracteres ‘de’ no nome:
Query
SHOW DATABASES LIKE '%de%'
Response
┌─name────┐
│ default │
└─────────┘
Também podemos fazer isso sem diferenciar maiúsculas de minúsculas:
Query
SHOW DATABASES ILIKE '%DE%'
Response
┌─name────┐
│ default │
└─────────┘
Ou obtenha os nomes dos bancos de dados que não contêm ‘de’ no nome:
Query
SHOW DATABASES NOT LIKE '%de%'
Response
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system                         │
│ test                           │
│ tutorial                       │
└────────────────────────────────┘
Por fim, podemos obter os nomes apenas dos dois primeiros bancos de dados:
Query
SHOW DATABASES LIMIT 2
Response
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default                        │
└────────────────────────────────┘

Veja também

SHOW TABLES

A instrução SHOW TABLES exibe uma lista de tabelas.

Sintaxe

Syntax
SHOW [FULL] [TEMPORARY] TABLES [{FROM | IN} <db>] [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
Se a cláusula FROM não for especificada, a consulta retorna uma lista de tabelas do banco de dados atual. Esta instrução é idêntica à consulta:
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Exemplos

Neste exemplo, usamos a instrução SHOW TABLES para localizar todas as tabelas que contêm ‘user’ no nome:
Query
SHOW TABLES FROM system LIKE '%user%'
Response
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
Também é possível fazer isso sem diferenciar maiúsculas de minúsculas:
Query
SHOW TABLES FROM system ILIKE '%USER%'
Response
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
Ou, para encontrar tabelas cujos nomes não contenham a letra ‘s’:
Query
SHOW TABLES FROM system NOT LIKE '%s%'
Response
┌─name─────────┐
│ metric_log   │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘
Por fim, podemos obter os nomes apenas das duas primeiras tabelas:
Query
SHOW TABLES FROM system LIMIT 2
Response
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log        │
└────────────────────────────────┘

Veja também

SHOW COLUMNS

A instrução SHOW COLUMNS mostra uma lista de colunas.

Sintaxe

Syntax
SHOW [EXTENDED] [FULL] COLUMNS {FROM | IN} <table> [{FROM | IN} <db>] [{[NOT] {LIKE | ILIKE} '<pattern>' | WHERE <expr>}] [LIMIT <N>] [INTO
OUTFILE <filename>] [FORMAT <format>]
O nome do banco de dados e o nome da tabela podem ser especificados de forma abreviada como <db>.<table>, o que significa que FROM tab FROM db e FROM db.tab são equivalentes. Se nenhum banco de dados for especificado, a consulta retorna a lista de colunas do banco de dados atual. Há também duas palavras-chave opcionais: EXTENDED e FULL. No momento, a palavra-chave EXTENDED não tem efeito e existe para compatibilidade com MySQL. A palavra-chave FULL faz com que a saída inclua as colunas collation, comment e privilege. A instrução SHOW COLUMNS produz uma tabela de resultados com a seguinte estrutura:
ColunaDescriçãoTipo
fieldO nome da colunaString
typeO tipo de dado da coluna. Se a consulta for feita por meio do MySQL wire protocol, será exibido o nome de tipo equivalente no MySQL.String
nullYES se o tipo de dado da coluna for Nullable, NO caso contrárioString
keyPRI se a coluna fizer parte da chave primária, SOR se a coluna fizer parte da chave de ordenação, vazio caso contrárioString
defaultExpressão padrão da coluna, se ela for do tipo ALIAS, DEFAULT ou MATERIALIZED; caso contrário, NULL.Nullable(String)
extraInformações adicionais, atualmente sem usoString
collation(somente se a palavra-chave FULL for especificada) Collation da coluna, sempre NULL, porque o ClickHouse não tem collations por colunaNullable(String)
comment(somente se a palavra-chave FULL for especificada) Comentário da colunaString
privilege(somente se a palavra-chave FULL for especificada) O privilégio que você tem nessa coluna, atualmente não disponívelString

Exemplos

Neste exemplo, vamos usar a instrução SHOW COLUMNS para obter informações sobre todas as colunas da tabela ‘orders’, começando com ‘delivery_’:
Query
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
Response
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
│ delivery_date   │ DateTime │    0 │ PRI SOR │ ᴺᵁᴸᴸ    │       │
│ delivery_status │ Bool     │    0 │         │ ᴺᵁᴸᴸ    │       │
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘

Veja também

SHOW DICTIONARIES

A instrução SHOW DICTIONARIES exibe a lista de Dicionários.

Sintaxe

Syntax
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
Se a cláusula FROM não for especificada, a consulta retorna a lista de dicionários do banco de dados atual. Você pode obter os mesmos resultados da consulta SHOW DICTIONARIES da seguinte forma:
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Exemplos

A consulta a seguir seleciona as duas primeiras linhas da lista de tabelas do banco de dados system cujos nomes contêm reg.
Query
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
Response
┌─name─────────┐
│ regions      │
│ region_names │
└──────────────┘

SHOW INDEX

Exibe uma lista de índices primários e data skipping indexes de uma tabela. Esta instrução existe principalmente por compatibilidade com o MySQL. As tabelas de sistema system.tables (para chaves primárias) e system.data_skipping_indices (para data skipping indices) fornecem informações equivalentes, mas de forma mais nativa no ClickHouse.

Sintaxe

Syntax
SHOW [EXTENDED] {INDEX | INDEXES | INDICES | KEYS } {FROM | IN} <table> [{FROM | IN} <db>] [WHERE <expr>] [INTO OUTFILE <filename>] [FORMAT <format>]
O nome do banco de dados e da tabela pode ser especificado na forma abreviada <db>.<table>, ou seja, FROM tab FROM db e FROM db.tab são equivalentes. Se nenhum banco de dados for especificado, a consulta assume o banco de dados atual. A palavra-chave opcional EXTENDED atualmente não tem efeito e existe para compatibilidade com o MySQL. A instrução produz uma tabela de resultados com a seguinte estrutura:
ColunaDescriçãoTipo
tableO nome da tabela.String
non_uniqueSempre 1, pois o ClickHouse não oferece suporte a restrições de unicidade.UInt8
key_nameO nome do índice; PRIMARY se o índice for um índice de chave primária.String
seq_in_indexPara um índice de chave primária, a posição da coluna a partir de 1. Para um índice de data skipping: sempre 1.UInt8
column_namePara um índice de chave primária, o nome da coluna. Para um índice de data skipping: '' (string vazia); veja o campo “expression”.String
collationA ordenação da coluna no índice: A se ascendente, D se descendente, NULL se não ordenada.Nullable(String)
cardinalityUma estimativa da cardinalidade do índice (número de valores únicos no índice). Atualmente, é sempre 0.UInt64
sub_partSempre NULL, porque o ClickHouse não oferece suporte a prefixos de índice como o MySQL.Nullable(String)
packedSempre NULL, porque o ClickHouse não oferece suporte a índices packed (como o MySQL).Nullable(String)
nullAtualmente sem uso
index_typeO tipo de índice, por exemplo, PRIMARY, MINMAX, BLOOM_FILTER etc.String
commentInformações adicionais sobre o índice; atualmente, sempre '' (string vazia).String
index_comment'' (string vazia), porque índices no ClickHouse não podem ter um campo COMMENT (como no MySQL).String
visibleSe o índice está visível para o otimizador, sempre YES.String
expressionPara um índice de data skipping, a expressão do índice. Para um índice de chave primária: '' (string vazia).String

Exemplos

Neste exemplo, usamos a instrução SHOW INDEX para obter informações sobre todos os índices da tabela ‘tbl’
Query
SHOW INDEX FROM 'tbl'
Response
┌─table─┬─non_unique─┬─key_name─┬─seq_in_index─┬─column_name─┬─collation─┬─cardinality─┬─sub_part─┬─packed─┬─null─┬─index_type───┬─comment─┬─index_comment─┬─visible─┬─expression─┐
│ tbl   │          1 │ blf_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ BLOOM_FILTER │         │               │ YES     │ d, b       │
│ tbl   │          1 │ mm1_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ MINMAX       │         │               │ YES     │ a, c, d    │
│ tbl   │          1 │ mm2_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ MINMAX       │         │               │ YES     │ c, d, e    │
│ tbl   │          1 │ PRIMARY  │ 1            │ c           │ A         │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ PRIMARY      │         │               │ YES     │            │
│ tbl   │          1 │ PRIMARY  │ 2            │ a           │ A         │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ PRIMARY      │         │               │ YES     │            │
│ tbl   │          1 │ set_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ SET          │         │               │ YES     │ e          │
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘

Veja também

SHOW PROCESSLIST

Exibe o conteúdo da tabela system.processes, que contém uma lista das consultas em processamento no momento, excluindo as consultas SHOW PROCESSLIST.

Sintaxe

Syntax
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
A consulta SELECT * FROM system.processes retorna dados sobre todas as consultas em execução no momento.
Execute no terminal:
$ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"

SHOW GRANTS

A instrução SHOW GRANTS exibe os privilégios de um usuário.

Sintaxe

Syntax
SHOW GRANTS [FOR user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]
Se o usuário não for especificado, a consulta retornará os privilégios do usuário atual. O modificador WITH IMPLICIT permite exibir os privilégios implícitos (por exemplo, GRANT SELECT ON system.one) O modificador FINAL combina todos os privilégios do usuário e das funções concedidas a ele (com herança)

SHOW CREATE USER

A instrução SHOW CREATE USER exibe os parâmetros usados na criação do usuário.

Sintaxe

Syntax
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]

SHOW CREATE ROLE

A instrução SHOW CREATE ROLE mostra os parâmetros usados na criação da role.

Sintaxe

Syntax
SHOW CREATE ROLE name1 [, name2 ...]

SHOW CREATE ROW POLICY

A instrução SHOW CREATE ROW POLICY exibe os parâmetros usados na criação de ROW POLICY.

Sintaxe

Syntax
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]

SHOW CREATE QUOTA

A instrução SHOW CREATE QUOTA mostra os parâmetros usados na criação da quota.

Sintaxe

Syntax
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]

SHOW CREATE SETTINGS PROFILE

A instrução SHOW CREATE SETTINGS PROFILE exibe os parâmetros usados na criação do perfil de configurações.

Sintaxe

Syntax
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]

SHOW USERS

A instrução SHOW USERS retorna uma lista com os nomes das contas de usuário. Para ver os parâmetros das contas de usuário, consulte a tabela de sistema system.users.

Sintaxe

Syntax
SHOW USERS

SHOW ROLES

A instrução SHOW ROLES retorna uma lista de funções. Para ver outros parâmetros, consulte as tabelas do sistema system.roles e system.role_grants.

Sintaxe

Syntax
SHOW [CURRENT|ENABLED] ROLES

SHOW PROFILES

A instrução SHOW PROFILES retorna uma lista de perfis de configuração. Para ver os parâmetros das contas de usuário, consulte a tabela do sistema settings_profiles.

Sintaxe

Syntax
SHOW [SETTINGS] PROFILES

SHOW POLICIES

A instrução SHOW POLICIES retorna uma lista de políticas de linha da tabela especificada. Para ver os parâmetros das contas de usuário, consulte a tabela de sistema system.row_policies.

Sintaxe

Syntax
SHOW [ROW] POLICIES [ON [db.]table]

SHOW QUOTAS

A instrução SHOW QUOTAS retorna uma lista de quotas. Para ver os parâmetros das quotas, consulte a tabela de sistema system.quotas.

Sintaxe

Syntax
SHOW QUOTAS

SHOW QUOTA

A instrução SHOW QUOTA retorna o consumo da quota de todos os usuários ou do usuário atual. Para ver outros parâmetros, consulte as tabelas do sistema system.quotas_usage e system.quota_usage.

Sintaxe

Syntax
SHOW [CURRENT] QUOTA

SHOW ACCESS

A instrução SHOW ACCESS mostra todos os usuários, funções, perfis etc. e todos os privilégios concedidos a eles.

Sintaxe

Syntax
SHOW ACCESS

SHOW CLUSTER(S)

A instrução SHOW CLUSTER(S) retorna uma lista de clusters. Todos os clusters disponíveis estão listados na tabela system.clusters.
A consulta SHOW CLUSTER name exibe cluster, shard_num, replica_num, host_name, host_address e port da tabela system.clusters para o nome de cluster especificado.

Sintaxe

Syntax
SHOW CLUSTER '<name>'
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]

Exemplos

Query
SHOW CLUSTERS;
Response
┌─cluster──────────────────────────────────────┐
│ test_cluster_two_shards                      │
│ test_cluster_two_shards_internal_replication │
│ test_cluster_two_shards_localhost            │
│ test_shard_localhost                         │
│ test_shard_localhost_secure                  │
│ test_unavailable_shard                       │
└──────────────────────────────────────────────┘
Query
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
Response
┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘
Query
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
Response
Row 1:
──────
cluster:                 test_shard_localhost
shard_num:               1
replica_num:             1
host_name:               localhost
host_address:            127.0.0.1
port:                    9000

SHOW SETTINGS

A instrução SHOW SETTINGS retorna uma lista das configurações do sistema e seus valores. Ela seleciona dados da tabela system.settings.

Sintaxe

Syntax
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>

Cláusulas

LIKE|ILIKE permitem especificar um padrão de correspondência para o nome da configuração. Ele pode conter curingas como % ou _. A cláusula LIKE diferencia maiúsculas de minúsculas; ILIKE, não. Quando a cláusula CHANGED é usada, a consulta retorna apenas as configurações alteradas em relação aos valores padrão.

Exemplos

Consulta com a cláusula LIKE:
Query
SHOW SETTINGS LIKE 'send_timeout';
Response
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300   │
└──────────────┴─────────┴───────┘
Consulta com a cláusula ILIKE:
Query
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
Response
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout                         │ Seconds      │ 10    │
│ connect_timeout_with_failover_ms        │ Milliseconds │ 50    │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100   │
└─────────────────────────────────────────┴──────────────┴───────┘
Consulta com a cláusula CHANGED:
Query
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
Response
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘

SHOW SETTING

A instrução SHOW SETTING exibe o valor da configuração correspondente ao nome de configuração especificado.

Sintaxe

Syntax
SHOW SETTING <name>

Veja também

SHOW FILESYSTEM CACHES

Exemplos

Query
SHOW FILESYSTEM CACHES
Response
┌─Caches────┐
│ s3_cache  │
└───────────┘

Veja também

SHOW ENGINES

A instrução SHOW ENGINES exibe o conteúdo da tabela system.table_engines, que contém a descrição dos motores de tabela compatíveis com o servidor e informações sobre os recursos compatíveis.

Sintaxe

Syntax
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]

Veja também

SHOW FUNCTIONS

A instrução SHOW FUNCTIONS exibe o conteúdo da tabela system.functions.

Sintaxe

Syntax
SHOW FUNCTIONS [LIKE | ILIKE '<pattern>']
Se qualquer uma das cláusulas LIKE ou ILIKE for especificada, a consulta retorna uma lista de funções do sistema cujos nomes correspondem ao <pattern> informado.

Veja também

SHOW MERGES

A instrução SHOW MERGES retorna uma lista de merges. Todos os merges são listados na tabela system.merges:
ColunaDescrição
tableNome da tabela.
databaseNome do banco de dados em que a tabela está.
estimate_completeTempo estimado para conclusão (em segundos).
elapsedTempo decorrido (em segundos) desde o início do merge.
progressPercentual de trabalho concluído (0 a 100 por cento).
is_mutation1 se este processo for uma mutação de parte.
size_compressedTamanho total dos dados compactados das partes mescladas.
memory_usageConsumo de memória do processo de merge.

Sintaxe

Syntax
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]

Exemplos

Query
SHOW MERGES;
Response
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default  │              0.14 │    0.36 │    73.01 │           0 │        5.40 MiB │    10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
Query
SHOW MERGES LIKE 'your_t%' LIMIT 1;
Response
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default  │              0.14 │    0.36 │    73.01 │           0 │        5.40 MiB │    10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘

SHOW CREATE MASKING POLICY

A instrução SHOW CREATE MASKING POLICY mostra os parâmetros usados na criação da política de mascaramento.

Sintaxe

Syntax
SHOW CREATE MASKING POLICY name ON [database.]table
Última modificação em 10 de junho de 2026