Oracle Exadata Database Service on Cloud@CustomerでのOracle Data Guardの使用

VMクラスタでData Guardグループを構成および管理する方法について学習します。

Oracle Exadata Database Service on Cloud@CustomerでのOracle Data Guardの使用について

Oracle Data Guardには、1つ以上のスタンバイ・データベースを作成、維持、管理、監視して、本番のOracleデータベースが障害やデータ破損に耐えられるようにするための包括的なサービス・セットが用意されています。

Oracle Data Guardは、本番データベースのコピーとしてスタンバイ・データベースを維持します。これにより、計画停止または計画外停止のために本番データベースが使用できなくなった場合、Oracle Data Guardはスタンバイ・データベースを本番ロールに切り替えて、停止に関連する停止時間を最小化できます。Oracle Data Guardを従来のバックアップ、リストアおよびクラスタ化の手法とともに使用して、高レベルのデータ保護およびデータ可用性を提供できます。Oracle Data Guard転送サービスは、ソース・データベースから1つ以上のリモート宛先への効率的で信頼できるREDO転送のために、Oracle StreamsやOracle GoldenGateなどの他のOracleの機能によっても使用されます。

Oracle Data Guardの詳細は、Oracle Data Guard概要および管理のドキュメントおよびOracle Databaseドキュメント・ポータルのOracle Data Guard Broker概要を参照してください。

このトピックでは、コンソールまたはAPIを使用してVMクラスタ内のData Guardリソースを管理する方法について説明します。

コンソールまたはAPIを使用して、Exadataデータベース・コンピュート・ノードのデータベースに対してData Guardを有効にする場合:
  • スタンバイ・データベースはフィジカル・スタンバイです。
  • ピア・データベース(プライマリおよびスタンバイ)のバージョンは同一です。
  • スタンバイ・データベースは、オープンしている読取り専用データベース(Active Data Guard)としてデプロイされます。
  • プライマリ・データベースは、最大6つのスタンバイ・データベースをサポートできます。

Oracle Exadata Database Service on Cloud@CustomerでOracle Data Guardを使用するための前提条件

Oracle Exadata Database Service on Cloud@CustomerでData Guardを使用するための前提条件のリストを確認します。

VMクラスタ

VMクラスタのData Guard実装には、2つのExadataデータベースVMクラスタ(プライマリ・データベースを含むクラスタとスタンバイ・データベースを含むクラスタ)が必要です。

ノート

Oracleでは、障害分離と障害保護を強化するために、本番ワークロードのプライマリ・データベースとスタンバイ・データベースを異なるExadata Cloud Infrastructureに配置することを強くお薦めします。

パスワード

SYSパスワードを変更するか、TDEキーをローテーションするには、OCI APIを使用します。

VMクラスタへのノードの追加

VMクラスタにノードを追加すると、Data Guardデータベースのインスタンスが新しいノードに自動的に作成されます。

VMクラスタからのノードの削除

VMクラスタからノードを削除すると、削除ノード上のインスタンスとそのメタデータが自動的に削除されます。

Data Guardの作業

Oracle Data Guardは、企業データの高可用性、データ保護および障害時リカバリを保証します。

プライマリ・データベースとスタンバイ・データベースは、Data Guardグループを構成します。ほとんどのアプリケーションは、プライマリ・データベースにアクセスします。スタンバイ・データベースは、トランザクション上の一貫性を持つ、プライマリ・データベースのコピーです。

Data Guardは、プライマリ・データベースからREDOデータを転送および適用することで、スタンバイ・データベースを維持します。プライマリ・データベースが使用不可になった場合は、Data Guardを使用して、スタンバイ・データベースをプライマリ・ロールにスイッチオーバーまたはフェイルオーバーできます。これは、複数のスタンバイ・データベースがある場合でも当てはまります。

スイッチオーバー

スイッチオーバーは、データベースのプライマリ・ロールとスタンバイ・ロールを入れ替えます。

各データベースは、新しいロールで引き続きData Guardグループに属します。スイッチオーバーでは、データ損失がないことが保証されます。プライマリ・データベースで計画メンテナンスを実行する前に、スイッチオーバーを使用できます。Data Guardグループを使用してExadataデータベース・コンピュート・ノード上で計画メンテナンスを実行するには、通常、プライマリをスタンバイ・ロールに切り替え、スタンバイでメンテナンスを実行してからプライマリ・ロールに戻します。

フェイルオーバー

