3.15 SODAコレクションの管理

Simple Oracle Document Access (SODA)はNoSQL形式のAPIセットであり、これを使用すると、Oracle Databaseのドキュメントのコレクションを作成および格納でき、Structured Query Language (SQL)や、ドキュメントがどのようにデータベースに格納されているかを理解していなくても、そのコレクションの取得や問合せを行うことができます。

3.15.1 SODAコレクションについて

JSON、TXTまたはZIPファイルとしてデータをSODAコレクションにロードできます。

SODAコレクションは、オブジェクト・ブラウザでのオブジェクト・タイプです。オブジェクト・ブラウザを使用して、ワークスペースからの削除など、既存のSODAコレクションを表示または編集します。

要件

  • データベース18.3以上。
  • ワークスペース・ユーザーにはSODA_APPロールが必要です。

サポートされているファイル・タイプ

次のファイル・タイプをSODAコレクションにアップロードできます。

  • JSONファイル - APEXでは、複数のJSONオブジェクトを持つ配列を含むJSONファイルがサポートされています。APEXでは、配列から各JSONオブジェクトを抽出し、単一のJSONドキュメントとしてSODAコレクションにロードします。配列セレクタはデフォルトで自動検出されます。

  • JSONリスト - JSONリストは、複数のJSONドキュメントが1行に1つ、改行で区切られて含まれているファイルです。

  • ZIPファイル - ZIPファイルは自動的に抽出され、各ファイルはSODAコレクションにアップロードできます。データ・ロード設定に応じて、ZIPアーカイブ内の非JSONファイルはスキップされるか、または同様にコレクションにロードされます。XMLファイルは、SODAコレクションにロードする前にJSONに変換できます。

3.15.2 SODAコレクションの作成

SQLワークショップを使用して、ドキュメントを新しいSODAコレクションにロードします。

ドキュメントを新しいSODAコレクションにロードするには、次のようにします。

  1. オブジェクト・ブラウザで、右上の「作成」アイコン(+)をクリックします。
  2. 「SODAコレクション」を選択します。
    「SODAコレクションへのデータのロード」ダイアログが表示されます。

    ヒント:

    データのロード・ウィザードには、様々なSQLワークショップ・ページの「オブジェクトの作成」列で「SODAコレクション」ショートカットを使用してアクセスすることもできます。
  3. 次のいずれかを行います
    • 目的のJSON、TXTまたはZIPファイルをダイアログにドラッグ・アンド・ドロップします。
    • 「ファイルの選択」をクリックし、ローカル・システムでファイルの場所を参照して、アップロードします。
    ウィザードでは、ファイル・タイプに基づいて次の画面が用意されます。
  4. オプションを構成します。すべてのファイルタイプについて、アップロード・オプションを選択します。
    • 新しいコレクションを作成する(デフォルト)には、「新規コレクション」を選択します。
    • 既存のコレクションにアップロードするには、「既存のコレクション」を選択します。
  5. 「SODAコレクション名」に、コレクションの名前を入力します。

    ヒント:

    「リレーショナル・ビューの作成」が有効になっている場合、リレーショナル・ビュー名がSODAコレクション名に基づいて自動的に移入されます。必要に応じて、リレーショナル・ビュー名を変更できます。
  6. 「データのロード」をクリックします。
    データがロードされます。この場合、時間がかかることがあります。
  7. アップロードが完了したら、次の方法で続行できます。
    • オブジェクト・ブラウザでSODAコレクションを表示するには、「コレクションの表示」をクリックします。
    • アプリケーションの作成ウィザード(アプリケーション・ビルダー)を移動するには、「アプリケーションの作成」をクリックします。
    • オブジェクト・ブラウザに戻るには、「X」アイコン(右上)をクリックするか、[Esc]を押してダイアログを閉じます。

3.15.3 SODAコレクションの表示

オブジェクト・ブラウザで既存のSODAコレクションにアクセスします。

既存のSODAコレクションにアクセスするには、次のようにします。

  1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。
  2. 「オブジェクト・ブラウザ」をクリックします。
  3. オブジェクト選択ペイン(左側)で、「オブジェクト・タイプ」ドロップダウン・メニュー(デフォルトでは「表」が選択されています)をクリックします。
  4. 「SODAコレクション」を選択します。
    既存のSODAコレクションのリストが表示されます。
  5. コレクションをクリックして表示します。
    次の3つのタブが表示されます。
    • コレクション・コンテンツ - コレクションの一般的な内容が表示されます。コレクションの「データのロード」および「削除」ボタンがあります。
    • データ・ガイド - コレクションに関連付けられているリレーショナル・ビューおよび完全なJSONデータ・ガイドが表示されます。リレーショナル・ビューの「検索索引の削除」および「リレーショナル・ビューの作成」ボタンがあります。(「ビュー名」でビューをクリックすると、オブジェクト・ブラウザの「ビュー」に移動します。)
    • コレクション・メタデータ - SODA RESTエンドポイントURLおよび完全なコレクション・メタデータが表示されます。

3.15.4 SODAコレクションの編集または削除

オブジェクト・ブラウザでSODAコレクションを表示し、「データのロード」を使用して新しいバージョンのデータをアップロードするか、「削除」ボタンをクリックしてワークスペースからSODAコレクションを削除します。

オブジェクト・ブラウザでSODAコレクションを表示するには、次のようにします。

  1. オブジェクト・ブラウザで、「オブジェクト・タイプ」ドロップダウン・メニューをクリックして「SODAコレクション」を選択します。
  2. 更新するSODAコレクションを選択します。

SODAコレクションを変更するには、次のようにします。

  1. 「データのロード」ボタンをクリックします。
    データ・アップロード・ウィザードが開きます。
  2. ウィザードに従って進み、「ロード先」で「既存のコレクション」を必ず選択します。

SODAコレクションを削除するには、次のようにします。

  1. 「削除」ボタンをクリックします。
    確認画面が表示されます。
  2. 「削除」ボタンをクリックして確認します。