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, Exibição TABLES (Information Schema)

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 por uma operação de metadados de DML, DDL ou em segundo plano. 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, por exemplo `ROLE`. . Se um Snowflake Native App possui o objeto, o valor é `APPLICATION`. . Snowflake retorna NULL se você excluir o objeto porque um objeto excluído não tem uma 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`.
IS_DYNAMIC	TEXT	Indica se a tabela é uma tabela dinâmica. 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.
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¶

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