Esquema de informação

Aplica-se a: Databricks SQL Databricks Runtime 10.4 LTS e versões superiores somente ao Unity Catalog

No SYSTEM catálogo, INFORMATION_SCHEMA é um esquema padrão SQL que fornece metadados sobre objetos em todos os catálogos dentro da metastore. Não contém metadados sobre hive_metastore objetos.

Separadamente, cada catálogo criado no Unity Catalog também inclui automaticamente um information_schema que descreve apenas metadados sobre objetos nesse catálogo.

Ambos os tipos de esquemas de informação filtram automaticamente os resultados para incluir apenas os objetos a que tem privilégios do Unity Catalog para acedecer. Este comportamento difere de outras tabelas do sistema Azure Databricks. Veja Como as tabelas do sistema de esquemas de informação lidam com permissões.

O objetivo do esquema de informação é fornecer uma API baseada em SQL, consciente de privilégios e auto-descritiva para aceder aos metadados do catálogo.

Como as tabelas do sistema de esquemas de informação lidam com permissões

system.information_schema difere de outras tabelas de sistema por implementar filtragem automática. Isto significa que só vês os objetos (catálogos, esquemas, tabelas, colunas, etc.) aos quais tens privilégios de acesso no Unity Catalog. Se os seus privilégios mudarem, o que vê no esquema de informação muda em conformidade. Por exemplo, quando consultas information_schema.tables, apenas as linhas das tabelas que tens permissão para ver são devolvidas.

Como em todas as outras tabelas do sistema, precisa de permissões explícitas USE e SELECT para aceder e consultar o esquema de informações.

Diagrama de relacionamento de entidade do esquema de informações

O diagrama de relacionamento de entidade (ER) a seguir fornece uma visão geral de um subconjunto de exibições de esquema de informações e como elas se relacionam entre si.

Visões de esquema de informação

Notas

• O esquema de informação implementa filtragem consciente de privilégios. Só vês automaticamente os objetos a que tens permissões de acesso no Catálogo Unity. Veja Como as tabelas do sistema de esquemas de informação lidam com permissões.
• Pode ser necessário usar REPAIR TABLE uma sincronização manual para que algumas alterações de metadados do catálogo sejam refletidas no esquema de informações. Para obter mais informações, consulte REPAIR TABLE.
• Todos os identificadores, exceto os nomes de colunas e etiquetas, são armazenados no esquema de informações em minúsculas . Para o desempenho da consulta, evite usar funções como LOWER() ou UPPER() na coluna identificadora. Em vez disso, compare identificadores diretamente usando valores minúsculos.
• Para evitar tempos limite de consulta, aplique filtros seletivos ao consultar o esquema de informações (por exemplo, WHERE table_catalog = 'main' AND table_schema = 'default'). Consulte a documentação acima para obter uma lista completa de colunas que podem ser usadas como filtros para cada tabela do esquema de informações.
  • Observe que o pushdown LIMIT não é suportado atualmente, portanto, embora possa truncar os resultados, não melhorará o desempenho.

Exemplos

> SELECT table_name, column_name
    FROM information_schema.columns
    WHERE data_type = 'DOUBLE'
      AND table_schema = 'information_schema';

A seguir estão exemplos de fluxos de trabalho que usam as tabelas de esquema de informações no nível do sistema.

Se pretender ver todas as tabelas que foram criadas nas últimas 24 horas, a sua consulta poderá ter o seguinte aspeto.

> SELECT table_name, table_owner, created_by, last_altered, last_altered_by, table_catalog
    FROM system.information_schema.tables
    WHERE  datediff(now(), last_altered) < 1;

Se você quiser exibir quantas tabelas você tem em cada esquema, considere o exemplo a seguir.

> SELECT table_schema, count(table_name)
    FROM system.information_schema.tables
    WHERE table_schema = 'tpch'
    GROUP BY table_schema
    ORDER BY 2 DESC

Artigos relacionados

• PROGRAMA
• DESCREVER