Categorias:

Information Schema , Funções de tabela

COPY_HISTORY

Esta função de tabela pode ser usada para consultar o histórico de carregamento de dados do Snowflake ao longo de várias dimensões dentro dos últimos 14 dias. A função retorna a atividade de carregamento tanto de instruções COPY INTO <tabela> como para carregamento contínuo de dados usando Snowpipe. A função de tabela evita a limitação da linha de 10.000 de Exibição LOAD_HISTORY. Os resultados podem ser filtrados usando predicados SQL.

Você também pode visualizar detalhes do carregamento de dados em Snowsight. Consulte Monitoramento da atividade de carregamento de dados usando o histórico de cópias.

Sintaxe

COPY_HISTORY(
      TABLE_NAME => '<string>'
       , START_TIME => <constant_expr>
      [, END_TIME => <constant_expr> ] )
Copy

Argumentos

Obrigatório:

TABLE_NAME => 'string'

Uma cadeia de caracteres especificando um nome de tabela.

START_TIME => constant_expr

Carimbo de data/hora (no formato TIMESTAMP_LTZ), nos últimos 14 dias, marcando o início do intervalo de tempo para a recuperação de eventos de carregamento.

Opcional:

END_TIME => constant_expr

Carimbo de data/hora (no formato TIMESTAMP_LTZ), nos últimos 14 dias, marcando o fim do intervalo de tempo para a recuperação de eventos de carregamento.

Padrão: CURRENT_TIMESTAMP.

Notas de uso

  • Para carregamentos de dados em massa, essa função retorna resultados para uma função que tem privilégio MONITOR em sua conta Snowflake, ou uma função com privilégio USAGE no esquema e no banco de dados e qualquer privilégio na tabela.

  • Para carregamentos de dados do Snowpipe, essa função retorna resultados para uma função que tem privilégio MONITOR em sua conta Snowflake, ou uma função com privilégio USAGE no esquema e no banco de dados que contenham o canal e qualquer privilégio na tabela. Além disso, se MONITOR no canal não estiver disponível, o nome do canal, o nome da tabela do canal, o nome do esquema do canal e o nome do catálogo do canal serão mascarados como NULL.

  • 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.

  • Esta exibição retorna um limite de 14 dias de histórico de cópias. Para evitar esta limitação, use a exibição COPY_HISTORY (Account Usage).

  • A função inclui apenas comandos COPY INTO que foram executados até a conclusão, com ou sem erros.

  • Remover ou recriar um objeto de tabela remove os dados históricos para carregamentos de dados em massa (instruções COPY INTO <table>) para dentro da tabela.

  • Remover ou recriar um objeto de canal remove os dados históricos para carregamentos de dados em massa do Snowpipe usando o canal.

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.

STAGE_LOCATION

TEXT

Nome do estágio em que se encontra o arquivo de origem.

LAST_LOAD_TIME

TIMESTAMP_LTZ

Data e hora de quando o arquivo terminou de ser carregado.

ROW_COUNT

NUMBER

Número de linhas carregadas a partir do arquivo de origem.

ROW_PARSED

NUMBER

Número de linhas analisadas do arquivo origem; NULL se STATUS for Load in progress.

FILE_SIZE

NUMBER

Tamanho do arquivo de origem carregado (em bytes).

FIRST_ERROR_MESSAGE

TEXT

Primeiro erro do arquivo de origem.

FIRST_ERROR_LINE_NUMBER

NUMBER

Número da linha do primeiro erro.

FIRST_ERROR_CHARACTER_POS

NUMBER

Posição do primeiro caractere de erro.

FIRST_ERROR_COLUMN_NAME

TEXT

Nome da coluna do primeiro erro.

ERROR_COUNT

NUMBER

Número de linhas de erro no arquivo de origem.

ERROR_LIMIT

NUMBER

Se o número de erros atingir este limite, então abortar.

STATUS

TEXT

Status: Load in progress, Loaded, Load failed, Partially loaded ou Load skipped.

TABLE_CATALOG_NAME

TEXT

Nome do banco de dados em que se encontra a tabela de destino.

TABLE_SCHEMA_NAME

TEXT

Nome do esquema em que se encontra a tabela de destino.

TABLE_NAME

TEXT

Nome da tabela de destino.

PIPE_CATALOG_NAME

TEXT

Nome do banco de dados em que se encontra o canal.

PIPE_SCHEMA_NAME

TEXT

Nome do esquema em que se encontra o canal.

PIPE_NAME

TEXT

Nome do canal que define os parâmetros de carregamento; NULL para carregamentos da instrução COPY.

PIPE_RECEIVED_TIME

TIMESTAMP_LTZ

Data e hora em que a solicitação INSERT para o arquivo carregado através do canal foi recebida; NULL para carregamentos de instrução COPY.

Exemplos

Recuperar detalhes sobre toda a atividade de carregamento na última hora:

select *
from table(information_schema.copy_history(TABLE_NAME=>'MYTABLE', START_TIME=> DATEADD(hours, -1, CURRENT_TIMESTAMP())));
Copy