Esquema:

ORGANIZATION_USAGE

Exibição LOAD_HISTORY

Importante

Essa exibição só está disponível na conta da organização. Para obter mais informações, consulte Exibições premium na conta da organização.

Essa exibição do Organization Usage permite que você recupere o histórico dos dados carregados nas tabelas usando o comando COPY INTO <tabela>. 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 obter esta informação de histórico, consulte antes a exibição COPY_HISTORY.

Colunas

Colunas em nível de organização

Nome da coluna

Tipo de dados

Descrição

ORGANIZATION_NAME

VARCHAR

Nome da organização.

ACCOUNT_LOCATOR

VARCHAR

Identificador gerado pelo sistema para a conta.

ACCOUNT_NAME

VARCHAR

Identificador definido pelo usuário para a conta.

Colunas adicionais

Nome da coluna

Tipo de dados

Descrição

TABLE_ID

NUMBER

Identificador interno/gerado pelo sistema para a tabela de destino

TABLE_NAME

TEXT

Nome da tabela de destino

SCHEMA_ID

NUMBER

Identificador interno/gerado pelo sistema para o esquema da tabela de destino

SCHEMA_NAME

TEXT

Esquema da tabela de destino

CATALOG_ID

NUMBER

Identificador interno/gerado pelo sistema para o banco de dados da tabela de destino

CATALOG_NAME

TEXT

Banco de dados da tabela de destino

FILE_NAME

TEXT

Nome do arquivo de origem

LAST_LOAD_TIME

TIMESTAMP_LTZ

Data e hora (no fuso horário UTC) 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 anular

Notas de uso

  • Na maioria dos casos, a latência da exibição pode ser de até 24 horas. A latência do histórico de carregamento de uma determinada tabela na exibição poderá ser de até 2 dias se ambas as condições a seguir forem verdadeiras:

    • Menos de 32 instruções DML foram adicionadas à tabela fornecida desde a última atualização em LOAD_HISTORY.

    • Menos de 100 linhas foram adicionadas à tabela fornecida desde a última atualização em LOAD_HISTORY.

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

  • 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
  • Após a replicação do histórico de carga, a exibição LOAD_HISTORY do Organization Usage mostra o histórico somente após a última operação de truncamento na tabela de destino. Isso é diferente da exibição sem replicação, que mostra um histórico completo de carregamento de dados.

Exemplos

Recuperar registros para os 10 comandos mais recentes COPY INTO executados:

SELECT account_name, file_name, last_load_time
FROM snowflake.organization_usage.load_history
  ORDER BY last_load_time DESC
  LIMIT 10;
Copy