Wallet と OCI を使用して Oracle データソースを作成する
Database Tools and SQL プラグインを有効化
この機能は、JetBrains Rider にデフォルトでバンドルされ有効化されている Database Tools and SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
インストール済み タブを開き、 Database Tools and SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。
公式ドキュメントとソフトウェア
Oracle の詳細については、 公式ドキュメントを参照してください。
Oracle データベースソフトウェアをダウンロードするには、 公式ソフトウェアのダウンロードを参照してください。
Oracle JDBC ドライバーの他のバージョンについては、 公式 JDBC ドライバーのダウンロードを参照してください。
オペレーティングシステム用の次の Oracle インスタントクライアント (OCI) パッケージを oracle.com の Oracle インスタントクライアントダウンロードページ(英語)からダウンロードします。
ベーシックパッケージ
SQL*Plus パッケージ
JDBC サプリメントパッケージ
Oracle データベース 12.2.0.1 JDBC ドライバー &UCP Downloads page（oracle.com）(英語)から oraclepki.jar をダウンロードします。
ウォレットファイルを含む ZIP アーカイブを準備します。 ウォレットのダウンロードの詳細については、 docs.oracle.com の「クライアント資格証明 (ウォレット) のダウンロード」(英語)を参照してください。
JetBrains Rider は JDBC ドライバーを使用して、TNS プロトコル経由で Oracle サーバーに接続します。 次のドライバーモードが利用可能です。
Thin モードでは、JDBC ドライバーは常に TNS リスナーに接続します。 このモードでは、さまざまなバージョンの JDBC ドライバーを使用できます。
OCI モードでは、JDBC ドライバーはネイティブライブラリを使用します。 この場合、JDBC ドライバーのバージョンは、これらのネイティブライブラリのバージョンと同じである必要があります。
Oracle Walletは、証明書、証明書リクエスト、プライベートキーなどのすべてのユーザー資格情報を保存するファイルセットです。 Oracle ツールを使用してウォレットを作成するか、Oracle サーバー管理者にウォレットを生成するよう依頼できます。 ウォレットの詳細については、 Oracle Wallet の作成と管理を参照してください。
要件
ユーザーのアクセス権限で Oracle Cloud インスタンスを実行します。
Oracle ウォレット。
Oracle Cloud データソースの作成
ディレクトリの例として、このチュートリアルでは次のものを使用します：
ダウンロードされたパッケージは ~/Oracle/instantclient_19_8/ に抽出されます。
oraclepki.jar は ~/Oracle/instantclient_19_8/ に格納されます。
ウォレットファイルは ~/Oracle/instantclient_19_8/network/wallet に保存され、構成された tnsnames.ora および sqlnet.ora のものが含まれます。
ステップ 1. OCI 接続用のドライバーを準備する
次のいずれかの方法でデータソースのプロパティを開きます。
データベース ツールウィンドウのツールバーで、
データソース をクリックします。Shift+Enter を押します。
データソースおよびドライバー ダイアログで、 ドライバー タブをクリックします。
ドライバーのリストで、 %oracle% ドライバーを右クリックし、 複製 を選択します。
複製された %oracle% ドライバーの名前を変更します (たとえば、
%oracle% [Cloud, OCI])。ドライバーファイル ペインで、 追加 アイコン（
）をクリックし、 ネイティブライブラリのパス… を選択します。ファイルブラウザーで、Instant Client ファイルのディレクトリ (このチュートリアルでは ~/Oracle/instantclient_19_8 ) に移動し、 オープン をクリックします。
JetBrains Rider が提供するドライバー、または Instant Client で提供されるドライバーを使用できます。
ファイルのバージョンを変更して、Instant Client のバージョンと同じになるようにします。
ドライバーファイル ペインで、 追加 アイコン（
）をクリックし、 カスタムJAR… を選択します。ファイルブラウザーで、Instant Client ファイル (このチュートリアルでは ~/Oracle/instantclient_19_8 ) があるディレクトリに移動します。
ディレクトリで、次のファイルを選択します: ojdbc8.jar 、 orai18n.jar 、 oraclepki.jar 。
オープン をクリックします。
ステップ 2. Oracle クラウドデータソースを作成する
データベースに接続するには、接続の詳細を保存するデータソースを作成します。
データベース ツールウィンドウで、
新規 をクリックし、 データベースに接続する を選択します。ソリューションまたはその他の場所でデータベースの接続文字列が定義されている場合は、 接続文字列を使用する オプションを選択したままにし、 データベースタイプ セレクターで %oracle% を選択します。
文字列 セレクターを使用して、ソリューションから目的の接続文字列を選択するか、手動で入力して、 接続 をクリックします。
データソースを手動で追加する を選択し、 次へ をクリックして、 データベースソース セレクターで %oracle% を選択することもできます。 ウィザードの手順に従って、個々のオプションを構成して接続文字列を形成します。
新しいデータベース接続で使用可能なすべてのオプションにアクセスするには、 データベース ウィンドウで
をクリックし、次に 新規 をクリックして、 %oracle% を選択します。接続タイプ リストから TNS を選択してください。
ドライバー リストから OCI を選択してください。
ドライバー リンクをクリックし、 ステップ 1 で作成したドライバーエントリ (この場合は %oracle% [Cloud, OCI]) を選択します。
「TNSADMIN 」フィールドで参照ボタンをクリックし、インスタントクライアントファイル (この場合は ~/Oracle/instantclient_19_8/network/admin ) のあるディレクトリに移動します。
TNS 名 フィールドでは、自動補完 (Ctrl+Space) を使用して、使用するサービス名を選択します ( tnsnames.ora ウォレットファイルのエイリアスの値を参照)。
Oracle ユーザーの資格情報を指定します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのスキーマのみがイントロスペクトされ、使用可能になります。 他のスキーマも操作したい場合は、「スキーマ 」タブで、イントロスペクションの対象として選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
