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