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	Se a tabela é uma tabela base, tabela temporária ou uma visualização
IS_TRANSIENT	TEXT	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 a tabela foi alterada pela última vez por uma operação DDL ou DML.
AUTO_CLUSTERING_ON	BOOLEAN	Se o clustering automático está habilitado para a tabela
COMMENT	TEXT	Comentário para esta tabela

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'

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;