フェイルオーバーは、既存のプライマリ・データベースで障害が発生したりアクセスが不可能になった後に、スタンバイ・データベースをプライマリ・ロールに移行します。

最大パフォーマンス保護モードを使用している場合、フェイルオーバーによってデータ損失が発生する可能性があります。

回復

Data Guardグループ内のスタンバイ・ロールにデータベースを復元します。

障害の原因を修正した後に、回復コマンドを使用して、障害が発生したデータベースを再稼働させることができます。

ノート

1つ以上のスタンバイ・データベースを含むData Guardグループの一部であるプライマリ・データベースは終了できません。最初にスタンバイ・データベースを終了する必要があります。または、プライマリ・データベースをスタンバイ・ロールにスイッチオーバーすることで、前のプライマリを終了できます。

Data Guardが有効になっているデータベースを含むVMクラスタを終了できません。まず、Data Guardグループの一部であるスタンバイ・データベースを終了する必要があります。

コンソールを使用したOracle Data Guardグループの管理

データベース間のData Guardグループの有効化、スイッチオーバーまたはフェイルオーバー操作のいずれかを使用してData Guardグループ内のデータベースのロール変更、および障害が発生されたデータベースの回復を行う方法について学習します。

Data Guardを有効にすると、プライマリ・データベースとスタンバイ・データベースの間に別個のData Guardグループが作成されます。

コンソールを使用したOracle Exadata Database Service on Cloud@CustomerシステムでのData Guardの有効化

データベース間のData Guardグループの設定について学習します。

ノート

Data Guardは、プライマリ・クラスタとスタンバイ・クラスタの間で十分なスループットを持つ信頼性の高いネットワークに依存します。Oracleはネットワークを所有していないため、Data Guardを実装する前に評価を行い、必要なネットワーク帯域幅が使用可能であることを確認する必要があります。クラスタ間の達成可能なスループットを理解し、データベースの要件が満たされているかどうかを評価するには、ネットワーク・パフォーマンスの評価および最適化に従うことをお薦めします。デフォルトでは、クロスリージョンのExaDB-C@C Data Guard構成の最大ソケット・バッファ・サイズは、より高い値に設定されます。

ノート

Data Guardグループを構成する場合、プライマリ・データベースとスタンバイ・データベースは同じメジャー・リリース・バージョンである必要がありますが、スタンバイ・データベースはより新しいマイナー・バージョンにすることができます。

最新リリースの一部として、パフォーマンスを向上させるための強化されたユーザー・エクスペリエンスと新しいAPIを導入し、クラウドの自動化による複数のスタンバイ・データベースのサポートを含む追加のData Guard機能を提供しています。

  • 新しいAPIでは、新しいData Guard構成がData Guardグループ・リソースとして作成されます。
  • 既存のData Guard設定がある場合は、影響なく現在の機能を引き続き使用できます。ただし、複数のスタンバイ・データベースを作成する場合は、いつでも実行できる新しいAPIモデルに移行する必要があります。
  • 現在、既存のData GuardアソシエーションAPIを使用してData Guard操作を管理する自動化がある場合、これらの新機能を利用するには、新しいAPIを使用するようにアプリケーションを更新する必要があります

    Oracleは現在、既存のData GuardアソシエーションAPIと新しいData GuardグループAPI、および関連するユーザー・インタフェースの両方をサポートしています。

ノート

