開発のためのIntelliJプラグインの使用

IntelliJのOracle NoSQL Database Cloud Serviceインスタンスまたはシミュレータで表を参照し、問合せを実行します。

Oracle NoSQL Database Cloud Service IntelliJプラグインはOracle NoSQL Database Cloud Serviceまたはシミュレータの実行中インスタンスに接続し、次のことを可能にします:

表エクスプローラを使用して、適切な定義のツリー構造で表を表示します。
表の列、索引、主キーおよびシャード・キーに関する情報を表示します。
列データを適切な形式のJSON構造で表示します。
フォームによるスキーマ入力を使用して表を作成するか、DDL文を指定します。
表の削除
フォームベースのエントリを使用して新しい列を追加するか、DDL文を指定します。
列の削除
索引の作成
索引の削除
表に対してSELECT SQL問合せを実行し、問合せ結果を表形式で表示します。
DML文を実行して、表のデータを更新、挿入および削除します。

この記事には次のトピックが含まれます:

IntelliJプラグインの設定

Oracle NoSQL Database Cloud Serviceインスタンスまたはシミュレータに対してIntelliJプラグインを設定する方法について学習します。

前提条件として、まずIntelliJ IDEAをインストールする必要があります。IntelliJ IDEAは、JetBrainsからダウンロードできます。

次のいずれかのオプションを使用してプラグインをインストールできます。

オプション1: JetBrainsプラグイン・リポジトリでOracle NoSQL Database Cloud Serviceコネクタを検索してインストールするか、インストールします。
オプション2: Oracle Technology Networkからインストールします。
ノート:
最新バージョンは、Oracle Technology Networkからダウンロードできます。
1. Oracle Technology NetworkからIntelliJプラグインをダウンロードします。ファイルを展開しないでください。
2. IntelliJ IDEAを起動し、「ファイル」→「設定」→「プラグイン」にナビゲートします。メイン・メニュー・バーの右上隅にある「IDEおよびプロジェクト設定」アイコンを選択して、設定にアクセスすることもできます。
3. 右上にある「リポジトリの管理」、「プロキシの構成」または「ディスクからのプラグインのインストール」アイコンを選択し、「ディスクからのプラグインのインストール」を選択します。
4. ダウンロードしたプラグインzipファイルを選択します。

IDE を再起動します。右側のパネルに「スキーマ・エクスプローラ」アイコンが表示されます。

IntelliJプラグインを正常に設定した後、NoSQLプロジェクトを作成し、それをOracle NoSQL Database Cloud Serviceインスタンスまたはシミュレータに接続します。

IntelliJでのNoSQLプロジェクトの作成

IntelliJでNoSQLプロジェクトを作成する方法について学習します。

次のステップを実行します:

IntelliJ IDEAを開きます。「File」→「New」→「Project」をクリックします。
「プロジェクト名」および「プロジェクトの場所」の値を入力します。「作成」を選択します。
ビルド・システムとJDKパスを選択します。
IntelliJは、サンプルJavaファイルを含むNoSQLプロジェクト・ディレクトリを作成します。ビルド・システムとしてMavenを選択した場合、プロジェクト・ディレクトリにはpom.xmlファイルも含まれます。
Oracle NoSQLプロジェクトでNotificationsが有効になっていることを確認します。通知を有効にするには、Alt+\を押してメイン・メニューを開きます。「表示」をクリックし、「ツールWindows」→「通知」を展開します。右側のツール・ウィンドウ・バーに「通知」アイコンが表示されます。

IntelliJでNoSQLプロジェクトが正常に作成した後、プロジェクトはOracle NoSQL Database Cloud Serviceまたはシミュレータに接続できます。

IntelliJからOracle NoSQL Database Cloud Serviceへの接続

IntelliJプラグインを使用したNoSQLプロジェクトのOracle NoSQL Database Cloud Serviceへの接続方法について学習します

次のステップを実行します:

IntelliJでNoSQLプロジェクトを開きます。
「スキーマ・エクスプローラ」ウィンドウでタスク・アイコンをクリックして、プラグインの「設定」ダイアログを開きます。
「設定エクスプローラ」で「ツール」→「Oracle NoSQL」を展開し、「接続」をクリックします。
プロファイル・タイプのドロップダウン・メニューから「Cloud」を選択します。「接続」ドロップダウンで、クラウド・プロファイル・タイプの既存のすべての接続を表示できます。

