外部データベースの接続の管理

このトピックでは、コンソールおよび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」、「外部データベース」の順に選択します。
「外部データベース」で、使用している外部データベースのタイプに応じて、「プラガブル・データベース」、「コンテナ・データベース」または「非コンテナ・データベース」を選択します。
選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
「外部データベース」リスト・ページで、接続ステータスを確認する外部データベースを選択します。選択した外部データベースの詳細が表示されます。
外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
外部データベース接続のリストで、ステータスをチェックする接続の名前を選択します。選択した接続の詳細が表示されます。
外部コネクタの詳細ページの「外部接続情報」タブの「接続情報」セクションで、「接続ステータスの確認」を選択し、プロンプトが表示されたら確認します。「接続ステータスの確認」作業リクエストが作成されます。
作業リクエスト名を選択すると、接続ステータスの詳細が表示されます。

作業リクエストの詳細は、作業リクエストを参照してください

外部データベース接続の接続資格証明の更新

外部データベース接続の接続資格証明を更新するには、次のステップを実行します。

ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
「外部データベース」で、使用している外部データベースのタイプに応じて、「プラガブル・データベース」、「コンテナ・データベース」または「非コンテナ・データベース」を選択します。
選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
「外部データベース」リスト・ページで、更新する外部データベース接続を選択します。選択した外部データベースの詳細が表示されます。
外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
外部データベース接続のリストで、更新する接続の名前を選択します。選択した接続の詳細が表示されます。
外部コネクタの詳細ページで、「接続資格証明の更新」を選択します。
「接続資格証明の更新」パネルで、次の詳細を入力します:
資格証明名: (読取り専用)接続の資格証明名。
ユーザー名: この接続で使用されるデータベース資格証明のユーザー名を指定します。
パスワード: この接続で使用されるデータベース資格証明のパスワードを指定します。
ロール: この接続で使用するデータベース資格証明のロールを指定します。NORMALとSYSDBAのいずれかを選択できます。
シークレット: この接続で使用されるデータベース資格証明のシークレットを入力します(コネクタがTCPSを使用して作成された場合)。
- 「新規シークレットの選択」または「現在のシークレットの変更」のいずれかを選択します。
- 「新規シークレットの選択」を選択した場合は、メニューを使用して既存のシークレットを表示し、必要なシークレット名を選択します。
- 「現在のシークレットの変更」を選択すると、「現在のシークレットの変更」ダイアログ・ボックスが表示されます。
- 次のSSL情報を入力してください:
  - SSLトラスト・ストア・タイプ: SSLトラスト・ストアのタイプ。使用可能なオプションは、PKCS12およびJKSです。BCFKSは、米国政府リージョンで使用可能な唯一のオプションです。
  - SSLトラスト・ストアの場所: エージェント・ホスト上のSSLトラスト・ストアの完全修飾パス。
  - SSLトラスト・ストア・パスワード: SSLトラスト・ストアのパスワード。
  - SSLキー・ストア・タイプ: [読取り専用]キー・ストアのタイプ。SSLトラスト・ストア・タイプと同じになるように自動的に選択されます。
  - SSLキー・ストアの場所: エージェント・ホスト上のキー・ストアの完全修飾パス。
  - SSLキーストア・パスワード: キーストアのパスワードです。
  - SSL Server Certificate Distinguished Name: SSLサーバー証明書の一意の名前。
- 「現在のシークレットの変更」を選択します。
「保存」を選択します。

外部データベース接続の接続文字列の更新

外部データベース接続の接続文字列を更新するには、次のステップを実行します。

ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
「外部データベース」で、使用している外部データベースのタイプに応じて、「プラガブル・データベース」、「コンテナ・データベース」または「非コンテナ・データベース」を選択します。
選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
「外部データベース」リスト・ページで、更新する外部データベース接続を選択します。選択した外部データベースの詳細が表示されます。
外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
外部データベース接続のリストで、更新する接続の名前を選択します。選択した接続の詳細が表示されます。
「外部コネクタの詳細」パネルで、「接続文字列の更新」を選択します。
「接続文字列の更新」パネルで、次の詳細を入力します:
DNSホスト名またはSCAN名: OCIに接続するオンプレミスのデータベースの仮想IP (VIP)アドレスまたは単一クライアント・アクセス名(SCAN)を指定します。
ポート: データベース接続のためにOCI外部のデータベースによって使用されるポートを指定します。
サービス: OCI以外のデータベースでデータベース接続に使用されるサービス名を指定します。
プロトコル: (読取り専用)接続の作成時に設定されたプロトコル。これは変更できません。
「保存」を選択します。

外部データベース接続の削除

外部データベース接続を削除するには、次のステップを実行します。

ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
「外部データベース」で、使用している外部データベースのタイプに応じて、「プラガブル・データベース」、「コンテナ・データベース」または「非コンテナ・データベース」を選択します。
選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
「外部データベース」リスト・ページで、削除する外部データベース接続を選択します。選択した外部データベースの詳細が表示されます。
外部データベースの詳細ページで、「コネクタ」タブを選択します。外部データベース接続のリストが表示されます。
外部データベース接続のリストで、削除する接続の名前を選択します。選択した接続の詳細が表示されます。
「外部コネクタの詳細」パネルで、「削除」を選択して確認します。

APIの使用

APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

次のAPI操作を使用して、外部データベース接続を管理します:

ListExternalDatabaseConnectors
GetExternalDatabaseConnector
CheckExternalDatabaseConnectorConnectionStatus
UpdateExternalDatabaseConnector
DeleteExternalDatabaseConnector

データベース・サービスのAPIの完全なリストは、データベース・サービスAPIを参照してください。

Oracle Cloud Infrastructureドキュメント