- Categorias:
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>' )
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'));