Esquema:: ORGANIZATION_USAGE

Exibição COPY_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.

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¶

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
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.
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: `Loaded`, `Load failed`, `Partially loaded` ou `Load skipped`.
TABLE_ID	NUMBER	Identificador interno/gerado pelo sistema para a tabela de destino.
TABLE_NAME	TEXT	Nome da tabela de destino.TABLE_NAME
TABLE_SCHEMA_ID	NUMBER	Identificador interno, gerado pelo Snowflake, do esquema para a tabela.
TABLE_SCHEMA_NAME	TEXT	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	TEXT	Nome do banco de dados em que se encontra a 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.
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.

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 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 account_name, file_name, error_count, status, last_load_time
  FROM snowflake.organization_usage.copy-history
  ORDER BY last_load_time desc
  LIMIT 10;

Copy