Categorias:

Information Schema , Funções de tabela

EXTERNAL_TABLE_FILES

Esta função de tabela pode ser usada para consultar as informações sobre os arquivos de dados preparados incluídos nos metadados de uma tabela externa especificada.

Sintaxe

EXTERNAL_TABLE_FILES(
      TABLE_NAME => '<string>' )
Copy

Argumentos

Obrigatório:

TABLE_NAME => 'string'

Uma cadeia de caracteres especificando um nome de tabela externa.

Notas de uso

  • Retorna resultados para o proprietário da tabela externa (ou seja, a função com o privilégio OWNERSHIP na tabela externa), ou uma função superior, ou uma função que tem o privilégio USAGE no banco de dados e esquema que contém uma tabela externa e qualquer privilégio na tabela externa.

  • A função de tabela não pode recuperar metadados sobre arquivos de dados preparados até que a tabela externa seja atualizada (ou seja, sincronizada) para incluir os arquivos de dados em seus metadados.

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

FILE_NAME

TEXT

Nome do arquivo de origem e caminho relativo ao arquivo preparado

REGISTERED_ON

TIMESTAMP_LTZ

Carimbo de data/hora quando os metadados do arquivo foram adicionados a uma tabela externa (ou seja, quando os metadados da tabela externa foram atualizados com os detalhes do arquivo)

FILE_SIZE

NUMBER

Tamanho do arquivo (em bytes)

LAST_MODIFIED

TIMESTAMP_LTZ

Carimbo de data/hora em que o arquivo foi atualizado pela última vez no estágio

ETAG

HEX

Cabeçalho ETag para o arquivo

MD5

HEX

Soma de verificação MD5 para o arquivo

Exemplos

Recuperar os metadados armazenados para todos os arquivos de dados referenciados pela tabela externa mytable:

select *
from table(information_schema.external_table_files(TABLE_NAME=>'MYTABLE'));
Copy