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