オブジェクト・ストレージ内のドキュメントでのJSON検索の使用

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXを使用して、オブジェクト・ストレージのファイルにJSON検索索引を作成します。新しいアップロードまたは削除に対して索引がリフレッシュされる頻度(分)を示すリフレッシュ率を構成できます。詳細は、ファイルのJSONドキュメントでのJSON検索索引の作成を参照してください。

JSON検索索引を作成すると、次のオブジェクトが作成されます。

• オブジェクト・ストレージJSONファイルのJSON検索索引index_name。

• ローカル表INDEX_NAME$TXTIDX。この表は、オブジェクト・ストレージ内のファイル内のドキュメントと、データベースに作成されるJSON検索索引との間のマッピング表です。詳細は、JSON検索索引のリファレンス表を参照してください。

• 標準名がINDEX_NAMEのビュー。このビューを使用して、JSON_TEXTCONTAINSを使用して検索を実行できます。このビューは、INDEX_NAME$TXTIDX表の上に作成されます。詳細は、JSON検索索引リファレンス・ビューを参照してください。

• 標準の接尾辞index_name$txtidx_errを持つエラー・ログ表。詳細は、エラー・ログ表を参照してください。

JSON検索索引作成操作は、ALL_SCHEDULER_JOB_RUN_DETAILSビューに記録されます。詳細は、テキスト索引作成のモニターを参照してください。

Autonomous AI Databaseでは、JSONドキュメントを含む様々なテキスト・ファイルのJSON検索索引作成がサポートされています。たとえば、JSONファイルを圧縮形式と非圧縮形式の両方で索引付けしたり、別のJSONドキュメント・デリミタを選択できます。ファイル処理オプションの詳細は、DBMS_CLOUDパッケージを参照してください。

詳細は、Oracle Textによる索引付けを参照してください。

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXを使用して、オブジェクト・ストレージに格納されているJSONファイルにJSON検索索引を作成します。

1. ソースの場所にアクセスするための資格証明オブジェクトを作成します。

   詳細は「CREATE_CREDENTIALプロシージャ」を参照してください。

2. DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXプロシージャを実行して、オブジェクト・ストレージ・ファイルにJSON検索索引を作成します。

   
   BEGIN 
    DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
           credential_name => 'OBJ_STORE_CRED',
           location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/vcnlogs/',
           index_name      => 'VNCLOGS',
           format          =>  JSON_OBJECT ('json_index' value 'true', 'json_index_doc_len' value 12000, 'file_compression' value 'gzip')
   );
   END;
   /

   この例では、次を作成します。

   • location_uriパラメータで指定されたURIにあるオブジェクト・ストレージ・ファイルのJSON検索索引VNCLOGS。

   • ローカル表VNCLOGS$TXTIDX。詳細は、JSON検索索引のリファレンス表を参照してください。

   • VNCLOGSという名前のビュー。このビューは、VNCLOGS$TXTIDX表の上に作成されます。このビューを使用して、JSON_TEXTCONTAINSを使用して検索を実行できます。詳細は、JSON検索索引リファレンス・ビューを参照してください。

   • VNC$TXTIDX_ERRという名前のエラー・ログ表。この表には、ファイル内の無効なJSONドキュメントのリストが含まれています。詳細は、エラー・ログ表を参照してください。

   JSON検索索引を作成した後、VNCLOGSビューを問い合せることができます。たとえば:

   SELECT JSON_QUERY (data, '$' returning CLOB pretty) AS RECORD 
    FROM vnclogs WHERE JSON_TEXTCONTAINS(file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}');
   

   この問合せは、JSON_TEXTCONTAINS条件で指定されたIPアドレスのログ詳細を返します。JSON検索索引基準は、file_line_json列(データベースのJSON検索索引表の索引付き列)に指定され、JSONドキュメントは、data列を介して表されるオブジェクト・ストレージから直接ストリームされます。data列には、オブジェクト・ストレージ・ファイルのコンテンツが含まれます。

   詳細は、CREATE_EXTERNAL_TEXT_INDEXプロシージャを参照してください。

DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEXプロシージャを使用して、オブジェクト・ストレージに格納されているJSONファイルのJSON検索索引を削除します。

BEGIN 
 DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
  index_name => 'VCNLOGS',
);
END;
/

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXを実行すると、JSON検索索引作成操作がALL_SCHEDULER_JOB_RUN_DETAILSビューに記録されます。

ALL_SCHEDULER_JOB_RUN_DETAILSビューを問い合せて、索引作成ジョブによってレポートされたステータスおよびエラーを取得できます。

DBMS_SCHEDULERジョブの名前は、DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXをコールするときに指定したINDEX_NAMEパラメータから導出されます。

ALL_SCHEDULER_JOB_RUN_DETAILSビューを問い合せるには、ADMINユーザーとしてログインするか、ALL_SCHEDULER_JOB_RUN_DETAILSビューに対するREAD権限を持っている必要があります。

たとえば、job_nameにWHERE句を指定した次のSELECT文は、ジョブの実行詳細を示します。

SELECT status, additional_info 
   FROM all_scheduler_job_run_details WHERE LOWER(job_name) = LOWER('index_name$JOB');

索引作成スケジューラ・ジョブが存在するかどうかを問い合せることもできます。

SELECT status 
    FROM all_scheduler_jobs where LOWER(job_name) = LOWER('index_name$JOB');

詳細は、CREATE_EXTERNAL_TEXT_INDEXプロシージャを参照してください。

ローカル表は、標準の接尾辞INDEX_NAME$TXTIDXを使用してデータベース内に作成されます。この表は、DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXの実行時に内部的に作成されます。

JSON_TEXTCONTAINSキーワードを使用して、INDEX_NAME$TXTIDX表を問い合せて文字列を検索できます。たとえば、DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXプロシージャでINDEX_NAME値をVNCLOGSとしてコールすると、VNCLOGS$TXTIDX JSON検索索引参照表が作成されます。

SELECT * FROM (SELECT object_name, object_path, length, offset 
 FROM vnclogs$txtidx 
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}') 
 ORDER BY mtime DESC) 
 WHERE rownum < 3;
 

この問合せは、オブジェクト・ストレージ内のファイル内の関連ドキュメントの場所に関する内部情報を提供します。問合せでは、実際のドキュメントは提供されません。

SELECT * FROM (SELECT object_name, object_path, data
 FROM vnclogs
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}')
 ORDER BY mtime DESC)
 WHERE rownum < 3;
 

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEXを実行してJSON索引を作成すると、INDEX_NAMEという名前のビューが作成されます。