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

> Documentação do SHOW

# Instruções SHOW

<Note>
  `SHOW CREATE (TABLE|DATABASE|USER)` oculta segredos, a menos que as seguintes configurações estejam ativadas:

  * [`display_secrets_in_show_and_select`](/pt-BR/reference/settings/server-settings/settings#display_secrets_in_show_and_select) (configuração do servidor)
  * [`format_display_secrets_in_show_and_select` ](/pt-BR/reference/settings/formats#format_display_secrets_in_show_and_select) (configuração de formato)

  Além disso, o usuário deve ter o privilégio [`displaySecretsInShowAndSelect`](/pt-BR/reference/statements/grant#displaysecretsinshowandselect).
</Note>

<div id="show-create-table--dictionary--view--database">
  ## SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CREATE] TABLE | TEMPORARY TABLE | DICTIONARY | VIEW | DATABASE [db.]table|view [INTO OUTFILE filename] [FORMAT format]
```

<Note>
  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.
</Note>

<div id="show-databases">
  ## SHOW DATABASES
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

É idêntica à consulta:

```sql theme={null}
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

<div id="examples">
  ### Exemplos
</div>

Neste exemplo, usamos `SHOW` para obter os nomes dos bancos de dados que contêm a sequência de caracteres 'de' no nome:

```sql title="Query" theme={null}
SHOW DATABASES LIKE '%de%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

Também podemos fazer isso sem diferenciar maiúsculas de minúsculas:

```sql title="Query" theme={null}
SHOW DATABASES ILIKE '%DE%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

Ou obtenha os nomes dos bancos de dados que não contêm 'de' no nome:

```sql title="Query" theme={null}
SHOW DATABASES NOT LIKE '%de%'
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system                         │
│ test                           │
│ tutorial                       │
└────────────────────────────────┘
```

Por fim, podemos obter os nomes apenas dos dois primeiros bancos de dados:

```sql title="Query" theme={null}
SHOW DATABASES LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default                        │
└────────────────────────────────┘
```

<div id="see-also">
  ### Veja também
</div>

* [`CREATE DATABASE`](/pt-BR/reference/statements/create/database)

<div id="show-tables">
  ## SHOW TABLES
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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:

```sql theme={null}
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### Exemplos
</div>

Neste exemplo, usamos a instrução `SHOW TABLES` para localizar todas as tabelas que contêm 'user' no nome:

```sql title="Query" theme={null}
SHOW TABLES FROM system LIKE '%user%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

Também é possível fazer isso sem diferenciar maiúsculas de minúsculas:

```sql title="Query" theme={null}
SHOW TABLES FROM system ILIKE '%USER%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

Ou, para encontrar tabelas cujos nomes não contenham a letra 's':

```sql title="Query" theme={null}
SHOW TABLES FROM system NOT LIKE '%s%'
```

```text title="Response" theme={null}
┌─name─────────┐
│ metric_log   │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘
```

Por fim, podemos obter os nomes apenas das duas primeiras tabelas:

```sql title="Query" theme={null}
SHOW TABLES FROM system LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log        │
└────────────────────────────────┘
```

<div id="see-also">
  ### Veja também
</div>

* [`Criar tabelas`](/pt-BR/reference/statements/create/table)
* [`SHOW CREATE TABLE`](#show-create-table--dictionary--view--database)

<div id="show_columns">
  ## SHOW COLUMNS
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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:

| Coluna      | Descrição                                                                                                                                  | Tipo               |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
| `field`     | O nome da coluna                                                                                                                           | `String`           |
| `type`      | O 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`           |
| `null`      | `YES` se o tipo de dado da coluna for Nullable, `NO` caso contrário                                                                        | `String`           |
| `key`       | `PRI` se a coluna fizer parte da chave primária, `SOR` se a coluna fizer parte da chave de ordenação, vazio caso contrário                 | `String`           |
| `default`   | Expressão padrão da coluna, se ela for do tipo `ALIAS`, `DEFAULT` ou `MATERIALIZED`; caso contrário, `NULL`.                               | `Nullable(String)` |
| `extra`     | Informações adicionais, atualmente sem uso                                                                                                 | `String`           |
| `collation` | (somente se a palavra-chave `FULL` for especificada) Collation da coluna, sempre `NULL`, porque o ClickHouse não tem collations por coluna | `Nullable(String)` |
| `comment`   | (somente se a palavra-chave `FULL` for especificada) Comentário da coluna                                                                  | `String`           |
| `privilege` | (somente se a palavra-chave `FULL` for especificada) O privilégio que você tem nessa coluna, atualmente não disponível                     | `String`           |

<div id="examples">
  ### Exemplos
</div>

Neste exemplo, vamos usar a instrução `SHOW COLUMNS` para obter informações sobre todas as colunas da tabela 'orders',
começando com 'delivery\_':

```sql title="Query" theme={null}
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
```

```text title="Response" theme={null}
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
│ delivery_date   │ DateTime │    0 │ PRI SOR │ ᴺᵁᴸᴸ    │       │
│ delivery_status │ Bool     │    0 │         │ ᴺᵁᴸᴸ    │       │
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘
```

<div id="see-also">
  ### Veja também
</div>

* [`system.columns`](/pt-BR/reference/system-tables/columns)

<div id="show-dictionaries">
  ## SHOW DICTIONARIES
</div>

A instrução `SHOW DICTIONARIES` exibe a lista de [Dicionários](/pt-BR/reference/statements/create/dictionary).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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:

```sql theme={null}
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### Exemplos
</div>

A consulta a seguir seleciona as duas primeiras linhas da lista de tabelas do banco de dados `system` cujos nomes contêm `reg`.

```sql title="Query" theme={null}
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
```

```text title="Response" theme={null}
┌─name─────────┐
│ regions      │
│ region_names │
└──────────────┘
```

<div id="show-index">
  ## SHOW INDEX
</div>

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`](/pt-BR/reference/system-tables/tables) (para
chaves primárias) e [`system.data_skipping_indices`](/pt-BR/reference/system-tables/data_skipping_indices) (para data skipping indices)
fornecem informações equivalentes, mas de forma mais nativa no ClickHouse.

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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:

| Coluna          | Descrição                                                                                                                            | Tipo               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
| `table`         | O nome da tabela.                                                                                                                    | `String`           |
| `non_unique`    | Sempre `1`, pois o ClickHouse não oferece suporte a restrições de unicidade.                                                         | `UInt8`            |
| `key_name`      | O nome do índice; `PRIMARY` se o índice for um índice de chave primária.                                                             | `String`           |
| `seq_in_index`  | Para 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_name`   | Para um índice de chave primária, o nome da coluna. Para um índice de data skipping: `''` (string vazia); veja o campo "expression". | `String`           |
| `collation`     | A ordenação da coluna no índice: `A` se ascendente, `D` se descendente, `NULL` se não ordenada.                                      | `Nullable(String)` |
| `cardinality`   | Uma estimativa da cardinalidade do índice (número de valores únicos no índice). Atualmente, é sempre 0.                              | `UInt64`           |
| `sub_part`      | Sempre `NULL`, porque o ClickHouse não oferece suporte a prefixos de índice como o MySQL.                                            | `Nullable(String)` |
| `packed`        | Sempre `NULL`, porque o ClickHouse não oferece suporte a índices `packed` (como o MySQL).                                            | `Nullable(String)` |
| `null`          | Atualmente sem uso                                                                                                                   |                    |
| `index_type`    | O tipo de índice, por exemplo, `PRIMARY`, `MINMAX`, `BLOOM_FILTER` etc.                                                              | `String`           |
| `comment`       | Informaçõ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`           |
| `visible`       | Se o índice está visível para o otimizador, sempre `YES`.                                                                            | `String`           |
| `expression`    | Para um índice de data skipping, a expressão do índice. Para um índice de chave primária: `''` (string vazia).                       | `String`           |

<div id="examples">
  ### Exemplos
</div>

Neste exemplo, usamos a instrução `SHOW INDEX` para obter informações sobre todos os índices da tabela 'tbl'

```sql title="Query" theme={null}
SHOW INDEX FROM 'tbl'
```

```text title="Response" theme={null}
┌─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          │
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘
```

<div id="see-also">
  ### Veja também
</div>

* [`system.tables`](/pt-BR/reference/system-tables/tables)
* [`system.data_skipping_indices`](/pt-BR/reference/system-tables/data_skipping_indices)

<div id="show-processlist">
  ## SHOW PROCESSLIST
</div>

Exibe o conteúdo da tabela [`system.processes`](/pt-BR/reference/system-tables/processes), que contém uma lista das consultas em processamento no momento, excluindo as consultas `SHOW PROCESSLIST`.

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
```

A consulta `SELECT * FROM system.processes` retorna dados sobre todas as consultas em execução no momento.

<Tip>
  Execute no terminal:

  ```bash theme={null}
  $ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
  ```
</Tip>

<div id="show-grants">
  ## SHOW GRANTS
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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)

<div id="show-create-user">
  ## SHOW CREATE USER
</div>

A instrução `SHOW CREATE USER` exibe os parâmetros usados na [criação do usuário](/pt-BR/reference/statements/create/user).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]
```

<div id="show-create-role">
  ## SHOW CREATE ROLE
</div>

A instrução `SHOW CREATE ROLE` mostra os parâmetros usados na [criação da role](/pt-BR/reference/statements/create/role).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE ROLE name1 [, name2 ...]
```

<div id="show-create-row-policy">
  ## SHOW CREATE ROW POLICY
</div>

A instrução `SHOW CREATE ROW POLICY` exibe os parâmetros usados na [criação de ROW POLICY](/pt-BR/reference/statements/create/row-policy).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]
```

<div id="show-create-quota">
  ## SHOW CREATE QUOTA
</div>

A instrução `SHOW CREATE QUOTA` mostra os parâmetros usados na [criação da quota](/pt-BR/reference/statements/create/quota).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]
```

<div id="show-create-settings-profile">
  ## SHOW CREATE SETTINGS PROFILE
</div>

A instrução `SHOW CREATE SETTINGS PROFILE` exibe os parâmetros usados na [criação do perfil de configurações](/pt-BR/reference/statements/create/settings-profile).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]
```

<div id="show-users">
  ## SHOW USERS
</div>

A instrução `SHOW USERS` retorna uma lista com os nomes das [contas de usuário](/pt-BR/concepts/features/security/access-rights#user-account-management).
Para ver os parâmetros das contas de usuário, consulte a tabela de sistema [`system.users`](/pt-BR/reference/system-tables/users).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW USERS
```

<div id="show-roles">
  ## SHOW ROLES
</div>

A instrução `SHOW ROLES` retorna uma lista de [funções](/pt-BR/concepts/features/security/access-rights#role-management).
Para ver outros parâmetros,
consulte as tabelas do sistema [`system.roles`](/pt-BR/reference/system-tables/roles) e [`system.role_grants`](/pt-BR/reference/system-tables/role_grants).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT|ENABLED] ROLES
```

<div id="show-profiles">
  ## SHOW PROFILES
</div>

A instrução `SHOW PROFILES` retorna uma lista de [perfis de configuração](/pt-BR/concepts/features/security/access-rights#settings-profiles-management).
Para ver os parâmetros das contas de usuário, consulte a tabela do sistema [`settings_profiles`](/pt-BR/reference/system-tables/settings_profiles).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [SETTINGS] PROFILES
```

<div id="show-policies">
  ## SHOW POLICIES
</div>

A instrução `SHOW POLICIES` retorna uma lista de [políticas de linha](/pt-BR/concepts/features/security/access-rights#row-policy-management) da tabela especificada.
Para ver os parâmetros das contas de usuário, consulte a tabela de sistema [`system.row_policies`](/pt-BR/reference/system-tables/row_policies).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [ROW] POLICIES [ON [db.]table]
```

<div id="show-quotas">
  ## SHOW QUOTAS
</div>

A instrução `SHOW QUOTAS` retorna uma lista de [quotas](/pt-BR/concepts/features/security/access-rights#quotas-management).
Para ver os parâmetros das quotas, consulte a tabela de sistema [`system.quotas`](/pt-BR/reference/system-tables/quotas).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW QUOTAS
```

<div id="show-quota">
  ## SHOW QUOTA
</div>

A instrução `SHOW QUOTA` retorna o consumo da [quota](/pt-BR/concepts/features/configuration/server-config/quotas) de todos os usuários ou do usuário atual.
Para ver outros parâmetros, consulte as tabelas do sistema [`system.quotas_usage`](/pt-BR/reference/system-tables/quotas_usage) e [`system.quota_usage`](/pt-BR/reference/system-tables/quota_usage).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT] QUOTA
```

<div id="show-access">
  ## SHOW ACCESS
</div>

A instrução `SHOW ACCESS` mostra todos os [usuários](/pt-BR/concepts/features/security/access-rights#user-account-management), [funções](/pt-BR/concepts/features/security/access-rights#role-management), [perfis](/pt-BR/concepts/features/security/access-rights#settings-profiles-management) etc. e todos os [privilégios](/pt-BR/reference/statements/grant#privileges) concedidos a eles.

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW ACCESS
```

<div id="show-clusters">
  ## SHOW CLUSTER(S)
</div>

A instrução `SHOW CLUSTER(S)` retorna uma lista de clusters.
Todos os clusters disponíveis estão listados na tabela [`system.clusters`](/pt-BR/reference/system-tables/clusters).

<Note>
  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.
</Note>

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CLUSTER '<name>'
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### Exemplos
</div>

```sql title="Query" theme={null}
SHOW CLUSTERS;
```

```text title="Response" theme={null}
┌─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                       │
└──────────────────────────────────────────────┘
```

```sql title="Query" theme={null}
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
```

```text title="Response" theme={null}
┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘
```

```sql title="Query" theme={null}
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
cluster:                 test_shard_localhost
shard_num:               1
replica_num:             1
host_name:               localhost
host_address:            127.0.0.1
port:                    9000
```

<div id="show-settings">
  ## SHOW SETTINGS
</div>

A instrução `SHOW SETTINGS` retorna uma lista das configurações do sistema e seus valores.
Ela seleciona dados da tabela [`system.settings`](/pt-BR/reference/system-tables/settings).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>
```

<div id="clauses">
  ### Cláusulas
</div>

`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.

<div id="examples">
  ### Exemplos
</div>

Consulta com a cláusula `LIKE`:

```sql title="Query" theme={null}
SHOW SETTINGS LIKE 'send_timeout';
```

```text title="Response" theme={null}
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300   │
└──────────────┴─────────┴───────┘
```

Consulta com a cláusula `ILIKE`:

```sql title="Query" theme={null}
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
```

```text title="Response" theme={null}
┌─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`:

```sql title="Query" theme={null}
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
```

```text title="Response" theme={null}
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
```

<div id="show-setting">
  ## SHOW SETTING
</div>

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

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW SETTING <name>
```

<div id="see-also">
  ### Veja também
</div>

* tabela [`system.settings`](/pt-BR/reference/system-tables/settings)

<div id="show-filesystem-caches">
  ## SHOW FILESYSTEM CACHES
</div>

<div id="examples">
  ### Exemplos
</div>

```sql title="Query" theme={null}
SHOW FILESYSTEM CACHES
```

```text title="Response" theme={null}
┌─Caches────┐
│ s3_cache  │
└───────────┘
```

<div id="see-also">
  ### Veja também
</div>

* tabela [`system.settings`](/pt-BR/reference/system-tables/settings)

<div id="show-engines">
  ## SHOW ENGINES
</div>

A instrução `SHOW ENGINES` exibe o conteúdo da tabela [`system.table_engines`](/pt-BR/reference/system-tables/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.

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]
```

<div id="see-also">
  ### Veja também
</div>

* tabela [system.table\_engines](/pt-BR/reference/system-tables/table_engines)

<div id="show-functions">
  ## SHOW FUNCTIONS
</div>

A instrução `SHOW FUNCTIONS` exibe o conteúdo da tabela [`system.functions`](/pt-BR/reference/system-tables/functions).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
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.

<div id="see-also">
  ### Veja também
</div>

* tabela [`system.functions`](/pt-BR/reference/system-tables/functions)

<div id="show-merges">
  ## SHOW MERGES
</div>

A instrução `SHOW MERGES` retorna uma lista de merges.
Todos os merges são listados na tabela [`system.merges`](/pt-BR/reference/system-tables/merges):

| Coluna              | Descrição                                                 |
| ------------------- | --------------------------------------------------------- |
| `table`             | Nome da tabela.                                           |
| `database`          | Nome do banco de dados em que a tabela está.              |
| `estimate_complete` | Tempo estimado para conclusão (em segundos).              |
| `elapsed`           | Tempo decorrido (em segundos) desde o início do merge.    |
| `progress`          | Percentual de trabalho concluído (0 a 100 por cento).     |
| `is_mutation`       | 1 se este processo for uma mutação de parte.              |
| `size_compressed`   | Tamanho total dos dados compactados das partes mescladas. |
| `memory_usage`      | Consumo de memória do processo de merge.                  |

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### Exemplos
</div>

```sql title="Query" theme={null}
SHOW MERGES;
```

```text title="Response" theme={null}
┌─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 │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
```

```sql title="Query" theme={null}
SHOW MERGES LIKE 'your_t%' LIMIT 1;
```

```text title="Response" theme={null}
┌─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 │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
```

<div id="show-create-masking-policy">
  ## SHOW CREATE MASKING POLICY
</div>

A instrução `SHOW CREATE MASKING POLICY` mostra os parâmetros usados na [criação da política de mascaramento](/pt-BR/reference/statements/create/masking-policy).

<div id="syntax">
  ### Sintaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE MASKING POLICY name ON [database.]table
```