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.

A exibição COPY_HISTORY mostra o histórico de cópia somente após a última operação de truncamento na tabela de destino. Isto se aplica às exibições COPY_HISTORY antes e depois da replicação.

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