スタンバイでのパラレル操作が失敗した場合は、5分間隔で再試行する必要があります。
  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、プライマリ・ロールを引き継ぐデータベースが含まれるVMクラスタをクリックし、そのデータベースの名前をクリックします。
  4. 「Data Guardアソシエーション」をクリックします。
  5. 「スタンバイの追加」をクリックします。
  6. 「スタンバイの追加」ページで、Data Guardグループを構成します。
    • Data Guard事前チェックを明示的に実行するには、「事前チェックの実行」をクリックします。「事前チェックの実行」をクリックすると、次のアクションが実行されます。
      • 「スタンバイの追加」ページが閉じます。
      • 「プライマリ・データベースの詳細」ページに、Data Guard事前チェックが進行中で、「スタンバイの追加」ボタンが無効であることを示すメッセージが表示されます。

      「詳細の表示」リンクをクリックして、ステータスの「作業リクエスト」ページにナビゲートします。

      • 事前チェック・ステータス(「成功」または「失敗」)を確認します。
      • 事前チェックが失敗した場合は、報告されたエラーを解決し、Data Guard設定を再試行します。
      ノート

      事前チェックの実行中は、プライマリ・データベースおよびVMクラスタは使用可能状態のままです。
      • Data Guardエクスペリエンスの選択:
        • 新しいData Guardグループ・リソースの使用このオプションを使用すると、新しいData Guard構成がData Guardグループ・リソースとして作成されることになります。新しいAPIでのこのオプションは、複数のスタンバイ・データベースの追加をサポートし、その他の機能拡張を提供します。既存のData GuardアソシエーションAPIを使用してData Guard操作を管理する自動化が現在ある場合は、新しいAPIを使用してこれらの新機能を利用するようにアプリケーションを更新できます。
        • 既存のData Guardアソシエーション・リソースの使用 Data Guard操作の管理の自動化が既存のData GuardアソシエーションAPIに依存する場合は、このオプションを選択します。ただし、複数のスタンバイ・データベースを追加することはできず、新しいAPIによって提供される機能強化も得られません。
    • Data Guardグループの詳細:
      • デプロイしたOracle Databaseソフトウェア・ライセンス・タイプに基づいて、Data Guardタイプ(Active Data GuardまたはData Guard)を選択します。Oracle Database Enterprise Edition Extreme Performance (ライセンス込み)をデプロイした場合は、Data GuardまたはActive Data Guardのいずれかを選択できます。Active Data Guardオプションなしでライセンス持込み(BYOL)のOracle Database Enterprise Editionをデプロイした場合は、デフォルトのData Guardを選択します。
        • Active Data Guard: Active Data Guardは、Oracle Database Enterprise Editionのライセンス対象オプションであり、Data Guardの基本機能を拡張する高度な機能を使用可能にします。これらの機能には、リアルタイム問合せとDMLオフロード、フィジカル・データ破損の自動ブロック修復、スタンバイ・ブロック変更トラッキング、グローバル・データ・サービスおよびアプリケーション・継続性が含まれます。
        • Data Guard: Oracle Data Guardは、企業データの高可用性、データ保護および障害時リカバリを保証します。Data Guardには、1つ以上のスタンバイ・データベースを作成、維持、管理、監視して、本番のOracleデータベースが障害やデータ破損に耐えられるようにするための包括的なサービス・セットが用意されています。Data Guardは、トランザクション上の一貫性を持つ本番データベースのコピーとしてスタンバイ・データベースを維持します。
      • 保護モード:このData Guardグループで使用される保護モード。

        「最大パフォーマンス」は、プライマリ・データベースのパフォーマンスに影響を与えない範囲の最上位レベルのデータ保護を提供します。

        「最大可用性」は、ゼロ・データ損失の同期トランスポートを使用して、データベースの可用性を損なわない範囲の最上位レベルのデータ保護を提供します。

      • トランスポート・タイプ:プライマリ・データベースとこのスタンバイ・データベース間のData Guardアソシエーションに使用されるREDOトランスポート・タイプ。

        • 非同期:最大パフォーマンス保護モードで使用される非同期トランスポート・モード。
        • 同期:最大パフォーマンスおよび最大可用性保護モードで使用される同期トランスポート・モード。

        保護モードおよびトランスポート・タイプ: スタンバイ・データベース作成のルール

        • 最初のスタンバイの作成:最初のスタンバイ・データベースの保護モードまたはトランスポート・タイプは変更できません。
          • デフォルトの設定は次のとおりです:
            • 保護モード:最大パフォーマンス
            • トランスポート・タイプ:非同期
        • 2番目のスタンバイからN番目のスタンバイの作成:後続のスタンバイ・データベースの保護モードまたはトランスポート・タイプは変更できません。
          • 保護モードは、最初のスタンバイから継承されます。
          • デフォルトのトランスポート・タイプは「非同期」に設定されています。
    • ピアVMクラスタの選択: スタンバイの次の値を指定します:
      • ピア・リージョン:プライマリ・データベースとスタンバイ・データベースは、共有ExaDB-C@Cシステム上の2つの異なるVMクラスタ、または同一または異なるOracle Cloud Infrastructureリージョンから管理される地理的に離れた2つのExaDB-C@Cシステムで実行できます。
      • ピアExadata Cloud@Customerインフラストラクチャ: スタンバイ・データベースが存在するExadata Database Service on Cloud@Customerインフラストラクチャを選択します。「コンパートメントの変更」ハイパーリンクをクリックして、コンパートメントを選択します。
      • ピアVMクラスタ: スタンバイ・データベースを含むExadataデータベース・コンピュート・ノードを選択します。「コンパートメントの変更」ハイパーリンクをクリックして、コンパートメントを選択します。
    • データベース・ホームの選択: 既存のデータベース・ホームを選択するか、必要に応じて作成します。
      • 既存のデータベース・ホームの選択: 選択したデータベース・バージョンのデータベース・ホームが1つ以上すでに存在する場合、このオプションがデフォルトで選択されます。また、データベース・ホームのリストが表示されます。リストからデータベース・ホームを選択します。
        ノート

        同じバージョンおよびRUのデータベース・ホームのみがリストされますが、表示されるホームにはプライマリとは異なる個別パッチが含まれる場合があります。個別パッチが異なることは許容されますが、ベスト・プラクティスは、プライマリとスタンバイの間で同一のデータベース・ホームを持つことです。
      • 新規データベース・ホームの作成: 選択したデータベース・バージョンのデータベース・ホームが存在しない場合、このオプションがデフォルトで選択されます。プライマリ・データベースと同じDSIで新しいデータベース・ホームを作成するか、別のイメージを選択できます。DSIはリージョン間では使用できません。プライマリと同じRUを使用して、ピア・リージョンに別のDSIを作成する必要があります。
        1. 「データベース・イメージの変更」をクリックして、新しいデータベース・ホームのデータベース・ソフトウェア・イメージを選択します。
        2. 結果の「データベース・イメージの参照」で、次を実行します:
          1. 新しいデータベース・ホームの作成に使用するデータベース・ソフトウェア・イメージが含まれているコンパートメントを選択します。
          2. 新しいデータベース・ホームで使用するOracle Databaseソフトウェアのバージョンを選択し、選択したソフトウェア・バージョンで使用可能なイメージのリストからイメージを選択します。
          3. 「選択」をクリックします
            ノート

            新しいData Guardグループ・リソースを使用している場合は、スタンバイ・データベースを追加する前に、まずデータベース・ホームを作成する必要があります。
    • スタンバイ・データベースの構成:
      • データベースの一意の名前の指定:
        ノート

        データベースの作成後にdb_namedb_unique_nameおよびSID接頭辞を変更することはできません。

        オプションで、データベースに一意の名前を指定します。この属性では、db_unique_nameデータベース・パラメータの値を定義します。この値は大/小文字が区別されません。db_unique_nameに使用できるのは、許可されている文字のみです。

        データベース名を選択する場合は、次のガイドラインを確認してください:
        • 最大30文字です
        • 英数字およびアンダースコア(_)を含めることができます
        • 英字で始めます
        • フリート/テナンシ全体で一意にします

        一意の名前が入力されない場合、db_unique_nameは、デフォルトで<db_name>_<3 char unique string>_<region-name>というフォーマットになります。

      • データベース・パスワード: 「データベース・パスワード」フィールドにプライマリ・データベースのデータベース管理パスワードを入力します。スタンバイには、この同じデータベース管理パスワードが使用されます。

        管理パスワードとTDEパスワードは同じである必要があります。そうでない場合は、データベース・パスワードの変更の手順に従って調整します。

      • TDEウォレット・パスワード: TDEウォレット・パスワードを入力します。
    • (オプション)「拡張オプションの表示」を選択します。
      • Oracle SID接頭辞の指定: オプションで、データベースのOracle SID接頭辞を指定します。インスタンス番号は、SID接頭辞に自動的に追加され、instance_nameデータベース・パラメータになります。指定しない場合、SID接頭辞はデフォルトでdb_unique_nameの最初の12文字に設定されます。
        データベース名を選択する場合は、次のガイドラインを確認してください:
        • 最大12文字です
        • 英数字のみを含めます
        • 英字で始めます
        • VMクラスタ内で一意にします
  7. 「追加」をクリックします。

