Snowflake Information Schema¶

O que é INFORMATION_SCHEMA?¶

Cada banco de dados criado em sua conta inclui automaticamente um esquema embutido, somente leitura, chamado INFORMATION_SCHEMA. O esquema contém os seguintes objetos:

• Exibições para todos os objetos contidos no banco de dados, bem como exibições para objetos em nível de conta (ou seja, objetos que não são de banco de dados, como funções, warehouses e bancos de dados)

• Funções de tabela para dados históricos e de uso em sua conta.

Funções de tabela e exibições Information Schema¶

Notas de uso geral¶

• Cada esquema INFORMATION_SCHEMA é somente leitura (ou seja, o esquema e todas as exibições e funções de tabela no esquema não podem ser modificados ou descartados).

• Consultas sobre exibições INFORMATION_SCHEMA não garantem consistência com respeito a DDL simultâneo. Por exemplo, se um conjunto de tabelas for criado enquanto uma consulta INFORMATION_SCHEMA de longa duração estiver sendo executada, o resultado da consulta pode incluir algumas, nenhuma ou todas as tabelas criadas.

• A saída de uma exibição ou função de tabela depende dos privilégios concedidos à função atual do usuário. Ao consultar uma exibição INFORMATION_SCHEMA ou função de tabela, somente os objetos para os quais foram concedidos privilégios de acesso à função atual são retornados.

• Para evitar problemas de desempenho, o seguinte erro é retornado se os filtros especificados em uma consulta INFORMATION_SCHEMA não forem suficientemente seletivos:

  Information schema query returned too much data. Please repeat query with more selective predicates.

• As exibições específicas do Snowflake estão sujeitas a mudanças. Evite selecionar todas as colunas dessas exibições. Em vez disso, selecione as colunas que você deseja. Por exemplo, se você quiser a coluna name, use SELECT name em vez de SELECT *.

Considerações para substituir comandos SHOW por exibições Information Schema¶

A exibição INFORMATION_SCHEMA fornece uma interface SQL para as mesmas informações fornecidas pelos comandos SHOW <objetos>. Você pode usar as exibições para substituir esses comandos; no entanto, há algumas diferenças importantes a serem consideradas antes da troca:

Qualificação dos nomes das funções de tabela e exibições Information Schema em consultas¶

Ao consultar uma função de tabela ou exibição INFORMATION_SCHEMA, você deve usar o nome qualificado da exibição/função de tabela ou o esquema INFORMATION_SCHEMA deve estar em uso para a sessão.

Por exemplo:

• Para consultar usando os nomes totalmente qualificados da função de tabela e exibição, na forma de database.information_schema.name:

  SELECT table_name, comment FROM testdb.INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(testdb.INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• Para consultar usando os nomes qualificados da função de tabela e exibição, na forma de information_schema.name:

  USE DATABASE testdb;
  
  SELECT table_name, comment FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• Para consultar com o esquema INFORMATION_SCHEMA em uso para a sessão:

  USE SCHEMA testdb.INFORMATION_SCHEMA;
  
  SELECT table_name, comment FROM TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(LOGIN_HISTORY( ... ));
  

  Copy

  Nota

  Se você estiver usando um banco de dados que foi criado a partir de um compartilhamento e tiver selecionado INFORMATION_SCHEMA como o esquema atual para a sessão, a instrução SELECT pode falhar com o seguinte erro:

  INFORMATION_SCHEMA does not exist or is not authorized

  Se isso ocorrer, selecione um esquema diferente para o esquema atual para a sessão.

Para exemplos mais detalhados, consulte a documentação de referência para cada exibição/função de tabela.