外部JSONデータのロード

10 外部JSONデータのロード

JSONデータのデータベース表を、JSONダンプ・ファイルの内容から作成できます。

このトピックでは、JSONダンプ・ファイル$ORACLE_HOME/demo/schema/order_entry/PurchaseOrders.dmp内のデータから、JSON文書の全表をロードする方法について説明します。このファイルの形式には、Oracle NoSQL Databaseなどの一般的なNoSQLデータベースによって作成されるエクスポート形式との互換性があります。ファイルの各行には、JSONオブジェクトとして表される単一のJSON文書が含まれます。

このような外部表は直接問い合せることができます。または、パフォーマンスを向上させるために、異なる行を対象とする複数の問合せがある場合には、外部表のデータから標準のデータベース表をロードできます。

例10-1では、ファイルシステム・ディレクトリ$ORACLE_HOME/demo/schema/order_entryに対応するデータベース・ディレクトリを作成しています。次に、例10-2では、このデータベース・ディレクトリを使用して外部表であるjson_dump_file_contentsを作成し、ダンプ・ファイルPurchaseOrders.dmpのデータを入力しています。これは、すべてのJSON文書を列json_documentにコピーして、外部表にデータを一括で入力します。

次に、例10-4ではINSERTをSELECT文として使用して、外部表のJSON文書を、通常のデータベース表j_purchaseorderのJSON列po_documentにコピーします。

外部表のJSON列json_documentにBLOB記憶域を選択するため、通常の表の列po_documentも型BLOBにする必要があります。例10-3では、BLOB列po_documentを含めて表j_purchaseorderを作成します。

注意:

データベース・ディレクトリを作成するためには、システム権限CREATE ANY DIRECTORYが必要です。

関連項目:

外部表の概要は、Oracle Database概要を参照してください。
外部表の詳細は、Oracle DatabaseユーティリティおよびOracle Database管理者ガイドを参照してください。
Oracle Databaseデータウェアハウス・ガイド
CREATE TABLEの詳細は、Oracle Database SQL言語リファレンスを参照してください。

例10-1 発注書向けのデータベース・ディレクトリ・オブジェクトの作成

ここで、$ORACLE_HOMEはその値に置き換える必要があります。

CREATE OR REPLACE DIRECTORY order_entry_dir
  AS '$ORACLE_HOME/demo/schema/order_entry';

例10-2 外部表の作成およびJSONダンプ・ファイルからの入力

CREATE TABLE json_dump_file_contents (json_document BLOB)
  ORGANIZATION EXTERNAL (TYPE ORACLE_LOADER DEFAULT DIRECTORY order_entry_dir
                         ACCESS PARAMETERS
                           (RECORDS DELIMITED BY 0x'0A'
                            DISABLE_DIRECTORY_LINK_CHECK
                            FIELDS (json_document CHAR(5000)))
                         LOCATION (order_entry_dir:'PurchaseOrders.dmp'))
  PARALLEL
  REJECT LIMIT UNLIMITED;

例10-3 BLOB JSON列を含む表の作成

表j_purchaseorderには、主キーidと、BLOBデータ型を使用して格納されているJSON列po_documentがあります。この列に対して、LOBキャッシュ・オプションがオンになっています。

DROP TABLE j_purchaseorder;

CREATE TABLE j_purchaseorder
  (id          VARCHAR2 (32) NOT NULL PRIMARY KEY,
   date_loaded TIMESTAMP (6) WITH TIME ZONE,
   po_document BLOB
   CONSTRAINT ensure_json CHECK (po_document IS JSON))
  LOB (po_document) STORE AS (CACHE);

例10-4 外部表からデータベース表へのJSONデータのコピー

INSERT INTO j_purchaseorder (id, date_loaded, po_document)
  SELECT SYS_GUID(), SYSTIMESTAMP, json_document FROM json_dump_file_contents
    WHERE json_document IS JSON;