Data Guardアソシエーションを構成するための作業リクエストが発行されます。リクエストの進行状況およびプロビジョニングのステージは、各スタンバイ・データベースの「作業リクエスト」ページに表示できます。

アソシエーションが作成されると、データベースとそのピアの詳細に、それぞれのロールが「プライマリ」または「スタンバイ」として表示されます。

コンソールを使用したExadata VMクラスタ内のデータベースのData Guardグループの表示

Exadata VMクラスタ内のData Guardグループ内の各データベースのロールを表示するには、この手順に従います。

  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。
  2. コンパートメントを選択します。
  3. Data Guardアソシエーションでロールを表示するデータベースを含むVMクラスタをクリックします。
  4. 「データベース」をクリックします。

    このVMクラスタ内の各データベースのロールは、「Data Guardロール」列に示されます。

コンソールを使用したData Guardグループの詳細の表示および編集

デプロイしたOracle Databaseソフトウェア・ライセンス・タイプに基づいて、Data Guardタイプを切り替えることができます。

  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します。

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、Data Guardタイプを切り替えるプライマリ・データベースが含まれるVMクラスタをクリックします。
  4. プライマリ・データベースの名前をクリックします。
  5. 「Data Guardグループ」をクリックします。

    Data Guardグループのメンバーであるデータベースのリストが、Data Guardグループ・メンバーごとに選択したData Guardタイプとともに表示されます。

  6. Data Guardグループの詳細を編集するには、「アクション」アイコン(3つのドット)をクリックし、「編集」をクリックします、

    「Data Guardグループの編集」画面が表示されます。

  7. 「Data Guardグループの編集」画面で、次を実行します。
    • 該当するData Guardタイプを選択します。
    • 「保護モード」を選択します。
      ノート

      「トランスポート・タイプ」を選択します。
    • データベース・パスワードを設定します。
    • 「Data Guardの編集」をクリックして変更を保存します。