「Add Connection」をクリックします。接続を作成するための2つのオプションがあります。

構成ファイルの使用: 構成ファイル・パスを指定します。このパスは、ローカル・システムに格納されているOCI構成ファイルの場所を指します。このファイルには、リージョン、テナントID、ユーザーID、フィンガープリント、パスフレーズ、秘密キー・パスなど、Oracle NoSQL Database Cloud Serviceへの接続に必要な必須パラメータが含まれています。

次の接続パラメータに必要な値を入力し、「追加」を選択します。次に、「OK」を選択します。

表- 接続パラメータ構成ファイル・オプション

パラメータ	説明	サンプル値
接続名	プラグインバージョン1.5.1では、特定の接続仕様に指定された一意の名前が必須です。バージョン1.4.0以下からプラグインをアップグレードした後、「接続名」フィールドを更新することをお薦めします。ノート: 複数の接続を追加でき、格納されている接続仕様は永続的です。	`ndcs_con1`
構成ファイル	構成ファイルがローカル・システムに格納されるディレクトリのパス。構成ファイルとその内容の詳細は、Oracle NoSQL Databaseに接続するための認証のユーザー・プリンシパル・メソッドを参照してください。	`~/.oci/config`
プロファイル	プロファイルの名前。ノート: これらのエントリに対して様々な値の複数のプロファイルを作成し、ロードするプロファイルを指定できます。	`DEFAULT`
区分(オプション)	NoSQLデータベース・スキーマのコンパートメントOCID/コンパートメント名。ノート: コンパートメント名を指定する場合は、各エントリをコロンで区切って階層全体を指定する必要があります。	`developers:dev1`. ここで、`dev1`はコンパートメント`developers.`の下のコンパートメントですノート: 値が指定されていない場合、デフォルトでルート・コンパートメントが使用されます。

プラグインは、構成ファイルで指定されたリージョンに接続します。

セッション・トークンベースの認証を使用する場合、構成ファイルには、トークン・パスとともにセッション・トークンの指定されたプロファイルが含まれます。Oracle NoSQL Database Cloud Serviceに接続するには、構成ファイル・オプションを選択し、適切なプロファイルを指定する必要があります。

拡張: Oracle NoSQL Database Cloud Serviceへの接続に必要な接続パラメータを直接指定します。次のパラメータに必要な値を入力し、「追加」を選択します。次に、「OK」を選択します。

表- 接続パラメータ拡張オプション

パラメータ	説明	サンプル値
接続名	プラグイン・バージョン1.5.1では、特定の接続仕様に指定された一意の名前が必須です。バージョン1.4.0以下からプラグインをアップグレードした後に、「Connection Name」フィールドを更新することをお薦めします。ノート: 複数の接続を追加でき、格納されている接続仕様は永続的です。	`ndcs_con1`
エンド・ポイント	Oracle NoSQL Database Cloud Serviceへのアクセス・ポイント。	`https://nosql.us-ashburn-1.oci.oraclecloud.com` (北米リージョンにあるアッシュバーンのOracle NoSQL Database Cloud Serviceリージョン識別子の場合)。サービス・エンドポイントのリストは、データ・リージョンおよび関連するサービス・エンドポイントを参照してください。
テナントIDとユーザーID	Oracle NoSQL Database Cloud ServiceのテナントOCIDおよびユーザーのOCID。	Oracle Cloud InfrastructureドキュメントのテナンシのOCIDとユーザーのOCIDの取得場所を参照してください。
フィンガープリントとパスフレーズ(オプション)	API署名キーの生成およびアップロード中に作成された署名キーの指紋およびパスフレーズ。	Oracle Cloud Infrastructureドキュメントの次のリソースを参照してください: API署名キーの生成方法: オプションのパスフレーズを使用して署名キーを生成します。キーの指紋の取得方法を参照
秘密キー	ユーザーに対して生成された秘密キー。	アプリケーション・ユーザーに対して、API署名キーを生成し、アップロードする必要があります。オプションのパスフレーズを使用して署名キーを生成するには、API署名キーの生成方法を参照してください。
コンパートメント(オプション)	NoSQLデータベース・スキーマのコンパートメントOCID/コンパートメント名。ノート: コンパートメント名を指定する場合は、各エントリをコロンで区切って階層全体を指定する必要があります。	`developers:dev1`. ここで、`dev1`はコンパートメント`developers.`の下のコンパートメントですノート: 値が指定されていない場合、デフォルトでルート・コンパートメントが使用されます。

