「JSON」ページ

5 「JSON」ページ

注意:

Oracle Databaseリリース19c以降のリリースで、SODA_APPロールを持つデータベース・ユーザーとしてサインインしている場合にのみ使用できます。

SQL Developer Webの「JSON」ページを使用して、JSONコレクションの表示と管理、例による問合せ(QBE)を使用したコレクション項目の検索、JSON検索索引の作成およびコレクションのデータ・ガイド・ダイアグラムの表示を行います。

「JSON」ページにナビゲートするには、次のいずれかを実行します。

「データベース・アクション」ページで、「JSON」をクリックします。
「セレクタ」をクリックして、左側のナビゲーション・ペインを表示します。「開発」メニューを展開し、「JSON」を選択します。

トピック

5.1 JSONユーザー・インタフェースについて

JSONユーザー・インタフェースは、保存済コレクションをリストおよび検索するための左ペインと、コレクション内のドキュメントを表示および管理するための右ペインで構成されます。

JSONコレクションのリストおよび検索

次の図に、JSONページの左ペインの主な項目を示します。

図json_left_pane.pngの説明

ドロップダウン・リストで適切なオプションを選択して、保存済JSONコレクションまたは最近アクセスしたJSONコレクションを表示します。

検索機能では大/小文字が区別されず、一致するエントリがすべて取得され、ワイルドカード文字を使用する必要はありません。

コレクションの作成アイコンをクリックして、新しいコレクションを作成します。コレクションの作成を参照してください

コレクション名を右クリックしてコンテキスト・メニューを開きます。使用可能なオプションは次のとおりです。

検索索引: コレクションのJSON検索索引を作成します。作成した検索索引を削除することもできます。コレクションのJSON検索索引の管理を参照してください
削除: コレクションをデータベースから完全に削除します。

コレクションの内容の表示

左ペインで特定のコレクションを選択すると、そのコレクションに属するJSONドキュメントが右ペインに表示されます。

図json_right_pane.pngの説明

右隅には次の2つのアイコンがあります。

ツアー : 使用可能な機能に関する情報を提供するJSONツアーを開始します。
SQLに移動 : 「SQL」ページに移動します。

ツールバーのアイコンは次のとおりです。

新規JSONドキュメント: 新規ドキュメントをコレクションに追加します。JSONドキュメントの追加または編集についてを参照してください
ドキュメントのインポート : ローカル・コンピュータからコレクションに既存の1つ以上のJSONファイルをインポートします。
リストのすべてのドキュメントを削除 : 現在のQBE検索文字列に一致するコレクション内のすべてのJSONドキュメントを削除します。現在の文字列が{}の場合、コレクション内のすべてのドキュメントが削除されます。
収集の詳細: コレクションのプロパティを表示します。フィールドの説明は、コレクションの作成を参照してください。
ダイアグラム: JSONデータ・ガイドを階層形式のダイアグラムとして表示します。コレクションのJSONデータ・ガイド・ダイアグラムの表示を参照してください
問合せの実行 : 「問合せ」または「順序基準」フィールドに入力したQBE条件を使用してドキュメントをフィルタします。コレクション内のドキュメントの問合せについてを参照してください

各JSONドキュメントには次のアイコンがあります。

ドキュメントの編集 : JSONドキュメントを編集します。JSONドキュメントの追加または編集についてを参照してください
ドキュメントのクローン : ドキュメントのクローンを作成します。
ドキュメントのコピー : ドキュメントをクリップボードにコピーします。
ドキュメントのエクスポート : ドキュメントを.JSONファイルとしてダウンロードします。
ドキュメントの削除 : ドキュメントを削除します。

5.2 JSONコレクションの管理

コレクションを追加、表示または削除したり、コレクション内のJSONドキュメントを参照、追加、編集および削除できます。

コレクションの作成: コレクションの作成を参照してください
コレクション内のドキュメントの追加または編集: JSONドキュメントの追加または編集についてを参照してください
コレクション内のドキュメントの表示: 左ペインでコレクション名を選択します。コレクション内のドキュメントが右ペインに表示されます。
コレクション詳細の表示: 左ペインで特定のコレクションを選択し、右ペインのツールバーで「収集の詳細」をクリックして、コレクション・プロパティを表示します。
コレクションの削除: 左ペインでコレクション名を右クリックしてコンテキスト・メニューを開きます。「削除」を選択して、データベースからコレクションを完全に削除します。

5.2.1 コレクションの作成

この項では、コレクションの作成方法について説明します。

JSONページに移動すると、次のようになります。
- 作成されたコレクションがない場合は、JSONホーム・ページが表示されます。コレクションの作成をクリックします。
- 使用可能な既存のコレクションがある場合は、左側のペインでコレクションの作成をクリックします。
コレクション名を入力して、「作成」をクリックします。各フィールドの簡単な説明を次に示します。

