Pular para o conteúdo principal
INFORMATION_SCHEMA (ou information_schema) é um banco de dados de sistema que fornece uma visão independente de SGBD (em certa medida) padronizada dos metadados de objetos de banco de dados. As views em INFORMATION_SCHEMA geralmente são inferiores às tabelas de sistema normais, mas ferramentas podem usá-las para obter informações básicas de forma compatível entre diferentes SGBDs. Espera-se que a estrutura e o conteúdo das views em INFORMATION_SCHEMA evoluam de maneira retrocompatível, ou seja, apenas novas funcionalidades sejam adicionadas, sem que as funcionalidades existentes sejam alteradas ou removidas. Em termos de implementação interna, as views em INFORMATION_SCHEMA normalmente mapeiam para tabelas de sistema normais, como system.columns, system.databases e system.tables.
INFORMATION_SCHEMA contém as seguintes views: Views equivalentes sem distinção entre maiúsculas e minúsculas, por exemplo INFORMATION_SCHEMA.columns, são fornecidas por motivos de compatibilidade com outros bancos de dados. O mesmo se aplica a todas as colunas dessas views: são fornecidas variantes tanto em minúsculas (por exemplo, table_name) quanto em maiúsculas (TABLE_NAME).

COLUMNS

Contém colunas lidas da tabela de sistema system.columns, além de colunas que não são compatíveis com o ClickHouse ou não fazem sentido (sempre NULL), mas são exigidas pelo padrão. Colunas:
  • table_catalog (String) — Atualmente não é usado.
  • table_schema (String) — Atualmente não é usado.
  • table_name (String) — Atualmente não é usado.
  • non_unique (Int32) — Atualmente não é usado.
  • index_schema (String) — Atualmente não é usado.
  • index_name (Nullable(String)) — Atualmente não é usado.
  • seq_in_index (UInt32) — Atualmente não é usado.
  • column_name (Nullable(String)) — Atualmente não é usado.
  • collation (Nullable(String)) — Atualmente não é usado.
  • cardinality (Nullable(Int64)) — Atualmente não é usado.
  • sub_part (Nullable(Int64)) — Atualmente não é usado.
  • packed (Nullable(String)) — Atualmente não é usado.
  • nullable (String) — Atualmente não é usado.
  • index_type (String) — Atualmente não é usado.
  • comment (String) — Atualmente não é usado.
  • index_comment (String) — Atualmente não é usado.
  • is_visible (String) — Atualmente não é usado.
  • expression (Nullable(String)) — Atualmente não é usado.
Exemplo
Query
Response

SCHEMATA

Contém colunas lidas da tabela de sistema system.databases e colunas que não são suportadas no ClickHouse ou não fazem sentido (sempre NULL), mas são exigidas pelo padrão. Colunas:
  • catalog_name (String) — O nome do banco de dados.
  • schema_name (String) — O nome do banco de dados.
  • schema_owner (String) — Nome do proprietário do schema, sempre 'default'.
  • default_character_set_catalog (Nullable(String)) — NULL, não suportado.
  • default_character_set_schema (Nullable(String)) — NULL, não suportado.
  • default_character_set_name (Nullable(String)) — NULL, não suportado.
  • sql_path (Nullable(String)) — NULL, não suportado.
Exemplo
Query
Response

TABLES

Contém as colunas lidas da tabela de sistema system.tables. Colunas:
  • table_catalog (String) — O nome do banco de dados em que a tabela está localizada.
  • table_schema (String) — O nome do banco de dados em que a tabela está localizada.
  • table_name (String) — Nome da tabela.
  • table_type (String) — Tipo da tabela. Valores possíveis:
    • BASE TABLE
    • VIEW
    • FOREIGN TABLE
    • LOCAL TEMPORARY
    • SYSTEM VIEW
  • table_rows (Nullable(UInt64)) — O número total de linhas. NULL se não puder ser determinado.
  • data_length (Nullable(UInt64)) — O tamanho dos dados em disco. NULL se não puder ser determinado.
  • index_length (Nullable(UInt64)) — O tamanho total da chave primária, dos índices secundários e de todas as marcas.
  • table_collation (Nullable(String)) — A collation padrão da tabela. Sempre utf8mb4_0900_ai_ci.
  • table_comment (Nullable(String)) — O comentário usado ao criar a tabela.