ノート:

バージョン1.5.4以降、IntelliJプラグインは、最新のOracle NoSQL Java SDKを自動的にダウンロードし、接続の作成時にSDKパスを設定します。
バージョン1.4.0以前からプラグインを更新する場合、格納されているすべての接続は新しいバージョンに移行します。この場合、接続名はエンドポイントと同じになります。接続名を変更するには、次のステップに従います。

IntelliJプラグインは、指定された接続名に接続の詳細を保存します。接続の詳細を変更するには、「接続」のドロップダウンで接続名を選択します。「接続の変更」をクリックします。任意の接続パラメータ(前述)を変更し、「OK」をクリックして設定を保存できます。プラグインから接続名を削除するには、接続名を選択して「接続の削除」をクリックします。削除するアクションを確認すると、接続名がプラグインから削除されます。

スキーマ・エクスプローラでWebアイコンをクリックします。既存の接続のリストが、ドロップダウン・ボックスに表示されます。接続名は、NoSQLツール・ウィンドウに次の形式で表示されます:

表- 接続表示

接続の作成に使用するオプション	NoSQLツール・ウィンドウに表示
`Advanced`	`Connection Name:Endpoint:Compartment Name/OCID` (root以外の場合)
`Use Configuration File`	`Connection Name:Configuration file path:Profile:Compartment Name/OCID`(root以外の場合)

接続を選択し、「OK」をクリックします。IntelliJプラグインにより、プロジェクトがOracle NoSQL Database Cloud Serviceに接続され、そのスキーマが「スキーマ・エクスプローラ」ウィンドウに表示されます。

プロジェクトを正常にOracle NoSQL Database Cloud Serviceに接続すると、スキーマ内の表およびデータを管理できます。

IntelliJからOracle NoSQL Database Cloudシミュレータへの接続

IntelliJプラグインを使用してNoSQLプロジェクトをOracle NoSQL Database Cloudシミュレータに接続する方法について学習します。

次のステップを実行します:

Oracle NoSQL Database Cloudシミュレータをダウンロードして起動します。Oracle NoSQL Database Cloudシミュレータのダウンロードを参照してください。
IntelliJでNoSQLプロジェクトを開きます。
「スキーマ・エクスプローラ」ウィンドウでタスク・アイコンをクリックして、プラグインの「設定」ダイアログを開きます。
「Settings Explorer」で「Tools」→「Oracle NoSQL」を展開し、「Connections」をクリックします。Cloudsimプロファイル・タイプの既存の接続はすべて、「接続」ドロップダウンで表示できます。
プロファイル・タイプのドロップダウン・メニューから「Cloudsim」を選択します。

「接続の追加」をクリックします。次の接続パラメータの値を入力し、「OK」をクリックします。

表- 接続パラメータ

パラメータ	説明	サンプル値
接続名	特定の接続仕様に指定された一意の名前は、プラグインバージョン1.5.1から必須です。バージョン1.4.0以下からプラグインをアップグレードした後、「接続名」フィールドを更新することをお薦めします。ノート: 複数の接続を追加でき、格納されている接続仕様は永続的です。	`nosql_sim1`
サービスURL	Oracle NoSQL Database Cloudシミュレータが実行されているIPアドレスおよびポート。	デフォルト値は`http://localhost:8080` です
テナント識別子	テナントを識別する一意の識別子。	デフォルト値はexampleIdです。例をテストする場合は、この値を保持します。

ノート:

バージョン1.5.4以降、IntelliJプラグインは、最新のNoSQL Java SDKを自動的にダウンロードし、接続の作成時にSDKパスを設定します。
バージョン1.4.0以前からプラグインを更新する場合、格納されているすべての接続は新しいバージョンに移行します。この場合、接続名はエンドポイントと同じになります。接続名を変更するには、次のステップに従います。