コレクション名: コレクションの名前を入力します。コレクション名では大文字/小文字が区別されることに注意してください。

これは、コレクションを作成するための唯一の必須フィールドです。他のフィールドに入力しない場合は、デフォルト値が適用されます。
一般
- 検索索引: コレクションのJSON検索索引を作成するための名前を入力します。
- スキーマ: コレクションがマップされる表またはビューを所有するOracle Databaseスキーマの名前。
- 表: コレクションがマップされる表またはビューの名前。
キー列
- 列名: ドキュメント・キーを格納する列の名前。デフォルト値はIDです。
- データ型: ドキュメント・キーを格納する列のSQLデータ型。
- 最大長: バイト単位の列の最大長(VARCHAR2型の場合のみ)。
- 割当てメソッド: コレクションに挿入するオブジェクトにキーを割り当てるために使用するメソッド。メソッドをSEQUENCEとして指定する場合、その順序名も指定する必要があります。
コンテンツ列
- 列名: ドキュメントのコンテンツを格納する列の名前。デフォルト値はJSON_DOCUMENTです。
- データ型: ドキュメントのコンテンツを格納する列のSQLデータ型。
- 最大長: バイト単位のコンテンツ列の最大長(VARCHAR2型の場合のみ)。
- JSON検証: JSONコンテンツが準拠する必要がある構文(「標準」、「厳密」または緩和)。
- LOB圧縮: SecureFiles LOBの圧縮設定を指定します。
- LOBキャッシュ: SecureFiles LOBのキャッシュ設定を指定します。
- LOB暗号化: SecureFiles LOBの暗号化設定を指定します。
- バージョン列: ドキュメント・バージョンを格納する列の名前。
- 生成メソッド: オブジェクトがコレクションに挿入または置換されるときに、オブジェクトのバージョン値を計算するために使用されるメソッド。
- メディア・タイプ列: ドキュメントのメディア・タイプを格納する列の名前。
- 作成時間列: ドキュメントの作成時のタイムスタンプを格納する列の名前。
- 最終変更列: ドキュメントの最終変更時のタイムスタンプを格納する列の名前。
- 索引: 最終変更列の索引の名前。名前が指定されている場合、インデックスが作成されます。
出力JSON: コレクション属性の値を選択または入力すると、リクエスト本文のJSONペイロードが自動的に表示されます。このテキストは読取り専用です。
コレクションを作成する場合は、「作成」をクリックします。

コレクションを取り消す場合は、「取消」をクリックするか、[Esc]キーを押します。

5.2.2 JSONドキュメントの追加または編集について

JSONエディタを使用して、JSONドキュメントを追加および編集できます。

ドキュメントを追加するには、特定のコレクションの右ペインのツールバーにある「新規JSONドキュメント」をクリックします。

ドキュメントを編集するには、ドキュメント・カードのドキュメントの編集をクリックします。

次の図は、JSONエディタで、テキスト・モードで編集されているドキュメントを示しています。

図json_editor.pngの説明

JSONエディタでは、JSONドキュメントを表示、編集、書式設定および検証できます。エディタの様々なモードは次のとおりです。

フォーム: 値を変更しますが、データ構造は変更しません。
表示: データ構造も値も変更できません。
テキスト: 新しいJSONドキュメントのコンテンツをコピーまたは入力するために使用します。
ツリー: フィールドおよび値を追加、変更、削除、移動および複製します。

「フォーム」、「表示」および「ツリー」モードでは、右上隅にある「検索」フィールドを使用して、ドキュメント内の一致するテキストを検索し、強調表示できます。

5.3 コレクション内のドキュメントの問合せについて

フィルタ仕様または例による問合せ(QBE)を使用して、コレクション内の1つ以上のドキュメントを検索できます。

QBEは、JSONで表されるパターンです。コレクションから、コンテンツが一致するJSONドキュメントを選択するために使用します。つまり、パターンで表される条件が、それらのドキュメントのみのコンテンツに対してtrueと評価される場合です。QBEおよびその使用方法の詳細は、Oracle Database Simple Oracle Document Access (SODA)の概要のSODA QBEの概要を参照してください。

特定のコレクションについて、右ペインの「問合せ」または「順序基準」フィールドにQBEフィルタを入力できます。「問合せ」フィールドを使用してフィルタ条件を入力し、「順序基準」フィールドを使用して問合せ結果を昇順または降順でソートします。これらのフィールドを個別にまたは一緒に使用して、ドキュメントをフィルタできます。

どちらのフィールドもJSONエディタであるため、モードを選択して、ドキュメントのフィルタリングに使用する条件を入力できます。

エディタでは、テキストとツリーの2つのモードを使用できます。エディタのその他のアイコンは次のとおりです。