Exibição TABLES¶

Colunas¶

Notas de uso¶

• A visualização exibe apenas objetos para os quais a função atual da sessão tem privilégios de acesso. A exibição não honra o privilégio MANAGE GRANTS e, consequentemente, pode mostrar menos informações em comparação com um comando SHOW quando ambos são executados por uma função com o privilégio MANAGE GRANTS.

  Este comportamento também se aplica a outros privilégios em nível de conta e exibições do Information Schema para as quais há um comando SHOW correspondente.

• A consulta da soma (bytes) de uma tabela não representa o uso total de armazenamento, porque a quantidade não inclui o uso do Time Travel e Fail-safe.

• A exibição não inclui as tabelas que foram descartadas. Para ver as tabelas descartadas, use SHOW TABLES em seu lugar.

• Para visualizar apenas tabelas em suas consultas, filtre usando uma cláusula WHERE, por exemplo:

  ... WHERE table_schema != 'INFORMATION_SCHEMA'

• Usar o valor na coluna LAST_ALTERED para Time Travel não é recomendado e pode retornar resultados inesperados pelos seguintes motivos:

  • O Time Travel só pode ser usado para consultar dados históricos modificados por uma operação de DML.

  • A coluna LAST_ALTERED inclui as operações de DML e DDL (consulte a próxima nota de uso).

  • Para operações de DML, o valor na coluna LAST_ALTERED é o carimbo de data/hora no início da execução da instrução, e não o momento da confirmação da transação com esta instrução.

• A coluna LAST_ALTERED é atualizada quando as seguintes operações são executadas em um objeto:

  • operações DDL.

  • operações DML (somente para tabelas). Esta coluna é atualizada mesmo quando nenhuma linha é afetada pela instrução DML.

  • Operações de manutenção em segundo plano em metadados realizadas pelo Snowflake.

  Para exibições e tabelas, use a coluna LAST_DDL para a hora da última modificação de um objeto.

• O valor na coluna LAST_DDL é atualizado da seguinte forma:

  • Quando uma tabela ou exibição é criada, o carimbo de data/hora LAST_DDL é igual ao carimbo de data/hora CREATED.

  • Quando uma tabela ou exibição é descartada, o carimbo de data/hora LAST_DDL é igual ao carimbo de data/hora DELETED.

  • Os últimos dados DDL não estão disponíveis para operações que ocorreram antes das colunas serem adicionadas. Os novos campos DDL contêm null até que uma operação DDL seja executada.

  • Para bancos de dados replicados, os campos LAST_DDL e LAST_DDL_BY são atualizados apenas para objetos no banco de dados primário. Após o failover, os campos LAST_DDL e LAST_DDL_BY são atualizados para operações DDL nas tabelas e exibições no banco de dados primário recém-promovido. Esses campos permanecerão inalterados para objetos no banco de dados secundário.

  • Para objetos em bancos de dados secundários criados recentemente durante uma operação de atualização, esses campos são null.

• A coluna LAST_ALTERED não indica necessariamente o último horário de atualização das tabelas externas. Para recuperar o último horário de atualização de uma tabela externa atualizada automaticamente, é possível usar a função SYSTEM$EXTERNAL_TABLE_PIPE_STATUS, que retorna informações como o carimbo de data/hora do último arquivo registrado pelo Snowflake.

Exemplos¶

Recuperar o tamanho (em bytes) de todas as tabelas em todos os esquemas do banco de dados mydatabase:

SELECT table_schema, SUM(bytes)
    FROM mydatabase.INFORMATION_SCHEMA.TABLES
    GROUP BY TABLE_SCHEMA;

Copy