IntelliJプラグインは、指定された接続名に接続の詳細を保存します。接続の詳細を変更するには、「接続」のドロップダウンで接続名を選択します。「接続の変更」をクリックします。任意の接続パラメータ(前述)を変更し、「OK」をクリックして設定を保存できます。プラグインから接続名を削除するには、接続名を選択して「接続の削除」をクリックします。削除するアクションを確認すると、接続名がプラグインから削除されます。
スキーマ・エクスプローラでWebアイコンをクリックします。既存の接続のリストが、ドロップダウン・ボックスに表示されます。接続名は、NoSQLツール・ウィンドウに次の形式で表示されます:
```
Connection Name:service Url : Tenant Identifier
```
接続を選択し、「OK」をクリックします。IntelliJプラグインでは、プロジェクトをOracle NoSQL Database Cloud Simulatorに接続し、そのスキーマを「スキーマ・エクスプローラ」ウィンドウに表示します。

ノート:
プロジェクトをOracle NoSQL Database Cloudシミュレータに接続する前に、プロジェクトを起動して実行する必要があります。そうしないと、IntelliJで接続リクエストが失敗します。

プロジェクトを正常にOracle NoSQL Database Cloudシミュレータに接続すると、スキーマ内の表およびデータを管理できます。

Oracle NoSQL Java SDKを使用したIntelliJからのアプリケーションの作成

Oracle NoSQL Java SDKパッケージを使用して、IntelliJプラグインからアプリケーションを作成する方法について学習します。

Oracle NoSQL Database Cloud SimulatorまたはOracle NoSQL Database Cloud Serviceに接続したら、Oracle NoSQL Java SDKを使用してアプリケーションを作成できます。

このトピックでは、Oracle NoSQL Java SDKパッケージ内で使用可能なサンプル・アプリケーションを実行して、Oracle NoSQL Database Cloud SimulatorまたはOracle NoSQL Database Cloud Serviceに表を作成します。

次のステップを実行します:

最新のOracle NoSQL Database Java SDKをGitHubからダウンロードします。
ダウンロードしたファイルをローカル・リポジトリに抽出(解凍)します。
IntelliJ IDEAを起動し、NoSQLプロジェクトを開きます。
Mavenビルド・システムを使用している場合は、pom.xmlで必要な依存関係が追加されていることを確認します。詳細は、Oracle NoSQL Java SDK GitHubを参照してください。
抽出されたOracle NoSQL Database Cloud Service Java SDKディレクトリから、oracle-nosql-java-sdk > examplesフォルダに移動します。BasicTableExampleおよびCommon javaファイルをNoSQLプロジェクト・ディレクトリにコピーします。
BasicExampleTableプログラムでは、audienceDataという表を作成し、この表に2つの行を追加し、挿入された行を問い合せ、挿入された行を削除して、最後にaudienceData表を削除していることがわかる。

アプリケーション・プログラムを実行する前に、接続に必要な引数を指定する必要があります。

メニューから、「実行」→「構成の編集」を選択します。
「新規構成の追加」を選択し、「アプリケーション」を選択します。
右側に表示されるウィンドウで、「名前」フィールドにメイン・クラスを入力します。
「ビルドおよび実行」で、Java JDKパスを指定し、メイン・クラスを入力します。
必要なプログラム引数を入力します。「適用」を選択し、「正常」を選択します。

表- プログラム引数

接続タイプ	プログラム引数	その他の情報入手先
クラウドシム	`http://localhost:8080`	別のポートでOracle NoSQL Database Cloud Simulatorを起動した場合は、8080をそのポート番号に置換する必要があります。
クラウド	`Region [-configFile <path-to-config-file]` たとえば: `us-ashburn-1 -configFile D:\OCI_PROP\config`	第1引数は、Oracle NoSQL Database Cloud Serviceのデータ・リージョンを示します。第2引数は、Oracle NoSQL Database Cloud Serviceに接続するための資格証明が含まれる構成ファイルを渡します。構成ファイルの内容の詳細は、Oracle NoSQL Databaseに接続するための認証を参照してください。 `config`ファイルを指定しない場合、スクリプトでは`SignatureProvider`クラスのデフォルト・コンストラクタが使用され、次の場所で`config`ファイルが検索されます。 `$HOME/.oci`