コンソールを使用したデータベース・スイッチオーバーの実行

Data Guardグループのメンバーであるスタンバイ・データベースでスイッチオーバー操作を開始できます。

  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します。

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、スイッチオーバーするプライマリ・データベースが含まれるVMクラスタをクリックします。
  4. プライマリ・データベースの名前をクリックします。
  5. 「Data Guardグループ」をクリックします。
  6. スイッチオーバーを実行するData Guardグループ内のスタンバイ・データベースを選択します。「アクション」アイコン(3つのドット)をクリックし、「スイッチオーバー」をクリックします。
  7. データベースのスイッチオーバー・ダイアログ・ボックスで、データベース管理パスワードを入力し、「スイッチオーバー」をクリックします。

これで、このデータベースはスタンバイのロールを引き継ぎ、スタンバイはData Guardグループのプライマリのロールを引き継ぐ必要があります。

コンソールを使用したデータベース・フェイルオーバーの実行

Data Guardグループのメンバーであるスタンバイ・データベースでフェイルオーバー操作を開始できます。

  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します。

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、フェイルオーバー先となるプライマリ・データベースのピア・スタンバイが含まれるVMクラスタをクリックします。
  4. スタンバイ・データベースの名前をクリックします。
  5. 「Data Guardグループ」をクリックします。
  6. フェイルオーバーを実行するData Guardグループ内のスタンバイ・データベースを選択します。「アクション」アイコン(3つのドット)をクリックし、「フェイルオーバー」をクリックします。
  7. 「データベースのフェイルオーバー」ダイアログ・ボックスで、データベース管理パスワードを入力し、「フェイルオーバー」をクリックします。
ノート

プライマリ・データベースが正常な状態であってもフェイルオーバーを開始できますが、フェイルオーバーの実行時には注意が必要です。

これで、このデータベースはプライマリのロールを引き継ぎ、古いプライマリのロールは「無効化されたスタンバイ」として表示されます。

コンソールを使用したデータベースの回復

プライマリ・データベースをスタンバイにフェイルオーバーした後、スタンバイはプライマリ・ロールを引き継ぎ、古いプライマリは無効なスタンバイとして識別されます。

障害の原因を修正した後、障害が発生したデータベースを現在のプライマリの正常なスタンバイとして回復できます。

バージョン12.2以上のデータベースを回復するには、データベースを停止するためのステップをデータベース・ホストで実行するか、それをMOUNTモードで起動する必要があります。

ORACLE_UNQNAME環境変数を「一意のデータベース名」の値に設定し、次のコマンドを実行します:
srvctl stop database -d db-unique-name -o abort
srvctl start database -d db-unique-name -o mount
  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します。

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、プライマリ・データベースが含まれるVMクラスタをクリックします。
  4. プライマリ・データベースの名前をクリックします。
  5. 「Data Guardグループ」をクリックします。

    回復するデータベースがリストされます。

  6. 「アクション」アイコン(3つのドット)をクリックし、「回復」をクリックします。
  7. 「データベースの回復」ダイアログ・ボックスで、データベース管理パスワードを入力し、「回復」をクリックします。

これで、このデータベースはData Guardグループのスタンバイとして回復されます。

コンソールを使用したOracle Exadata Database Service on Cloud@CustomerシステムでのData Guardグループの終了

