Categorias:: Information Schema , Funções de tabela

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> ] )

Copy

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

Copy

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

Copy

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

Copy