Exemplo
Query
Response

VIEWS

Contém colunas lidas da tabela de sistema system.tables, quando o motor de tabela View é usado. Colunas:
  • table_catalog (String) — O nome do banco de dados em que a tabela está localizada.
  • table_schema (String) — O nome do banco de dados em que a tabela está localizada.
  • table_name (String) — Nome da tabela.
  • view_definition (String) — consulta SELECT da view.
  • check_option (String) — NONE, sem verificação.
  • is_updatable (Enum8) — NO, a view não é atualizável.
  • is_insertable_into (Enum8) — Mostra se a view criada é materializada. Valores possíveis:
    • NO — A view criada não é materializada.
    • YES — A view criada é materializada.
  • is_trigger_updatable (Enum8) — NO, o gatilho não é atualizável.
  • is_trigger_deletable (Enum8) — NO, o gatilho não pode ser excluído.
  • is_trigger_insertable_into (Enum8) — NO, nenhum dado é inserido no gatilho.
Exemplo
Query
Response

KEY_COLUMN_USAGE

Contém colunas da tabela de sistema system.tables às quais se aplicam restrições. Colunas:
  • constraint_catalog (String) — Atualmente sem uso. Sempre def.
  • constraint_schema (String) — O nome do schema (banco de dados) ao qual a restrição pertence.
  • constraint_name (Nullable(String)) — O nome da restrição.
  • table_catalog (String) — Atualmente sem uso. Sempre def.
  • table_schema (String) — O nome do schema (banco de dados) ao qual a tabela pertence.
  • table_name (String) — O nome da tabela à qual a restrição se aplica.
  • column_name (Nullable(String)) — O nome da coluna à qual a restrição se aplica.
  • ordinal_position (UInt32) — Atualmente sem uso. Sempre 1.
  • position_in_unique_constraint (Nullable(UInt32)) — Atualmente sem uso. Sempre NULL.
  • referenced_table_schema (Nullable(String)) — Atualmente sem uso. Sempre NULL.
  • referenced_table_name (Nullable(String)) — Atualmente sem uso. Sempre NULL.
  • referenced_column_name (Nullable(String)) — Atualmente sem uso. Sempre NULL.
Exemplo
Query
Response

REFERENTIAL_CONSTRAINTS

Contém informações sobre chaves estrangeiras. No momento, retorna um resultado vazio (nenhuma linha), o que basta para fornecer compatibilidade com ferramentas de terceiros, como o Tableau Online. Colunas:
  • constraint_catalog (String) — No momento, não é utilizado.
  • constraint_schema (String) — No momento, não é utilizado.
  • constraint_name (Nullable(String)) — No momento, não é utilizado.
  • unique_constraint_catalog (String) — No momento, não é utilizado.
  • unique_constraint_schema (String) — No momento, não é utilizado.
  • unique_constraint_name (Nullable(String)) — No momento, não é utilizado.
  • match_option (String) — No momento, não é utilizado.
  • update_rule (String) — No momento, não é utilizado.
  • delete_rule (String) — No momento, não é utilizado.
  • table_name (String) — No momento, não é utilizado.
  • referenced_table_name (String) — No momento, não é utilizado.

STATISTICS

Fornece informações sobre os índices da tabela. Atualmente, retorna um resultado vazio (nenhuma linha), o suficiente apenas para garantir compatibilidade com ferramentas de terceiros, como o Tableau Online.
Última modificação em 1 de julho de 2026