Oracle Cloud Infrastructureドキュメント

外部データベースのハンドラの作成

このトピックでは、コンソールおよびAPIを使用した外部データベース・ハンドルの作成について説明します。ハンドルは、Oracle Cloudの外部にあるOracle DatabaseインスタンスのOCI内の表現として機能します

ノート

次の手順は、Oracle Cloudの外部でOracle Databaseインスタンスを作成する場合には使用しません。

必要なIAMポリシー

Oracle Cloud Infrastructureを使用するには、管理者からポリシーでセキュリティ・アクセス権が付与されている必要があります。コンソールまたは(SDK、CLIまたはその他のツールを使用した) REST APIのどれを使用しているかにかかわらず、このアクセス権が必要です。権限を持っていない、または認可されていないというメッセージが表示された場合は、持っているアクセス権のタイプと作業しているコンパートメントを管理者に確認してください。

管理者の場合: データベース管理者によるOracle Cloud外部データベース・リソースの管理のポリシーにより、指定したグループがデータベースおよび関連データベース・リソースを含むすべてのものを実行できます。

TCPSコネクタを使用してデータベース接続を作成または更新するには、ユーザー・グループにシークレット・ファミリ/リソースを使用する権限が必要です。

ポリシーを初めて使用する場合は、ポリシーの開始および共通ポリシーを参照してください。データベースのポリシーの記述の詳細は、外部データベースのポリシー詳細を参照してください。

外部プラガブル・データベースへのハンドルの作成

外部プラガブル・データベースへのハンドルを作成するには、次のステップを実行します。

  1. ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
  2. 「外部データベース」で、「プラガブル・データベース」を選択します。「外部データベース」リスト・ページが開きます。
  3. 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
  4. 「外部プラガブル・データベースの登録」を選択します。
  5. 「外部プラガブル・データベースの登録」ページで、次の詳細を入力します:
  6. データベース表示名: リソースを簡単に識別できるユーザー・フレンドリな名前を指定します。
  7. 外部コンテナ・データベースの選択: プラガブル・データベースを格納します。
  8. コンパートメント: コンパートメントの選択デフォルトでは、データベースは現在のコンパートメントに作成されます。
  9. タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
  10. 「Register」を選択します。

次の処理

  • 外部プラガブル・データベース・リソース(ハンドル)を作成した後、外部プラガブル・データベース・インスタンスへのハンドルの接続を構成できます。詳細は、外部プラガブル・データベースへの接続の作成を参照してください。
  • 外部データベース・インスタンスにハンドルを接続した後、データベース管理やオペレーション・インサイトなどの関連サービスを有効にできます。詳細は、外部データベースの関連サービスの管理を参照してください。

外部コンテナ・データベースへのハンドルの作成

外部コンテナ・データベースへのハンドルを作成するには、次のステップを実行します。

  1. ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
  2. 「外部データベース」で、「コンテナ・データベース」を選択します。「外部データベース」リスト・ページが開きます。
  3. 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
  4. 「外部コンテナ・データベースの登録」を選択します。
  5. 「外部コンテナ・データベースの登録」ページで、次の詳細を入力します:
  6. データベース表示名: リソースを簡単に識別できるユーザー・フレンドリな名前を指定します。
  7. コンパートメント: コンパートメントの選択デフォルトでは、データベースは現在のコンパートメントに作成されます。
  8. タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
  9. 「Register」を選択します。

次の処理

外部非コンテナ・データベースへのハンドルの作成

外部非コンテナ・データベースへのハンドルを作成するには、次のステップを実行します。

  1. ナビゲーション・メニューを開き、「Oracle Database」、「外部データベース」の順に選択します。
  2. 「外部データベース」で、「非コンテナ・データベース」を選択します。「外部データベース」リスト・ページが開きます。
  3. 選択したコンパートメント内のすべての外部データベースが表に表示されます。別のコンパートメント内の外部データベースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。
  4. 「外部非コンテナ・データベースの登録」を選択します。
  5. 「外部非コンテナ・データベースの登録」ページで、次の詳細を入力します:
  6. データベース表示名: リソースを簡単に識別できるユーザー・フレンドリな名前を指定します。
  7. コンパートメント: コンパートメントの選択デフォルトでは、データベースは現在のコンパートメントに作成されます。
  8. タグ: リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグを適用するかどうかがわからない場合は、このオプションをスキップするか(後でタグを適用できます)、管理者に問い合せてください。詳細は、リソース・タグを参照してください。
  9. 「Register」を選択します。

次の処理

  • 外部非コンテナ・データベース・リソース(ハンドル)を作成した後、外部データベース・インスタンスへのハンドルの接続を構成できます。詳細は、外部非コンテナ・データベースへの接続の作成を参照してください。
  • 外部データベース・インスタンスにハンドルを接続した後、データベース管理やオペレーション・インサイトなどの関連サービスを有効にできます。詳細は、外部データベースの関連サービスの管理を参照してください。

APIの使用

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

次のAPI操作を使用して、OCI外部データベース・ハンドルを作成します:

  • CreateExternalContainerDatabase
  • CreateExternalPluggableDatabase
  • CreateExternalNonContainerDatabase

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