Exibição EXTERNAL_TABLES¶

Esta exibição do Information Schema exibe uma linha para cada tabela externa definida no banco de dados especificado (ou atual).

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
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 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.
AUTO_CLUSTERING_ON	BOOLEAN	Se o clustering automático está habilitado para a tabela
COMMENT	TEXT	Comentário para esta tabela
LOCATION	TEXT	Estágio externo onde os arquivos contendo os dados a serem lidos são preparados
FILE_FORMAT_NAME	TEXT	Formato de arquivo nomeado que descreve os arquivos de dados preparados a serem digitalizados ao consultar a tabela externa
FILE_FORMAT_TYPE	TEXT	Tipo de formato dos arquivos de dados preparados a serem digitalizados ao consultar a tabela externa

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 um usuário com o privilégio MANAGE GRANTS.
A exibição não inclui as tabelas externas que foram descartadas.
Para visualizar apenas tabelas externas 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). 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¶

Recuperar a lista de todas as tabelas externas em todos os esquemas do banco de dados mydatabase:

SELECT table_name, last_altered FROM mydatabase.information_schema.external_tables;

Copy