Esquema:

ACCOUNT_USAGE

Exibição TABLES

Esta visualização do Account Usage exibe uma linha para cada tabela e visualização na conta.

Consulte também:

Exibição COLUMNS , Exibição VIEWS

Colunas

Nome da coluna

Tipo de dados

Descrição

TABLE_ID

NUMBER

Identificador interno, gerado pelo Snowflake para a tabela.

TABLE_NAME

TEXT

Nome da tabela.

TABLE_SCHEMA_ID

NUMBER

Identificador interno, gerado pelo Snowflake, do esquema para a tabela.

TABLE_SCHEMA

TEXT

Esquema a qual a tabela pertence.

TABLE_CATALOG_ID

NUMBER

Identificador interno, gerado pelo Snowflake, do banco de dados para a tabela.

TABLE_CATALOG

TEXT

Banco de dados ao qual a tabela pertence.

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 a tabela é transitória.

CLUSTERING_KEY

TEXT

Coluna(s) e/ou expressão(ões) que compõem a 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

Data e 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.

DELETED

TIMESTAMP_LTZ

Data e hora em que a tabela foi descartada.

AUTO_CLUSTERING_ON

TEXT

Status do clustering automático para uma tabela. Para obter mais detalhes, consulte Visualização do status de Clustering automático para uma tabela.

COMMENT

TEXT

Comentário para a tabela.

OWNER_ROLE_TYPE

TEXT

O tipo de função que possui o objeto, ROLE ou DATABASE_ROLE. . Se um Snowflake Native App possuir o objeto, o valor será APPLICATION. . Snowflake retornará NULL se você excluir o objeto porque um objeto excluído não tem função de proprietário.

INSTANCE_ID

NUMBER

Identificador interno/gerado pelo sistema para a instância à qual o objeto pertence.

IS_ICEBERG

TEXT

Indica se uma tabela é uma tabela Iceberg. Os valores válidos são YES ou NO.

Notas de uso

  • A latência da visualização pode ser de até 90 minutos.

  • A exibição não reconhece o privilégio MANAGE GRANTS e consequentemente pode mostrar menos informações em comparação com um comando SHOW executado por um usuário com o privilégio MANAGE GRANTS.

  • Consultar o SUM(BYTES) para 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 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

Recupere o tamanho total (em bytes) de todas as tabelas ativas em todos os esquemas de sua conta:

SELECT TABLE_SCHEMA,SUM(BYTES)
    FROM snowflake.account_usage.tables
    WHERE DELETED IS NULL
    GROUP BY TABLE_SCHEMA;
Copy