このプログラムを実行するには、「実行」を選択するか、[Shift] + 10を押します。
ノート:

端末からプログラムを実行する場合は、次のサンプル・コマンドを使用します。
次を使用して、mavenビルド・システムを使用してプログラムをコンパイルします。
```
mvn compile
```
プログラムの引数を指定して、プログラムを実行します。
```
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="<region>"
```
例: mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="us-ashburn-1"

下部の「ツールの実行」ウィンドウに出力を表示します。ログを確認して、コードの実行が成功したことを確認します。表の作成、行の挿入などを示す表示メッセージを確認できます。

サンプル出力:

Creating table audienceData
Created table audienceData
Put row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}} result=non-null Version
Got row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}}
Inserted row via query, result:
    {"NumRowsInserted":1}
Got row inserted by query: {"cookie_id":106,"audience_data":{"audience_segment":{"foodie":"2020-06-01","sports_lover":"2020-05-10"},"ipaddr":"10.0.00.xxx"}}
Put row from json: {"cookie_id":456,"audience_data":{"ipaddr":"10.0.00.yyy","audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"}}}
Got row inserted as JSON: {"cookie_id":456,"audience_data":{"audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"},"ipaddr":"10.0.00.yyy"}}
Query results for SELECT * from audienceData WHERE cookie_id = 456: 
    {"cookie_id":456,"audience_data":{"audience_segment":{"foodie":"2018-12-31","sports_lover":"2019-01-05"},"ipaddr":"10.0.00.yyy"}}
Deleted key {"cookie_id":456} result=true
Dropping table audienceData

Process finished with exit code 0

ノート:

BasicExampleTableによって、挿入された行が削除され、audienceData表を削除されるため、この表をスキーマ・エクスプローラで表示することはできません。スキーマ・エクスプローラで表を表示する場合は、挿入された行を削除して表を削除するコードをコメント化してから、プログラムを再実行します。

IntelliJプラグインを使用した表の管理

スキーマ・エクスプローラからOracle NoSQL Database Cloud ServiceまたはOracle NoSQL Database Cloud Simulatorで表を作成し、表データを表示する方法について学習します。

次のステップを実行します:

スキーマ・エクスプローラを探し、アイコンをクリックしてスキーマをリロードします。
テナント識別子の下で表を見つけて展開し、その列、主キーおよびシャード・キーの詳細を表示します。「IntelliJからのOracle NoSQL Java SDKを使用したアプリケーションの作成」のトピックの説明に従ってサンプル・アプリケーションを作成した場合は、audienceData表を参照できます。
データを表示するには、表名をダブルクリックします。または、表を右クリックして「Browse Table」を選択します。
メイン・エディタにレコード・ビューア・ウィンドウが表示されます。「実行」をクリックして問合せを実行し、表データを表示します。
個々のセル・データを個別に表示するには、セルをダブルクリックします。

IntelliJを使用したDDL操作の実行

IntelliJを使用してDDL操作を実行できます。

IntelliJプラグイン内から実行できるDDL操作の一部を次に示します。

CREATE TABLE
DROP TABLE
CREATE INDEX
DROP INDEX
列の追加
列の削除
スキーマの凍結/解凍
リージョン・レプリカの管理
予約済容量の編集

CREATE TABLE

スキーマ・エクスプローラを探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
接続名を右クリックし、「表の作成」を選択します。
プロンプトで、新しい表の詳細を入力します。Oracle NoSQL Database表は、次の2つのモードで作成できます。
- **シンプルなDDL入力** : このモードを使用すると、表を宣言的に、つまりDDL文を記述せずに作成できます。
- **拡張DDL入力** : このモードを使用すると、DDL文を使用して表を作成できます。
作成前にDDL文を表示するオプションがあります。「Show DDL」をクリックすると、単純DDL入力モードのフィールドに入力された値に基づいて形成されたDDL文が表示されます。「Create」をクリックすると、このDDL文が実行されます。
「作成」をクリックして、表を作成します。
子表を作成するには、目的の表を右クリックし、「子表の作成」を選択します。子表は、次の2つのモードで作成できます。
- **単純なDDL入力**: このモードを使用して、他の必要な詳細とともに表名を入力するだけで子表を作成できます。
- **拡張DDL入力**: このモードを使用すると、DDL文を使用して子表を作成できます。
子表の詳細は、Oracle NoSQL Database Cloud Serviceガイドの表階層を参照してください。
「作成」をクリックして、子表を作成します。
表の作成後にDDL文を表示するオプションがあります。既存の表を右クリックします。「表DDLの表示」を選択します。DDL文をコピーするには、「クリップボードにコピー」をクリックします。「OK」をクリックしてダイアログ・ボックスを閉じます。

