Exibição LOAD_HISTORY

Esta exibição do Information Schema permite recuperar o histórico dos dados carregados nas tabelas usando o comando COPY INTO <tabela> nos últimos 14 dias. A exibição exibe uma linha para cada arquivo carregado.

Nota

Esta exibição não retorna o histórico de dados carregados usando o Snowpipe. Para esta informação histórica, consulte antes a função de tabela COPY_HISTORY.

Colunas

Nome da coluna

Tipo de dados

Descrição

SCHEMA_NAME

TEXT

Esquema da tabela de destino

FILE_NAME

TEXT

Nome do arquivo de origem

TABLE_NAME

TEXT

Nome da tabela de destino

LAST_LOAD_TIME

TIMESTAMP_LTZ

Carimbo de data/hora do registro do carregamento

STATUS

TEXT

Status: LOADED, LOAD FAILED ou PARTIALLY LOADED

ROW_COUNT

NUMBER

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

ROW_PARSED

NUMBER

Número de linhas analisadas a partir do arquivo de origem

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_POSITION

NUMBER

Posição do primeiro caractere de erro

FIRST_ERROR_COL_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

Notas de uso

  • Os dados históricos dos comandos COPY INTO são removidos da exibição quando uma tabela é descartada.

  • A exibição inclui apenas comandos COPY INTO que foram executados até a conclusão, com ou sem erros. Nenhum registro é adicionado se a transação for retrocedida, por exemplo, ou se a opção de cópia ON_ERROR = ABORT_STATEMENT estiver incluída na instrução COPY INTO <tabela> e um erro detectado em um arquivo de dados abortar a operação de carregamento.

  • Esta exibição retorna um limite superior de 10.000 linhas. Para evitar esta limitação, utilize esta exibição LOAD_HISTORY (Account Usage), função COPY_HISTORY (Information Schema) ou a exibição COPY_HISTORY (Account Usage).

  • Ao incluir uma cláusula WHERE que faz referência à coluna LAST_LOAD_TIME, você pode especificar qualquer dia da semana. Por exemplo, 1.º de abril de 2016 era uma sexta-feira; no entanto, especificar domingo em vez disso não afeta os resultados da consulta:

    WHERE last_load_time > 'Sun, 01 Apr 2016 16:00:00 -0800'
    
    Copy

Exemplos

Recuperar o histórico dos dados carregados na tabela MYDB.PUBLIC.MYTABLE desde 1.º de abril de 2016, assumindo que 1.º de abril ocorreu dentro dos 14 dias anteriores:

USE DATABASE mydb;

SELECT table_name, last_load_time
  FROM information_schema.load_history
  WHERE schema_name=current_schema() AND
  table_name='MYTABLE' AND
  last_load_time > 'Fri, 01 Apr 2016 16:00:00 -0800';
Copy

Recuperar registros para os 10 comandos mais recentes COPY INTO executados no banco de dados MYDB:

USE DATABASE mydb;

SELECT table_name, last_load_time
  FROM information_schema.load_history
  ORDER BY last_load_time DESC
  LIMIT 10;
Copy