Documentação do Oracle Cloud Infrastructure

Monitorar e Diagnosticar/Solucionar Problemas de Cargas

Todas as operações de carregamento de dados feitas usando o pacote DBMS_CLOUD da PL/SQL 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 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 seguinte consulta mostra o log desta operação: 

SELECT * FROM COPY$1_LOG;

A coluna BADFILE_TABLE mostra o nome da tabela a ser consultada para observar as linhas com erros durante a carga. 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 corretas de formato em DBMS_CLOUD.COPY_DATA.

Quando o formato type é "datapump", qualquer linha rejeitada até o rejectlimit especificado é registrada no arquivo de log, mas um BADFILE_TABLE não é gerado.

Por padrão, os arquivos LOGFILE_TABLE e BADFILE_TABLE são mantidos 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 de Pacote para obter informações sobre as opções enablelogs, logdir, logprefix e logretention do parâmetro format.

Consulte DELETE_ALL_OPERATIONS Procedure para saber 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 Arquivos em Massa

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

Monitorar e solucionar problemas de carregamento de arquivos ORC, Parquet ou Avro

Tal como acontece com outros arquivos de dados, os carregamentos de dados ORC, Parquet e Avro geram logs que podem ser visualizados nas tabelas dba_load_operations e user_load_operations. Cada operação de carregamento 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 o carregamento.

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 está 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 produz um registro rejeitado.