DROP TABLE

「Schema Explorer」を探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
削除する表を右クリックします。「テーブルの削除」を選択します。
確認ウィンドウが表示され、「Ok」をクリックして削除アクションを確定します。

CREATE INDEX

「Schema Explorer」を探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
索引を作成する表を右クリックします。「索引の作成」を選択します。
「索引の作成」パネルには、2つのモードで索引を作成するオプションがあります。
- **フォーム・ベースの索引作成(単純なDDL入力)** : DDL文を記述せずに索引を作成するための詳細を入力します。索引の名前および索引に含める列を指定します。列がJSONデータ型の場合は、JSON Path to Index Fieldという追加フィールドが表示されます。JSONフィールドの場所へのパスを入力し、そのデータ型を選択します。
- **索引をDDL文として作成(拡張DDL入力の場合)**: 索引を作成する有効なDDL文を入力します。複合データ型(配列、マップおよびレコード)を含めることもできます。
「索引の追加」をクリックします。

DROP INDEX

「Schema Explorer」を探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
リストされた列、主キー、索引およびシャード・キーを表示するには、ターゲット表をクリックします。
削除する必要があるtarget-indexを見つけて右クリックします。「索引の削除」をクリックします。
確認ウィンドウが表示され、「Ok」をクリックして削除アクションを確定します。

列の追加

「Schema Explorer」を探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
列を追加する必要がある表を右クリックします。「列の追加」を選択します。
新しいCOLUMNは、次の2つのモードで追加できます。
- シンプルなDDL入力: このモードを使用すると、DDL文を記述せずに新しい列を追加できます。バイナリまたは固定バイナリの場合は、データ型をBinaryとして選択します。固定バイナリの場合は、Sizeフィールドにファイルのサイズを入力し、バイナリ・データ型の場合はフィールドをnullのままにします。
- 拡張DDL入力: このモードを使用すると、有効なDDL文を指定して表に新しい列を追加できます。このモードでは、複合データ型の列を作成することもできます。たとえば、配列、マップ、レコード、およびネストされた形式です。
両方のモードで、列の名前を指定し、そのプロパティ(データ型、デフォルト値およびNULL値可能かどうか)を使用して列を定義します。
「列の追加」をクリックします。

列の削除

「Schema Explorer」を探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
リストされた列、主キー、索引およびシャード・キーを表示するには、ターゲット表をクリックします。
削除する必要があるターゲット列を見つけて右クリックします。「削除」をクリックします。
確認ウィンドウが表示され、「Ok」をクリックして削除アクションを確定します。

Freeze/UnFreezeスキーマ

グローバル・アクティブ表にする前に、シングルトン表のスキーマを凍結する必要があります。表のスキーマを凍結すると、スキーマを変更できなくなります。シングルトン表のスキーマを凍結するには、少なくとも1つのJSON列が必要です。表を右クリックし、「凍結/凍結解除」を選択します。確認すると、表のスキーマが凍結されます。同様に、表のスキーマを凍結解除するには、表を右クリックして「凍結/凍結解除」を選択します。確認すると、表のスキーマが可変に変更され、スキーマが変更可能になります。

ノート:

凍結解除操作を実行するには、表のリージョナル・レプリカを削除する必要があります(表はシングルトン表である必要があります)。

レプリカの管理

レプリカとは何か、およびリージョナル・レプリカを追加してシングルトン表をグローバル・アクティブ表に変換する方法を理解するには、リージョナル表レプリカを参照してください。

レプリカの追加

