「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_right_pane.pngの説明

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

新規JSONドキュメント: 新規ドキュメントをコレクションに追加します。JSONドキュメントの追加または編集についてを参照してください
収集の詳細: コレクションのプロパティを表示します。フィールドの説明は、コレクションの作成を参照してください。
ダイアグラム: JSONデータ・ガイドを階層形式のダイアグラムとして表示します。コレクションのJSONデータ・ガイド・ダイアグラムの表示を参照してください
ドキュメントでは、2つのビューを使用できます。どちらのビューでも、各ドキュメント・エントリには一意のドキュメント識別子と作成されたタイムスタンプが表示されます。「削除」アイコンをクリックしてドキュメントを削除します。
- カード・ビュー: 各ドキュメントをカード形式で表示します。これはデフォルトのビューです。
- リスト・ビュー: ドキュメントをリストで表示します。
フィルタ: 「問合せ」または「順序基準」フィールドに入力したQBE条件を使用してドキュメントをフィルタします。コレクション内のドキュメントの問合せについてを参照してください

5.2 JSONコレクションの管理

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

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

5.2.1 コレクションの作成

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

左ペインで、コレクションの作成をクリックします。
コレクション名を入力して、「作成」をクリックします。各フィールドの簡単な説明を次に示します。
コレクション名: コレクションの名前を入力します。コレクション名では大文字/小文字が区別されることに注意してください。デフォルトでは、これがコレクションを作成するために入力する必要がある唯一のフィールドです。その他のすべてのフィールドには、デフォルトで値が事前入力されています。

一般
- 検索索引: コレクションのJSON検索索引を作成するための名前を入力します。
- スキーマ: コレクションがマップされる表またはビューを所有するOracle Databaseスキーマの名前。
- 表: コレクションがマップされる表またはビューの名前。
キー列
- 列名: ドキュメント・キーを格納する列の名前。デフォルト値はIDです。
- データ型: ドキュメント・キーを格納する列のSQLデータ型。デフォルト値はVARCHAR2です。
- 最大長: バイト単位の列の最大長(VARCHAR2型の場合のみ)。デフォルト値は255です。
- 割当てメソッド: コレクションに挿入するオブジェクトにキーを割り当てるために使用するメソッド。デフォルト値はUUIDです。メソッドをSEQUENCEとして指定する場合、その順序名も指定する必要があります。
コンテンツ列
- 列名: ドキュメントのコンテンツを格納する列の名前。デフォルト値はJSON_DOCUMENTです。
- データ型: ドキュメントのコンテンツを格納する列のSQLデータ型。デフォルト値はBLOBです。
- 最大長: バイト単位のコンテンツ列の最大長(VARCHAR2型の場合のみ)。デフォルト値は4000です。
- JSON検証: JSONコンテンツが準拠する必要がある構文(「標準」、「厳密」または緩和)。
- LOB圧縮: SecureFiles LOBの圧縮設定を指定します。
- LOBキャッシュ: SecureFiles LOBのキャッシュ設定を指定します。デフォルトは有効です。
- LOB暗号化: SecureFiles LOBの暗号化設定を指定します。
- バージョン列: ドキュメント・バージョンを格納する列の名前。デフォルト値はVERSIONです。
- 生成メソッド: オブジェクトがコレクションに挿入または置換されるときに、オブジェクトのバージョン値を計算するために使用されるメソッド。デフォルト値はSHA256です。
- メディア・タイプ列: 20.3リリースではサポートされていません。
- 作成時間列: ドキュメントの作成時のタイムスタンプを格納する列の名前。デフォルト値はCREATED_ONです。
- 最終変更列: ドキュメントの最終変更時のタイムスタンプを格納する列の名前。デフォルト値はLAST_MODIFIEDです。
- 索引: 最終変更列の索引の名前。名前が指定されている場合、インデックスが作成されます。
コレクションを作成する場合は、「作成」をクリックします。

コレクションを取り消す場合は、「取消」をクリックするか、[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つのモードを使用できます。

テキスト・モード

「問合せ」フィールドにフィルタ条件を入力します。たとえば、名前がSmithのドキュメントを選択するには、{"name":"Smith"}と入力して、「フィルタ」をクリックします。