VMクラスタでは、すべてのスタンバイ・データベースを終了してData Guardグループを削除します。

  1. ナビゲーション・メニューを開きます。「Oracle Database」で、「Exadata Database Service on Cloud@Customer」をクリックします。

    デフォルトでVMクラスタが選択されています。

  2. コンパートメントを選択します。

    選択したコンパートメントに対するVMクラスタのリストが表示されます。

  3. VMクラスタのリストで、終了するスタンバイ・データベースが含まれるVMクラスタをクリックします。
  4. スタンバイ・データベースの名前をクリックします。
  5. 終了するスタンバイ・データベースについて、「アクション」アイコン(3つのドット)をクリックし、「終了」をクリックします。
  6. 「データベース終了」ダイアログ・ボックスで、データベースの名前を入力し、「終了」をクリックします。

APIを使用したOracle Exadata Database Service on Cloud@CustomerシステムでのData Guardアソシエーションの管理

APIを使用して、Oracle Exadata Database Service on Cloud@CustomerシステムでData Guardアソシエーションを管理する方法について学習します。

ノート

2026年2月には、Data Guardアソシエーション・モデルとそれに関連付けられたAPIが、新しいData Guardグループ・モデルおよびAPIに置き換えられます。2026年2月以降、Oracle Cloud Infrastructure (OCI)コンソールからプロビジョニングされたすべての新しいData Guard構成で、Data Guardグループ・モデルが自動的に使用されます。

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

次の表に、Data Guardアソシエーションを管理するためのREST APIエンドポイントを示します。

操作 REST APIエンドポイント

Data Guardアソシエーションを作成します。

CreateDataGuardAssociation

指定したData Guardアソシエーションの構成情報の詳細を表示します。

GetDataGuardAssociation

指定したデータベースのすべてのData Guardアソシエーションのリストを表示します。

ListDataGuardAssociations

スイッチオーバーを実行して、Data Guardアソシエーションのプライマリ・データベースをスタンバイ・ロールに移行します。

SwitchoverDataGuardAssociation

フェイルオーバーを実行して、既存のプライマリ・データベースで障害が発生したりアクセスが不可能になった後に、databaseIdパラメータで識別されるスタンバイ・データベースを指定されたData Guardアソシエーションのプライマリ・ロールに移行します。

FailoverDataGuardAssociation

databaseIdパラメータで識別されるデータベースをData Guardアソシエーションのスタンバイ・ロールに回復します。

ReinstateDataGuardAssociation

詳細は、コンソールを使用したデータベースの回復を参照してください。

スタンバイ・データベースを削除します。

DeleteDatabase

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

APIを使用したOracle Exadata Database Service on Cloud@CustomerシステムでのData Guardグループの管理

APIを使用して、Oracle Exadata Database Service on Cloud@CustomerシステムでData Guardグループを管理する方法について学習します。

ノート

2026年2月には、Data Guardアソシエーション・モデルとそれに関連付けられたAPIが、新しいData Guardグループ・モデルおよびAPIに置き換えられます。2026年2月以降、Oracle Cloud Infrastructure (OCI)コンソールからプロビジョニングされたすべての新しいData Guard構成で、Data Guardグループ・モデルが自動的に使用されます。

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

次の表に、Data Guardグループを管理するためのREST APIエンドポイントをリストします。

操作 REST APIエンドポイント コメント

スタンバイ・データベースの作成/追加

CreateDatabase

  • 最初のスタンバイの作成およびスタンバイ・データベースの追加には、同じAPIが使用されています。
  • ソースがDATAGUARDである既存のデータベース作成APIを使用します。

Data Guardアクション- フェイルオーバー

FailoverDataGuard

フェイルオーバーは、プライマリになる各スタンバイでトリガーする必要があります。

Data Guardアクション- 回復

ReinstateDataGuard

回復するには、各スタンバイで回復をトリガーする必要があります。

Data Guardアクション- スイッチオーバー

SwitchOverDataGuard

スイッチオーバーは、プライマリになる各スタンバイでトリガーする必要があります。

スタンバイの削除

DeleteDatabase

  • スタンバイの削除は既存のものと同じままです。- DeleteDatabase
  • コールが削除される各スタンバイで実行されます。

Data Guardアソシエーションの複数のスタンバイへの移行

MigrateDataGuardAssociationToMultiDataGuards

  • 既存のData GuardアソシエーションをData Guardグループ・モデルに移行します。
  • 新しいスタンバイは、移行の完了後にのみ追加できます。

Data Guardグループ構成の更新

UpdateDataGuard

構成を更新するには、スタンバイ・データベースまたはプライマリ・データベースのOCIDが必要です。

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