リージョナルレプリカをシングルトンテーブルに追加して、それをグローバルアクティブテーブルにしたり、既存のグローバルアクティブテーブルにレプリカを追加したりできます。レプリカを追加する前に、表を凍結する必要があります。表を右クリックし、「リージョナル・レプリカ」から「レプリカの追加」を選択します。「レプリケーション」リージョンのドロップダウンからレプリカを選択できます。そのレプリケーション・リージョンの表の読取りユニットおよび書込みユニットを決定できます。表のディスク・ストレージ値は、レプリカで変更/編集できません。「レプリカの追加」をクリックします。表がリージョンにレプリケートされます。

レプリカの表示

表を右クリックし、「リージョナル・レプリカ」から「レプリカの表示」を選択します。表のレプリカのリストを表示できます。

レプリカの削除

表を右クリックし、「リージョナル・レプリカ」から「レプリカの削除」を選択します。「追加」をクリックし、削除するレプリカを選択します。一度に削除するレプリカを複数選択できます。削除する必要があるレプリカのリストからレプリカを削除する場合は、「削除」をクリックします。「レプリカの削除」をクリックします。確認すると、選択したすべてのレプリカから表が削除されます。

予約済容量の編集

表の予約済容量および使用モデルを編集できます。表を右クリックし、「予約済容量の編集」を選択します。プロビジョニング済容量またはオンデマンド容量の2つの容量モードのいずれかを選択できます。値を編集し、「変更の適用」をクリックします。

編集される表がグローバル・アクティブ表の場合:

ストレージ容量の変更にはグローバル・スコープがあります(1つのリージョナル表レプリカでの変更は、すべてのリージョナル表レプリカに自動的に伝播されます)。
読取りユニット、書込みユニットの変更、または容量モードのオンデマンドからプロビジョニングへの変更、またはその逆にはローカル・スコープがあります(開始されたリージョン表レプリカでのみ変更)。

IntelliJを使用したDML操作の実行

IntelliJプラグインを使用して、表からデータの追加、既存データの変更およびデータの問合せを実行できます。

データを挿入

スキーマ・エクスプローラを探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
行を挿入する必要がある表を右クリックします。「行を挿入」を選択します。
「挿入行」パネルで、新しい行を挿入するための詳細を入力します。新しいROWを2つのモードで挿入できます。
- シンプルな入力: このモードを使用すると、DML文を記述せずに新しい行を挿入できます。ここでは、フォーム・ベースの行フィールドのエントリがロードされ、行のすべてのフィールドの値を入力できます。
  - バイナリ・データ型の場合、入力する文字列は、バイナリ値の有効なBase64エンコーディングであるか、目的の列にアップロードするファイルを選択する必要があります。
  - 固定バイナリ・データ型の場合、入力される文字列は、バイナリ値の有効なBase64エンコーディングであるか、特定の列の作成時に定義されたサイズのファイルをアップロードする必要があります。
  ノート:
  バイナリ・データ型用にアップロードするファイル形式には、.bin拡張子のみが必要です。
- 拡張JSON入力: このモードを使用すると、列名と対応する値をキーと値のペアとして含むJSONオブジェクトを指定することで、新しい行を表に挿入できます。入力は、複合データ型(配列、マップ、レコード)でもかまいません。
「行を挿入」をクリックします。

データの変更- UPDATE ROW/DELETE ROW

スキーマ・エクスプローラを探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
行を挿入する必要がある表を右クリックします。「Browse Table」を選択します。
左側のテキストボックスに、表からデータをフェッチするSQL文を入力します。「実行」をクリックして文を実行します。
個々のセルのデータを個別に表示するには、表のセルをクリックします。
「更新行」や「削除行」などのDML操作を実行するには、特定の行を右クリックします。表示されたコンテキストメニューからオプションを選択します。
- 「Delete Row」: 確認ウィンドウが表示され、「Ok」をクリックして行を削除します。
- 行の更新: 別のHTMLウィンドウが開き、列名と対応する値が表示されます。行データの新しい値は、フォームベースの行フィールド・エントリ(簡易DDL入力)と行コンテンツをJSONオブジェクトとして提供(拡張DDL入力)の2つのモードで入力できます。拡張DDL入力モードでは、表示および更新を簡略化するためのツリー構造としてJSONデータが表示されます。
  
  「実行」を選択して、更新されたデータをリフレッシュして表示します。
  
  ノート:
  任意の行で、PRIMARY KEY列およびGENERATED ALWAYS AS IDENTITY列を更新することはできません。

