Exibição TABLES

Esta exibição do Information Schema exibe uma linha para cada tabela e exibição definida no banco de dados especificado (ou atual), incluindo as exibições no próprio esquema INFORMATION_SCHEMA.

Consulte também:

Exibição COLUMNS , Exibição VIEWS

Colunas

Nome da coluna

Tipo de dados

Descrição

TABLE_CATALOG

TEXT

Banco de dados ao qual a tabela pertence.

TABLE_SCHEMA

TEXT

Esquema a qual a tabela pertence.

TABLE_NAME

TEXT

Nome da tabela.

TABLE_OWNER

TEXT

Nome da função proprietária da tabela.

TABLE_TYPE

TEXT

Indica o tipo de tabela. Os valores válidos são BASE TABLE, TEMPORARY TABLE, EXTERNAL TABLE, EVENT TABLE, VIEW ou MATERIALIZED VIEW.

IS_TRANSIENT

TEXT

Indica se esta é uma tabela transitória.

CLUSTERING_KEY

TEXT

Chave de clustering para a tabela.

ROW_COUNT

NUMBER

Número de linhas na tabela.

BYTES

NUMBER

Número de bytes acessados por uma digitalização da tabela.

RETENTION_TIME

NUMBER

Número de dias que os dados históricos são retidos para o Time Travel.

SELF_REFERENCING_COLUMN_NAME

TEXT

Não aplicável para o Snowflake.

REFERENCE_GENERATION

TEXT

Não aplicável para o Snowflake.

USER_DEFINED_TYPE_CATALOG

TEXT

Não aplicável para o Snowflake.

USER_DEFINED_TYPE_SCHEMA

TEXT

Não aplicável para o Snowflake.

USER_DEFINED_TYPE_NAME

TEXT

Não aplicável para o Snowflake.

IS_INSERTABLE_INTO

TEXT

Não aplicável para o Snowflake.

IS_TYPED

TEXT

Não aplicável para o Snowflake.

COMMIT_ACTION

TEXT

Não aplicável para o Snowflake.

CREATED

TIMESTAMP_LTZ

Hora de criação da tabela.

LAST_ALTERED

TIMESTAMP_LTZ

Data e hora em que o objeto foi alterado pela última vez. Consulte as Notas de uso.

LAST_DDL

TIMESTAMP_LTZ

Carimbo de data/hora da última operação DDL executada na tabela ou exibição.

Todas as operações DDL de tabela/exibição suportadas atualizam este campo:

  • { CREATE | ALTER | DROP | UNDROP } TABLE

  • { CREATE | ALTER | DROP } VIEW

Todas as operações ALTER TABLE atualizam esse campo, incluindo a configuração ou desativação de um parâmetro de tabela (por exemplo, COMMENT, DATA_RETENTION_TIME etc.) e alterações nas colunas da tabela (ADD / MODIFY / RENAME / DROP).

Para obter mais informações, consulte as Notas de uso.

LAST_DDL_BY

TEXT

O nome de usuário atual do usuário que executou a última operação DDL. Se o usuário foi descartado, mostra o DROPPED_USER(<id>).

Para usuários descartados, você pode associar o <id> à coluna USER_ID em Exibição USERS.

AUTO_CLUSTERING_ON

BOOLEAN

Indica se o clustering automático está habilitado para a tabela.

COMMENT

TEXT

Comentário para esta tabela.

IS_TEMPORARY

TEXT

Indica se esta é uma tabela temporária. Os valores válidos são YES e NO.

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'

  • 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).

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

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