IntelliJからOracle NoSQL Databaseへの接続

IntelliJプラグインを使用してNoSQLプロジェクトをOracle NoSQL Databaseデータ・ストアに接続する方法について学習します。

前提条件:

Oracle NoSQL Databaseデータ・ストアへの正常な接続を作成するには、次のことを確認してください:

データ・ストアがデプロイされ実行されていること。
Oracle NoSQL Databaseプロキシが起動していること。プロキシの構成を参照してください。リリース19.5以降、プロキシはOracle NoSQL Databaseダウンロード・パッケージにバンドルされています。

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

IntelliJでNoSQLプロジェクトを開きます。
「Schema Explorer」ウィンドウでタスク・アイコンをクリックし、プラグインの「Settings」ダイアログを開きます。
「Settings Explorer」で「Tools」→「Oracle NoSQL」を展開し、「Connections」をクリックします。「Connections」ドロップダウンで、オンプレミス・プロファイル・タイプの既存のすべての接続を表示できます。
プロファイル・タイプのドロップダウン・メニューから「Onprem」を選択します。

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

表1-1 接続パラメータ

パラメータ	説明
Connection Name	プラグイン・バージョン1.5.1では、特定の接続仕様に指定された一意の名前が必須です。バージョン1.4.0以下からプラグインをアップグレードした後に、「Connection Name」フィールドを更新することをお薦めします。ノート: 複数の接続を追加でき、格納されている接続仕様は永続的です。
Proxy URL	`http://<proxy_host>:<proxy_http_port>`または`https://<proxy_host>:<proxy_http_port>`。各項目の意味は、次のとおりです。 `http`または`https`は、ストアのセキュリティを示します。セキュアなデータ・ストアの場合、プロキシURLは`https`で始まります。 `proxy_host`は、プロキシ・サービスをホストするマシンのホスト名です。これは、以前に構成したホストと一致している必要があります。プロキシの構成を参照してください。
SDK Path	Oracle NoSQL Java SDKを抽出したディレクトリの完全パス。たとえば、`D:\oracle-nosql-java-sdk-5.4.14\oracle-nosql-java-sdk`です
Namespace	ネームスペースの名前を指定します。これはオプションです。値が指定されていない場合は、デフォルトのネームスペース`sysdefault`が使用されます。ノート: 1つ以上のネームスペースをストアに追加したり、ストア内に表を作成したり、ユーザーにネームスペースや表にアクセスする権限を付与できます。
Security	セキュアなデータ・ストアの場合は、「SSL」を選択します。非セキュアなKVStoreへの接続を作成する場合は、「None」を選択します。デフォルト値は「SSL」です。ノート: セキュアなデータ・ストアの場合、プロキシURLは`https`で始まる必要があります。
Username	セキュアなストアに接続するためのユーザー名。この値は、「Security」パラメータで「SSL」を選択した場合にのみ必要です。
Password	セキュアなストアに接続するためのパスワード。この値は、「Security」パラメータで`「SSL」`を選択した場合にのみ必要です。
TrustStore	証明書信頼ファイルが配置されている場所を参照します。「セキュアなデータ・ストアでのプロキシの使用」を参照してください。
Passphrase	パスフレーズの値を指定します。パスフレーズは、暗号化キーを保護するために使用されるシークレットを指します。これはオプションです。

ノート:

バージョン1.4.0以前からプラグインを更新する場合、格納されているすべての接続は新しいバージョンに移行されます。この場合、接続名はプロキシURLと同じになります。接続名を変更するには、次のステップに従います。

IntelliJプラグインは、指定された接続名に接続の詳細を保存します。接続の詳細を変更するには、「Connections」のドロップダウンで接続名を選択します。「Modify Connection」をクリックします。接続パラメータ(前述)のいずれかを変更し、「OK」をクリックして設定を保存できます。プラグインから接続名を削除するには、接続名を選択して「Delete Connection」をクリックします。削除するアクションを確認すると、接続名がプラグインから削除されます。
スキーマ・エクスプローラでWebアイコンをクリックします。既存の接続のリストがドロップダウン・ボックスに表示されます。接続は、NoSQLツール・ウィンドウにConnection Name:Proxy URL:Namespace (指定されている場合)の形式で表示されます。接続を選択し、「OK」をクリックします。Intellijプラグインにより、プロジェクトがOracle NoSQL Database KVStoreに接続され、「Schema Explorer」ウィンドウにそのスキーマが表示されます。
スキーマ・エクスプローラで「Database」アイコンをクリックします。新しいウィンドウで計算ツールが開きます。このツールを使用すると、指定した入力に基づいてoptimalJEキャッシュ・サイズ、ストレージ・サイズおよび必要なシャードの数を計算できます。まず、表ID (その表を識別する一意の整数)、主キー・サイズ、行サイズ、行数、および索引のサイズ(オプション)を入力し、「Add Table」をクリックします。その後、追加した表を選択し、「CALCULATE」をクリックすると、JEキャッシュ・サイズ(GB)、シャードの数、およびストレージ・サイズ(TB)を表示できます。

プロジェクトがOracle NoSQL Databaseデータ・ストアに正常に接続された後、スキーマ内の表およびデータを管理できるようになります。