問合せ表

スキーマ・エクスプローラを探し、「Refresh」アイコンをクリックしてスキーマをリロードします。
表を右クリックし、「Browse Table」を選択します。
左側のテキストボックスに、SELECT文を入力して表からデータをフェッチします。問合せの入力を開始すると、SQL文を自動補完する可能性のある単語のリストが表示されます。指定された表のすべてのSQLキーワードおよび列名が、SQL文を自動完了するためのプロンプトに表示されます。
SQL構文は、より優れたSQL書込みエクスペリエンスを提供するすべての問合せで強調表示されます。
読みやすくするために問合せを書式設定できます。問合せを選択し、右クリックして「Prettify」を選択します。クエリーがフォーマットされ、読みやすくするために行がラップされます。
「実行」をクリックして、問合せを実行します。対応するデータが表から取得されます。取得したデータをダブルクリックすると、列データが新しいウィンドウで開きます。JSONデータは、新しいウィンドウのツリー構造に表示されます。'+'をクリックして展開するか、'-'をクリックしてツリー構造を縮小します。新しいウィンドウで[Ctrl]+[^F]をクリックして、JSONツリー内の任意の値を検索できる検索オプションを有効にします。上矢印または下矢印をクリックして、それぞれ前または次の検索オカレンスに移動します。
任意の行を右クリックし、「JSONのダウンロード」をクリックします。ダイアログ・ボックスで、ファイルを保存する場所にナビゲートして、「保存」をクリックします。ファイルをダウンロードすると、画面の右下に通知が表示されます。リンクをクリックして、ダウンロードしたファイルを開きます。ファイルがブラウザに表示されます。
- バイナリ・データ型の場合は、出力で「バイナリ・オブジェクトのダウンロード」をクリックします。
「問合せ結果のダウンロード」をクリックして、問合せ結果のすべてのデータをダウンロードします。ダイアログ・ボックスで、ファイルを保存する場所にナビゲートして、「保存」をクリックします。複数の行の場合、画面右下に進行状況バーが表示され、リアルタイムでダウンロードされた行数が表示されます。ファイルをダウンロードすると、画面の右下に通知が表示されます。リンクをクリックして、ダウンロードしたファイルを開きます。ファイルがブラウザに表示されます。
「Show Query Plan」をクリックして、問合せの実行プランを表示します。
「Previous Commands」ドロップ・ダウンをクリックして、最近実行されて出力を提供したSQL文の上位20件を表示します。

ノート:
ドロップ・ダウンには、作業中の表に関連するSQL文のみが表示されます。

Schema Explorer

「Schema Explorer」ウィンドウで、特定の列の完全なデータ型を確認できます。特定の列を指定すると、データ型の後に列名が表示されます。

IntelliJプラグインの認可要件

IntelliJプラグインを使用するためにOracle NoSQL Database Cloud Serviceで必要な認可要件について学習します。

IntelliJプラグインを使用すると、APIキー認証方式またはセッション・トークン認証方式のいずれかを使用してOracle NoSQL Database Cloud Serviceにアクセスできます。表、表領域、APIなどのOracle NoSQL Database Cloud Serviceのリソースへのアクセスは、Identity and Access Management (IAM)ポリシーによって管理されます。これにより、特定のコンパートメント内の表権限を適切に検査、読取り、使用または管理するグループのメンバーである認証済ユーザーのみが、これらのリソースと対話できるようになります。詳細は、NDCS表へのアクセスの管理を参照してください

IntelliJプラグインを使用してOracle NoSQL Database Cloud Service表の表を管理する場合、有効なIAM権限によって、読取りまたは書込みが可能なリソースが決まります。ユーザーが認可がないアクションを試行すると、IntelliJプラグインは、OCI IAMで指定された対応する認可エラーを返します。

たとえば、ユーザー・グループにNoSQL表に対する読取り権限のみがある場合、OCI IAMはOracle NoSQL Database Cloud Service表に対する挿入操作を拒否します。IntelliJプラグインには、次のエラー・メッセージが表示されます。

Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)

タイトルおよび著作権情報

Oracle and/or its affiliates.