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`.
IS_ICEBERG	TEXT	Indica se uma tabela é uma tabela Iceberg. Os valores válidos são `YES` ou `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