外部データベースへの接続の作成
このトピックでは、コンソールおよびAPIを使用した外部データベース接続の作成について説明します。外部データベース接続リソースを使用すると、OCIの外部にあるOracle Databaseインスタンスに外部データベース・ハンドルを接続できます。
現在、外部データベース・サービスでは、外部データベースへの接続を作成するためのManagement Agent Cloud Service (MACS)エージェントのみがサポートされています。Enterprise Manager Cloud Controlエージェントは現在サポートされていません。MACSの詳細は、管理エージェントを参照してください。
必要なIAMポリシー
Oracle Cloud Infrastructureを使用するには、管理者からポリシーでセキュリティ・アクセス権が付与されている必要があります。コンソールまたは(SDK、CLIまたはその他のツールを使用した) REST APIのどれを使用しているかにかかわらず、このアクセス権が必要です。権限を持っていない、または認可されていないというメッセージが表示された場合は、持っているアクセス権のタイプと作業しているコンパートメントを管理者に確認してください。
Oracle-Tags
タグを使用して作成されます。したがって、接続をさらに管理するには、次の権限を付与します。Allow group <Group Name> to manage tag-namespaces IN tenancy
where target.tag-namespace.name='Oracle-Tags'
管理者の場合: データベース管理者によるOracle Cloud外部データベース・リソースの管理のポリシーにより、指定したグループがデータベースおよび関連データベース・リソースを含むすべてのものを実行できます。
ポリシーを初めて使用する場合は、ポリシーの開始および共通ポリシーを参照してください。データベースのポリシーの記述の詳細は、外部データベースのポリシー詳細を参照してください。
外部プラガブル・データベースへの接続の作成
次のステップを実行して、外部プラガブル・データベースへの接続を作成します。
- ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
- 「外部データベース」で、「プラガブル・データベース」を選択します。「外部データベース」リスト・ページが開きます。
- 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
- 「外部データベース」リスト・ページで、接続を作成する外部データベースを選択します。選択した外部データベースの詳細が表示されます。
- 外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
- 「外部プラガブル・データベースに接続」を選択します。
- 「外部プラガブル・データベースへの接続」パネルで、次の詳細を入力します:
- コネクタ表示名: リソースを簡単に識別できるわかりやすい名前を指定します。
- コネクタ・タイプ: 外部データベースのコネクタ・タイプを指定します。
- MACS: 外部データベースにアクセスするためのOCI Management Agent Cloud Service (MACS)コネクタを作成します。外部データベースに接続する前に、エージェントを構成する必要があります。TCPSを使用している場合は、このオプションを選択します。
- コネクタ・エージェントID: コネクタのエージェントIDを指定します。
- 接続の接続文字列情報を指定します。
- DNSホスト名またはSCAN名: OCIに接続するオンプレミスのデータベースの仮想IP (VIP)アドレスまたは単一クライアント・アクセス名(SCAN)を指定します。
- ポート: データベース接続のためにOCI外部のデータベースによって使用されるポートを指定します。
- サービス: OCI以外のデータベースでデータベース接続に使用されるサービス名を指定します。
- プロトコル: データベース接続のためにOCI外部のデータベースによって使用されるプロトコルを指定します。TCPまたはTCPSから選択できます。
ノート
TCPSは、SSLを使用したTCP/IPです。このプロトコルにより、クライアント上のOracleアプリケーションは、TCP/IPおよびSSLを介してリモート・データベースと通信できます。SSLを使用すると、TCP単独よりも高いセキュリティが提供されます。詳細は、Database Net Services管理者ガイドのSSLプロトコルを使用したTCP/IPを参照してください。 -
「TCPS」プロトコルを選択した場合は、次のオプションの中から選択します:
- 既存のシークレットを使用
- 新規シークレットの作成
-
「既存のシークレットの使用」を選択した場合は、次の詳細を入力します:
- コンパートメントにデータベース・ユーザー・パスワード・シークレットを指定します。
-
「新しいシークレットの作成」を選択すると、「TLSシークレットの作成」ウィンドウが開きます。次の詳細を入力し、「TLSシークレットの作成」を選択します。
- シークレット名: 作成するシークレットの名前。
- 説明: [オプション]シークレットの説明。
- コンパートメントの選択: シークレットを格納する必要があるコンパートメント。
- コンパートメント内のVault: シークレットが格納されているコンパートメント内のVault。
- コンパートメント内の暗号化キー: シークレットを格納する必要があるコンパートメント内の暗号化キー。
- SSLトラスト・ストア・タイプ: SSLトラスト・ストアのタイプ。使用可能なオプションは、PKCS12およびJKSです。BCFKSは、米国政府リージョンで使用可能な唯一のオプションです。
- SSLトラスト・ストアの場所: エージェント・ホスト上のSSLトラスト・ストアの完全修飾パス。
- SSLトラスト・ストア・パスワード: SSLトラスト・ストアのパスワード。
- SSLキー・ストア・タイプ: [読取り専用]キー・ストアのタイプ。SSLトラスト・ストア・タイプと同じになるように自動的に選択されます。
- SSLキー・ストアの場所: エージェント・ホスト上のキー・ストアの完全修飾パス。
- SSLキーストア・パスワード: キーストアのパスワードです。
- SSL Server Certificate Distinguished Name: SSLサーバー証明書の一意の名前。
新しいシークレットを作成するためのJSON形式は次のようになります:
ウォレットがPKCS12の場合:
{ "sslTrustStoreType": "PKCS12", "sslTrustStoreLocation": "/mylocation/ewallet.p12", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "PKCS12", "sslKeyStoreLocation": "/mylocation/ewallet.p12", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
財布がJKSの場合:
{ "sslTrustStoreType": "JKS", "sslTrustStoreLocation": "/mylocation/truststore.jks", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "JKS", "sslKeyStoreLocation": "/mylocation/keystore.jks", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
- 接続のデータベース接続資格証明を入力します。
- ユーザー名: この接続で使用されるデータベース資格証明のユーザー名を指定します。
- パスワード: この接続で使用されるデータベース資格証明のパスワードを指定します。
- 資格証明名接頭辞: この文字列は、完全な資格証明名の最初の部分です。完全な資格証明名を作成するために、システム生成の資格証明名接頭辞に接頭辞が追加されます。
- 資格証明名: (読取り専用)接続の資格証明名。
- ロール: この接続で使用するデータベース資格証明のロールを指定します。NORMALとSYSDBAのいずれかを選択できます。
- 接続のネットワーク情報を指定します。
- 仮想クラウド・ネットワーク: 接続を作成するVCN。別のコンパートメントのVCNを選択するには、コンパートメントの変更を選択します。
- サブネット: 接続を作成するサブネット。
- ネットワーク・セキュリティ・グループ: オプションで、データベースに1つ以上のネットワーク・セキュリティ・グループ(NSG)を指定できます、NSGを使用するには、ネットワーク・セキュリティ・グループを使用したトラフィックの制御のトグルをオンにします。NSGは仮想ファイアウォールとして機能します。これにより、一連のイングレスおよびエグレス・セキュリティ・ルールを適用できます。NSGは5つまで指定できます。NSGを割り当てるには、仮想クラウド・ネットワークの1つを選択する必要があります。
- VNICのプライベートIPアドレス: 接続のIPアドレス。
- タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
- 「接続」を選択します。
外部コンテナ・データベースへの接続の作成
次のステップを実行して、外部コンテナ・データベースへの接続を作成します。
- ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
- 「外部データベース」で、「コンテナ・データベース」を選択します。「外部データベース」リスト・ページが開きます。
- 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
- 「外部データベース」リスト・ページで、接続を作成する外部データベースを選択します。選択した外部データベースの詳細が表示されます。
- 外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
- 「外部コンテナ・データベースに接続」を選択します。
- 「外部コンテナ・データベースへの接続」パネルで、次の詳細を入力します:
- コネクタ表示名: リソースを簡単に識別できるわかりやすい名前を指定します。
- コネクタ・タイプ: 外部データベースのコネクタ・タイプを指定します。
- MACS: 外部データベースにアクセスするためのOCI Management Agent Cloud Service (MACS)コネクタを作成します。外部データベースに接続する前に、エージェントを構成する必要があります。TCPSを使用している場合は、このオプションを選択します。
- コネクタ・エージェントID: コネクタのエージェントIDを指定します。
- 接続の接続文字列情報を指定します。
- DNSホスト名またはSCAN名: OCIに接続するオンプレミスのデータベースの仮想IP (VIP)アドレスまたは単一クライアント・アクセス名(SCAN)を指定します。
- ポート: データベース接続のためにOCI外部のデータベースによって使用されるポートを指定します。
- サービス: OCI以外のデータベースでデータベース接続に使用されるサービス名を指定します。
- プロトコル: データベース接続のためにOCI外部のデータベースによって使用されるプロトコルを指定します。TCPまたはTCPSから選択できます。
ノート
TCPSは、SSLを使用したTCP/IPです。このプロトコルにより、クライアント上のOracleアプリケーションは、TCP/IPおよびSSLを介してリモート・データベースと通信できます。SSLを使用すると、TCP単独よりも高いセキュリティが提供されます。詳細は、Database Net Services管理者ガイドのSSLプロトコルを使用したTCP/IPを参照してください。 -
「TCPS」プロトコルを選択した場合は、次のオプションの中から選択します:
- 既存のシークレットを使用
- 新規シークレットの作成
-
「既存のシークレットの使用」を選択した場合は、次の詳細を入力します:
- コンパートメントにデータベース・ユーザー・パスワード・シークレットを指定します。
-
「新しいシークレットの作成」を選択すると、「TLSシークレットの作成」ウィンドウが開きます。次の詳細を入力し、「TLSシークレットの作成」を選択します。
- シークレット名: 作成するシークレットの名前。
- 説明: [オプション]シークレットの説明。
- コンパートメントの選択: シークレットを格納する必要があるコンパートメント。
- コンパートメント内のVault: シークレットが格納されているコンパートメント内のVault。
- コンパートメント内の暗号化キー: シークレットを格納する必要があるコンパートメント内の暗号化キー。
- SSLトラスト・ストア・タイプ: SSLトラスト・ストアのタイプ。使用可能なオプションは、PKCS12およびJKSです。BCFKSは、米国政府リージョンで使用可能な唯一のオプションです。
- SSLトラスト・ストアの場所: エージェント・ホスト上のSSLトラスト・ストアの完全修飾パス。
- SSLトラスト・ストア・パスワード: SSLトラスト・ストアのパスワード。
- SSLキー・ストア・タイプ: [読取り専用]キー・ストアのタイプ。SSLトラスト・ストア・タイプと同じになるように自動的に選択されます。
- SSLキー・ストアの場所: エージェント・ホスト上のキー・ストアの完全修飾パス。
- SSLキーストア・パスワード: キーストアのパスワードです。
- SSL Server Certificate Distinguished Name: SSLサーバー証明書の一意の名前。
新しいシークレットを作成するためのJSON形式は次のようになります:
ウォレットがPKCS12の場合:
{ "sslTrustStoreType": "PKCS12", "sslTrustStoreLocation": "/mylocation/ewallet.p12", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "PKCS12", "sslKeyStoreLocation": "/mylocation/ewallet.p12", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
財布がJKSの場合:
{ "sslTrustStoreType": "JKS", "sslTrustStoreLocation": "/mylocation/truststore.jks", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "JKS", "sslKeyStoreLocation": "/mylocation/keystore.jks", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
- 接続のデータベース接続資格証明を入力します。
- ユーザー名: この接続で使用されるデータベース資格証明のユーザー名を指定します。
- パスワード: この接続で使用されるデータベース資格証明のパスワードを指定します。
- 資格証明名接頭辞: この文字列は、完全な資格証明名の最初の部分です。完全な資格証明名を作成するために、システム生成の資格証明名接頭辞に接頭辞が追加されます。
- 資格証明名: (読取り専用)接続の資格証明名。
- ロール: この接続で使用するデータベース資格証明のロールを指定します。NORMALとSYSDBAのいずれかを選択できます。
- 接続のネットワーク情報を指定します。
- 仮想クラウド・ネットワーク: 接続を作成するVCN。別のコンパートメントのVCNを選択するには、コンパートメントの変更を選択します。
- サブネット: 接続を作成するサブネット。
- ネットワーク・セキュリティ・グループ: オプションで、データベースに1つ以上のネットワーク・セキュリティ・グループ(NSG)を指定できます、NSGを使用するには、ネットワーク・セキュリティ・グループを使用したトラフィックの制御のトグルをオンにします。NSGは仮想ファイアウォールとして機能します。これにより、一連のイングレスおよびエグレス・セキュリティ・ルールを適用できます。NSGは5つまで指定できます。NSGを割り当てるには、仮想クラウド・ネットワークの1つを選択する必要があります。
- VNICのプライベートIPアドレス: 接続のIPアドレス。
- タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
- 「接続」を選択します。
外部非コンテナ・データベースへの接続の作成
次のステップを実行して、外部非コンテナ・データベースへの接続を作成します。
- ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
- 「外部データベース」で、「非コンテナ・データベース」を選択します。「外部データベース」リスト・ページが開きます。
- 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
- 「外部データベース」リスト・ページで、接続を作成する外部データベースを選択します。選択した外部データベースの詳細が表示されます。
- 外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
- 外部非コンテナ・データベースに接続を選択します。
- 「外部非コンテナ・データベースへの接続」パネルで、次の詳細を入力します:
- コネクタ表示名: リソースを簡単に識別できるわかりやすい名前を指定します。
- コネクタ・タイプ: 外部データベースのコネクタ・タイプを指定します。
- MACS: 外部データベースにアクセスするためのOCI Management Agent Cloud Service (MACS)コネクタを作成します。外部データベースに接続する前に、エージェントを構成する必要があります。TCPSを使用している場合は、このオプションを選択します。
- コネクタ・エージェントID: コネクタのエージェントIDを指定します。
- 接続の接続文字列情報を指定します。
- DNSホスト名またはSCAN名: OCIに接続するオンプレミスのデータベースの仮想IP (VIP)アドレスまたは単一クライアント・アクセス名(SCAN)を指定します。
- ポート: データベース接続のためにOCI外部のデータベースによって使用されるポートを指定します。
- サービス: OCI以外のデータベースでデータベース接続に使用されるサービス名を指定します。
- プロトコル: データベース接続のためにOCI外部のデータベースによって使用されるプロトコルを指定します。TCPまたはTCPSから選択できます。
ノート
TCPSは、SSLを使用したTCP/IPです。このプロトコルにより、クライアント上のOracleアプリケーションは、TCP/IPおよびSSLを介してリモート・データベースと通信できます。SSLを使用すると、TCP単独よりも高いセキュリティが提供されます。詳細は、Database Net Services管理者ガイドのSSLプロトコルを使用したTCP/IPを参照してください。 -
「TCPS」プロトコルを選択した場合は、次のオプションの中から選択します:
- 既存のシークレットを使用
- 新規シークレットの作成
-
「既存のシークレットの使用」を選択した場合は、次の詳細を入力します:
- コンパートメントにデータベース・ユーザー・パスワード・シークレットを指定します。
-
「新しいシークレットの作成」を選択すると、「TLSシークレットの作成」ウィンドウが開きます。次の詳細を入力し、「TLSシークレットの作成」を選択します。
- シークレット名: 作成するシークレットの名前。
- 説明: [オプション]シークレットの説明。
- コンパートメントの選択: シークレットを格納する必要があるコンパートメント。
- コンパートメント内のVault: シークレットが格納されているコンパートメント内のVault。
- コンパートメント内の暗号化キー: シークレットを格納する必要があるコンパートメント内の暗号化キー。
- SSLトラスト・ストア・タイプ: SSLトラスト・ストアのタイプ。使用可能なオプションは、PKCS12およびJKSです。BCFKSは、米国政府リージョンで使用可能な唯一のオプションです。
- SSLトラスト・ストアの場所: エージェント・ホスト上のSSLトラスト・ストアの完全修飾パス。
- SSLトラスト・ストア・パスワード: SSLトラスト・ストアのパスワード。
- SSLキー・ストア・タイプ: [読取り専用]キー・ストアのタイプ。SSLトラスト・ストア・タイプと同じになるように自動的に選択されます。
- SSLキー・ストアの場所: エージェント・ホスト上のキー・ストアの完全修飾パス。
- SSLキーストア・パスワード: キーストアのパスワードです。
- SSL Server Certificate Distinguished Name: SSLサーバー証明書の一意の名前。
新しいシークレットを作成するためのJSON形式は次のようになります:
ウォレットがPKCS12の場合:
{ "sslTrustStoreType": "PKCS12", "sslTrustStoreLocation": "/mylocation/ewallet.p12", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "PKCS12", "sslKeyStoreLocation": "/mylocation/ewallet.p12", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
財布がJKSの場合:
{ "sslTrustStoreType": "JKS", "sslTrustStoreLocation": "/mylocation/truststore.jks", "sslTrustStorePassword": "mypassword", "sslKeyStoreType": "JKS", "sslKeyStoreLocation": "/mylocation/keystore.jks", "sslKeyStorePassword": "mypassword", "sslServerCertDn": "C=US,O=OracleCorporation,CN=sslclient" }
- 接続のデータベース接続資格証明を入力します。
- ユーザー名: この接続で使用されるデータベース資格証明のユーザー名を指定します。
- パスワード: この接続で使用されるデータベース資格証明のパスワードを指定します。
- 資格証明名接頭辞: この文字列は、完全な資格証明名の最初の部分です。完全な資格証明名を作成するために、システム生成の資格証明名接頭辞に接頭辞が追加されます。
- 資格証明名: (読取り専用)接続の資格証明名。
- ロール: この接続で使用するデータベース資格証明のロールを指定します。NORMALとSYSDBAのいずれかを選択できます。
- 接続のネットワーク情報を指定します。
- 仮想クラウド・ネットワーク: 接続を作成するVCN。別のコンパートメントのVCNを選択するには、コンパートメントの変更を選択します。
- サブネット: 接続を作成するサブネット。
- ネットワーク・セキュリティ・グループ: オプションで、データベースに1つ以上のネットワーク・セキュリティ・グループ(NSG)を指定できます、NSGを使用するには、ネットワーク・セキュリティ・グループを使用したトラフィックの制御のトグルをオンにします。NSGは仮想ファイアウォールとして機能します。これにより、一連のイングレスおよびエグレス・セキュリティ・ルールを適用できます。NSGは5つまで指定できます。NSGを割り当てるには、仮想クラウド・ネットワークの1つを選択する必要があります。
- VNICのプライベートIPアドレス: 接続のIPアドレス。
- タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
- 「接続」を選択します。
APIの使用
APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。
次のAPI操作を使用して、外部データベース接続を作成します:
- CreateExternalDatabaseConnector
データベース・サービスのAPIの完全なリストは、データベース・サービスAPIを参照してください。