Surveillance et dépannage des chargements

Toutes les opérations de chargement de données effectuées à l'aide du package PL/SQL DBMS_CLOUD sont consignées dans les tables dba_load_operations et user_load_operations :

  • dba_load_operations affiche toutes les opérations de chargement.

  • user_load_operations affiche les opérations de chargement dans votre schéma.

Interrogez ces tables pour obtenir des informations sur les chargements de données en cours et terminés. Utilisez une instruction SELECT avec un prédicat de clause WHERE sur la colonne TYPE pour afficher les opérations d'un chargement de type COPY.

Par exemple :

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    

La colonne LOGFILE_TABLE indique le nom de la table que vous pouvez interroger pour consulter le journal d'une opération de chargement. Par exemple, la requête suivante affiche le journal de cette opération de chargement :

SELECT * FROM COPY$1_LOG;

La colonne BADFILE_TABLE indique le nom de la table sur laquelle vous pouvez interroger pour consulter les lignes qui ont rencontré d'erreurs lors du chargement. Par exemple, la requête suivante affiche les enregistrements rejetés pour l'opération de chargement . S'il n'y a aucune ligne rejetée dans l'opération, la requête n'affiche aucune ligne rejetée.

SELECT * FROM COPY$1_BAD;

En fonction des erreurs affichées dans le journal et des lignes affichées dans le fichier BADFILE_TABLE, vous pouvez corriger l'erreur en indiquant les options d'un format correct dans DBMS_CLOUD.COPY_DATA.

Lorsque le format type est "datapump", toutes les lignes rejetées jusqu'à la valeur rejectlimit indiquée sont consignées dans le fichier journal, mais aucune valeur BADFILE_TABLE n'est générée.

Par défaut, les fichiers LOGFILE_TABLE et BADFILE_TABLE sont conservés pendant deux jours, puis supprimés automatiquement. Vous pouvez modifier le nombre de jours de conservation avec l'option logretention pour le paramètre format.

Pour plus d'informations sur les options enablelogs, logdir, logprefix et logretention du paramètre format, reportez-vous à la section DBMS_CLOUD Package Format Options.

Pour plus d'information sur l'effacement des fichiers journaux, reportez-vous à la procédure DELETE_ALL_OPERATIONS.

Pour plus d'informations sur les vues dba_load_operations et user_load_operations, reportez-vous à Suivi des opérations de chargement DBMS_CLOUD.

Surveillance et dépannage des opérations de fichiers en masse

Pour plus d'informations sur la surveillance et le dépannage des opérations de fichiers en masse, reportez-vous à Surveillance et dépannage des chargements de fichiers en masse.

Surveillance et dépannage du chargement de fichiers ORC, Parquet ou Avro

Comme pour les autres fichiers de données, les chargements de données ORC, Parquet et Avro génèrent des journaux visibles dans les tables dba_load_operations et user_load_operations. Chaque opération de chargement ajoute un enregistrement à dba[user]_load_operations qui indique la table contenant les journaux.

La table de journalisation fournit des informations récapitulatives sur le chargement.

Remarque

Pour les fichiers ORC, Parquet ou Avro, lorsque le paramètre format type est défini sur la valeur orc, parquet ou avro, la table BADFILE_TABLE est toujours vide.

  • Les erreurs de contrainte PRIMARY KEY génèrent une erreur ORA.
  • Si les données d'une colonne rencontrent une erreur de conversion, par exemple, si la colonne cible n'est pas suffisamment grande pour contenir la valeur convertie, la valeur de la colonne est définie sur NULL. Cela ne génère pas d'enregistrement rejeté.