Esquema:: ORGANIZATION_USAGE

Exibição TABLES¶

Importante

Essa exibição só está disponível na conta da organização. Para obter mais informações, consulte Exibições premium na conta da organização.

Essa exibição do Organization Usage exibe uma linha para cada tabela e exibição em uma conta.

Consulte também:: Exibição COLUMNS, Exibição VIEWS, Exibição TABLES (Information Schema)

Colunas¶

Colunas em nível de organização

Nome da coluna	Tipo de dados	Descrição
ORGANIZATION_NAME	VARCHAR	Nome da organização.
ACCOUNT_LOCATOR	VARCHAR	Identificador gerado pelo sistema para a conta.
ACCOUNT_NAME	VARCHAR	Identificador definido pelo usuário para a conta.

Colunas adicionais

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 unir o `<id>` à coluna USER_ID na exibição USERS do esquema ACCOUNT_USAGE ou ORGANIZATION_USAGE.
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`.
IS_HYBRID	TEXT	Indica se a tabela é uma tabela híbrida. Os valores válidos são `YES` ou `NO`.

Notas de uso¶

A latência da exibição pode ser de até 24 horas.

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 account_name, table_schema, SUM(bytes)
    FROM SNOWFLAKE.ORGANIZATION_USAGE.TABLES
    WHERE deleted IS NULL
    GROUP BY table_schema;

Copy