Documentação do Oracle Cloud Infrastructure

Monitoramento e Solução de Problemas de Cargas

Todas as operações de carregamento de dados feitas usando o pacote PL/SQL DBMS_CLOUD são registradas nas tabelas dba_load_operations e user_load_operations:

  • dba_load_operations: mostra todas as operações de carga.

  • user_load_operations: mostra as operações de carga no seu esquema.

Consulte estas tabelas para ver informações sobre carregamentos de dados em andamento e concluídos. Use uma instrução SELECT com um predicado de cláusula WHERE na coluna TYPE para mostrar operações de carga com o tipo COPY.

Por exemplo:

SELECT table_name, owner_name, type, status, start_time, update_time, logfile_table, badfile_table 
   FROM user_load_operations WHERE type = 'COPY';

TABLE_NAME OWNER_NAME TYPE STATUS    START_TIME               UPDATE_TIME              LOGFILE_TABLE BADFILE_TABLE 
---------- ---------- ---- --------- ------------------------ ------------------------ ------------- ------------- 
TREEDATA   ADMIN      COPY COMPLETED 2022-10-20T23:15:19.990Z 2022-10-20T23:15:24.238Z COPY$1_LOG    COPY$1_BAD

A coluna LOGFILE_TABLE mostra o nome da tabela que você pode consultar para verificar o log de uma operação de carregamento. Por exemplo, a consulta a seguir mostra o log desta operação de carregamento: 

SELECT * FROM COPY$1_LOG;

A coluna BADFILE_TABLE mostra o nome da tabela que você pode consultar para verificar as linhas com erros durante o carregamento. Por exemplo, a consulta a seguir mostra os registros rejeitados para a operação de carregamento. Se não houver linhas rejeitadas na operação, a consulta não mostrará nenhuma linha rejeitada. 

SELECT * FROM COPY$1_BAD;

Dependendo dos erros mostrados no log e das linhas mostradas no arquivo BADFILE_TABLE, você pode corrigir o erro especificando as opções de formato corretas em DBMS_CLOUD.COPY_DATA.

Quando o formato type é "datapump", todas as linhas rejeitadas até o rejectlimit especificado são registradas no arquivo de log, mas um BADFILE_TABLE não é gerado.

Por padrão, os arquivos LOGFILE_TABLE e BADFILE_TABLE são retidos por dois dias e, em seguida, removidos automaticamente. Você pode alterar o número de dias de retenção com a opção logretention para o parâmetro format.

Consulte DBMS_CLOUD Opções de Formato do Pacote para obter informações sobre as opções enablelogs, logdir, logprefix e logretention do parâmetro format.

Consulte Procedimento DELETE_ALL_OPERATIONS para obter informações sobre como limpar os arquivos de log.

Consulte Rastrear Operações de Carregamento DBMS_CLOUD para obter informações sobre as exibições dba_load_operations e user_load_operations.

Monitorar e Solucionar Problemas de Operações de Arquivo em Massa

Consulte Monitorar e Solucionar Problemas de Cargas de Arquivos em Massa para obter informações sobre monitoramento e solução de problemas para operações de arquivos em massa.

Monitorar e Diagnosticar e Solucionar Problemas de Carga de Arquivos ORC, Parquet ou Avro

Assim como com outros arquivos de dados, as cargas de dados ORC, Parquet e Avro geram logs que são visíveis nas tabelas dba_load_operations e user_load_operations. Cada operação de carga adiciona um registro a dba[user]]_load_operations que indica a tabela que contém os logs.

A tabela de log fornece informações resumidas sobre a carga.

Observação

Para arquivos ORC, Parquet ou Avro, quando o parâmetro format type é definido com o valor orc, parquet ou avro, a tabela BADFILE_TABLE fica sempre vazia.

  • Os erros de restrição PRIMARY KEY geram um erro ORA.
  • Se os dados de uma coluna encontrarem um erro de conversão, por exemplo, a coluna de destino não for grande o suficiente para conter o valor convertido, o valor da coluna será definido como NULL. Isso não gera um registro rejeitado.