- Categorias:
EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY¶
Esta função de tabela pode ser usada para consultar informações sobre o histórico dos metadados de uma tabela externa, incluindo:
Arquivos adicionados ou removidos automaticamente como parte de uma atualização de metadados.
Quaisquer erros encontrados ao atualizar os metadados.
Sintaxe¶
EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY (
TABLE_NAME => '<string>'
[, START_TIME => <constant_expr> ] )
Argumentos¶
Obrigatório:
TABLE_NAME => 'string'
Uma cadeia de caracteres especificando um nome de tabela externa.
Opcional:
START_TIME => constant_expr
Carimbo de data/hora (no formato TIMESTAMP_LTZ), dentro dos últimos 30 dias, marcando o início do intervalo de tempo para a recuperação de eventos de atualização de metadados.
Nota
Se nenhuma hora de início for especificada, a função retorna todos os eventos de atualização dos últimos 30 dias.
Se a hora de início estiver fora dos últimos 30 dias, a função retorna resultados dos últimos 30 dias.
Se a hora de início não for um carimbo de data/hora, ela é ignorada.
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 |
---|---|---|
JOB_CREATED_TIME |
TIMESTAMP_LTZ |
Carimbo de data/hora em que a operação ocorreu |
FILE_NAME |
TEXT |
Nome do arquivo preparado de origem e caminho relativo ao arquivo. |
OPERATION_STATUS |
TEXT |
Status: REGISTERED_NEW, REGISTERED_UPDATE, REGISTER_SKIPPED, REGISTER_FAILED, UNREGISTERED ou UNREGISTER_FAILED |
MESSAGE |
TEXT |
Mensagem acompanhando o status da operação |
FILE_SIZE |
NUMBER |
Tamanho do arquivo (em bytes) adicionado à tabela externa |
LAST_MODIFIED |
TIMESTAMP_LTZ |
Carimbo de data/hora em que o arquivo foi atualizado pela última vez no estágio |
Exemplos¶
Recuperar os metadados armazenados para todos os arquivos de dados referenciados pela tabela externa mytable
:
select * from table(information_schema.external_table_file_registration_history(TABLE_NAME=>'MYTABLE'));
Recuperar os eventos de registro para tabela externa mydb.public.external_table_name
que começaram dentro da última hora:
select * from table(information_schema.external_table_file_registration_history( start_time=>dateadd('hour',-1,current_timestamp()), table_name=>'mydb.public.external_table_name'));
Recuperar os eventos de inscrição para tabela externa mydb.public.external_table_name
que começaram a partir da meia-noite de 25 de abril de 2022:
select * from table(information_schema.external_table_file_registration_history( start_time=>cast('2022-04-25' as timestamp), table_name=>'mydb.public.external_table_name'));