Esquema:: ACCOUNT_USAGE

Exibição COPY_HISTORY¶

Esta exibição do Account Usage pode ser usada para consultar o histórico de carregamento de dados do Snowflake dos últimos 365 dias (1 ano). A exibição mostra a atividade de carregamento tanto de instruções COPY INTO <tabela> como para carregamento contínuo de dados usando Snowpipe. A exibição evita a limitação da linha 10.000 de Exibição LOAD_HISTORY.

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.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
FILE_NAME	VARCHAR	Nome do arquivo de origem e caminho relativo ao arquivo.
STAGE_LOCATION	VARCHAR	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.
FIRST_ERROR_MESSAGE	VARCHAR	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	VARCHAR	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	VARCHAR	Status: `Loaded`, `Load failed`, `Partially loaded` ou `Load skipped`.
TABLE_ID	NUMBER	Identificador interno/gerado pelo sistema para a tabela de destino.
TABLE_NAME	VARCHAR	Nome da tabela de destino.TABLE_NAME
TABLE_SCHEMA_ID	NUMBER	Identificador interno, gerado pelo Snowflake, do esquema para a tabela.
TABLE_SCHEMA_NAME	VARCHAR	Nome do esquema em que se encontra a tabela de destino.
TABLE_CATALOG_ID	NUMBER	Identificador interno/gerado pelo sistema para o banco de dados da tabela.
TABLE_CATALOG_NAME	VARCHAR	Nome do banco de dados em que se encontra a tabela de destino.
PIPE_CATALOG_NAME	VARCHAR	Nome do banco de dados em que se encontra o canal.
PIPE_SCHEMA_NAME	VARCHAR	Nome do esquema em que se encontra o canal.
PIPE_NAME	VARCHAR	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.
FIRST_COMMIT_TIME	TIMESTAMP_LTZ	Data e a hora em que a primeira parte do arquivo é confirmado. Snowpipe pode carregar um arquivo em várias partes que são confirmadas separadamente.
BYTES_BILLED	NUMBER	Representa o número de bytes que o Snowpipe usa para fins de faturamento, fornecendo visibilidade das implicações de custo do Snowpipe diretamente nessas exibições de histórico.

Notas de uso¶

Na maioria dos casos, a latência da visualização pode ser de até 120 minutos (2 horas). A latência do histórico de cópias de uma determinada tabela pode 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 COPY_HISTORY.
- Menos de 100 linhas foram adicionadas à tabela fornecida desde a última atualização em COPY_HISTORY.

A exibição inclui apenas comandos COPY INTO que foram executados até a conclusão, com ou sem erros.
O descarte ou a recriação de um objeto de tabela remove os metadados do histórico de carga para desduplicação de carga de dados em massa (instruções COPY INTO <tabela>) na tabela.
A renomeação de um objeto de tabela atualiza as entradas TABLE_NAME correspondentes no histórico de cópias.
O descarte ou a recriação de um objeto de canal não remove os metadados do histórico de carga do canal.
A visualização exibe apenas objetos para os quais a função atual da sessão tem privilégios de acesso.
Após a replicação do histórico de cópias, a exibição COPY_HISTORY do Account 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 de cópias completo.

Exemplos¶

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

select file_name, error_count, status, last_load_time from snowflake.account_usage.copy_history
  order by last_load_time desc
  limit 10;

Copy