Categorias:

Information Schema , Funções de tabela

STAGE_DIRECTORY_FILE_REGISTRATION_HISTORY

Esta função de tabela pode ser usada para consultar informações sobre o histórico dos metadados de uma tabela de diretório, incluindo:

  • Arquivos adicionados ou removidos automaticamente como parte de uma atualização de metadados.

  • Quaisquer erros encontrados ao atualizar os metadados.

Sintaxe

STAGE_DIRECTORY_FILE_REGISTRATION_HISTORY (
      STAGE_NAME => '<string>'
      [, START_TIME => <constant_expr> ] )
Copy

Argumentos

Obrigatório:

STAGE_NAME => 'string'

Uma cadeia de caracteres especificando o nome de um estágio que tem uma tabela de diretório.

Opcional:

START_TIME => constant_expr

Carimbo de data/hora (no formato TIMESTAMP_LTZ), dentro dos últimos 14 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 14 dias.

  • Se a hora de início estiver fora dos últimos 14 dias, a função retornará resultados vazios.

Notas de uso

  • Retorna resultados para o proprietário do estágio (ou seja, a função com o privilégio OWNERSHIP no estágio), ou uma função superior, ou uma função que tem o privilégio USAGE no banco de dados e esquema que contém um estágio com uma tabela de diretório e qualquer privilégio no estágio.

  • A função de tabela não pode recuperar metadados sobre os arquivos de dados preparados até que a tabela de diretório 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 de diretório.

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 pelo estágio mystage:

SELECT *
  FROM TABLE(information_schema.stage_directory_file_registration_history(
  STAGE_NAME=>'MYSTAGE'));
Copy

Recuperar os eventos de registro para a tabela de diretório no estágio mydb.public.mystage que começou na última hora:

SELECT *
  FROM TABLE(information_schema.stage_directory_file_registration_history(
    START_TIME=>DATEADD('hour',-1,current_timestamp()),
    STAGE_NAME=>'mydb.public.mystage'));
Copy
Linguagem: Português