ロードのモニターおよびトラブルシューティング
PL/SQLパッケージ
を使用して実行されたすべてのデータ・ロード操作は、表DBMS_CLOUD
dba_load_operations
およびuser_load_operations
に記録されます:
-
dba_load_operations
: すべてのロード操作が表示されます。 -
user_load_operations
: 自分のスキーマのロード操作が表示されます。
これらの表を問い合せると、進行中または完了済のデータ・ロードに関する情報が表示されます。このSELECT
文をTYPE
列に対するWHERE
句条件付きで使用できます。このCOPY
タイプのロード操作を表示します。
たとえば:
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
LOGFILE_TABLE
列には、ロード操作のログを確認するための問合せを実行できる表の名前が表示されます。たとえば、次の問合せでは、このロード操作のログが表示されます。
SELECT * FROM COPY$1_LOG;
BADFILE_TABLE
列には、ロード中にエラーが発生する行を確認できる問合せ先の表の名前が表示されます。たとえば、次の問合せでは、ロード操作で拒否されたレコードが表示されます操作に拒否された行がない場合、問合せには拒否された行は表示されません。
SELECT * FROM COPY$1_BAD;
ログに示されたエラーと、BADFILE_TABLE
ファイルに示された行に応じて、DBMS_CLOUD.COPY_DATA
の適切なフォーマット・オプションを指定することで、エラー修正できます。
type
のフォーマットが"datapump
"の場合、指定したrejectlimit
まで拒否された行はログ・ファイルに記録されますが、BADFILE_TABLE
は生成されません。
デフォルトでは、LOGFILE_TABLE
ファイルとBADFILE_TABLE
ファイルは2日間保持され、自動的に削除されます。保持日数を変更するには、format
パラメータのlogretention
オプションを使用します。
format
パラメータのenablelogs
、logdir
、logprefix
およびlogretention
オプションの詳細は、DBMS_CLOUDパッケージ・フォーマット・オプションを参照してください。
ログ・ファイルのクリアの詳細は、「DELETE_ALL_OPERATIONSプロシージャ」を参照してください。
dba_load_operations
ビューおよびuser_load_operations
ビューの詳細は、「DBMS_CLOUDロード操作の追跡」を参照してください。
一括ファイル操作のモニターおよびトラブルシューティング
バルク・ファイル操作の監視およびトラブルシューティングの詳細は、バルク・ファイル・ロードのモニターおよびトラブルシューティングを参照してください。
ORC、ParquetまたはAvroファイルのロードのモニターおよびトラブルシューティング
他のデータ・ファイルと同様に、ORC、ParquetおよびAvroデータをロードすると、dba_load_operations
およびuser_load_operations
表で表示可能なログが生成されます。各ロード操作により、ログを含む表を示すdba
[user]_load_operations
にレコードが追加されます。
ログ表には、ロードに関するサマリー情報が表示されます。
ORC、ParquetまたはAvroファイルでは、format
パラメータのtype
が値orc
、parquet
またはavro
に設定されていると、BADFILE_TABLE
表は常に空です。
PRIMARY KEY
制約エラーによってORA
エラーがスローされます。- 列のデータに変換エラーが発生した場合(たとえば、ターゲット列の大きさが変換済の値を保持するのに十分な大きさでない場合など)、その列の値は
NULL
に設定されます。これにより、拒否されたレコードは生成されません。
親トピック: クラウドのファイルからのデータのロード