機械翻訳について

パイプライン・リソースの作成

パイプラインの使用に必要なリソースの作成について学習します。

接続の作成

OCI GoldenGateパイプラインは、現在、専用エンドポイントおよびmTLS認証を使用するOracle Autonomous AI Databaseのみをサポートしています。 最適な結果を得るには、ソース・データベースとしてAutonomous AI Transaction Processingを使用し、ターゲット・データベースとしてAutonomous AI Lakehouseを使用します。

パイプラインを作成する前に、まずデータベースをGoldenGate用に準備してから、ソース・データベースとターゲット・データベースへの接続を作成してください。 「Oracle Autonomous AI Databaseへの接続」を参照してください。

パイプラインの作成

始める前に:
次のことに注意してください。
  • ZeroETLミラー化による主キーの問題を回避するために、データベース表全体で行の一意性をレビューおよび構成します。 主キーは、データベース表のレコードまたは行を一意に識別します。 「ソース表とターゲット表での行の一意性の確保」を参照してください。
  • ターゲット・データベースの管理権限を持つユーザーとして、GGADMINユーザーにZeroETLミラー化のための次の権限を付与します:
    GRANT DWROLE TO GGADMIN;
    GRANT DATAPUMP_CLOUD_EXP TO GGADMIN;
    GRANT DATAPUMP_CLOUD_IMP TO GGADMIN;
    GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO GGADMIN;
    GRANT CREATE DATABASE LINK TO GGADMIN;
  • ソース・データベースのDBA_GOLDENGATE_SUPPORT_MODEビューで、データベース内の表に対するOracle GoldenGate取得プロセスのサポート・レベルに関する情報を表示します。
  • GoldenGateパイプラインの「最小限必要なポリシー」を追加します。
  • パイプラインに使用しているソース接続とターゲット接続には、「専用」エンドポイントがあります。
パイプラインを作成するには:
  1. OCI GoldenGateの「概要」ページのGoldenGateメニューで、「パイプライン」をクリックします。

    または、「データFabric」「パイプラインの作成」の順にクリックします。

  2. 「パイプライン」ページで、「パイプラインの作成」をクリックします。
  3. 「パイプラインの作成」パネルで、次のようにフィールドに入力し、パイプラインの作成をクリックします:
    1. 「名前」に、パイプラインの名前を入力します。
    2. (オプション) 「説明」に、このパイプラインと他のパイプラインの区別に役立つ説明を入力します。
    3. 「コンパートメント」で、パイプラインを作成するコンパートメントを選択します。
    4. ライセンス・タイプを選択します。
    5. ドロップダウンからソース接続とターゲット接続を選択します。

      ノート:

      現在、パイプラインは専用エンドポイントとの接続のみをサポートしています。
    6. (オプション)詳細オプションの表示をクリックして、プロセス・オプションを構成します:
      • 進行中のレプリケーションの前に既存のデータをコピー: データの初期ロードを実行するには、このオプションを選択します。 既存の表の場合、次の操作を選択できます:
        • 切捨て: 既存の行を削除してから、ソースから行をロードします。
        • 置換: 既存の表を削除してから、作成してソースからロードします。
        • 追加: 既存の行を変更せずに残し、ソースから行をロードします。
        • スキップ: 表をそのままにして、次のオブジェクトに移動します。
      • スキーマ変更(DDL)の置換: 選択した場合、プロセスでエラーが発生したときに既存のスキーマに対して実行するアクションを選択します:
        • 終了: トランザクションをロールバックし、処理を停止します。
        • 破棄: エラーを破棄ファイルに記録し、処理を続行します。
        • 無視: エラーを無視して処理を続行します。
      • DMLエラー時のアクション: プロセスでDMLエラーが発生したときに既存のデータに対して実行するアクションを選択します:
        • 終了
        • Discard
        • 無視
      • 失敗後に再起動: プロセスがなんらかの理由で停止した場合に自動再起動を有効にするには、このオプションを選択します。
      • デフォルト・マッピングを使用してパイプラインを開始: デフォルトの1:1マッピング・ルールを使用して、作成直後にパイプラインを開始します。 選択しない場合、作成後にルール・マッピングを構成し、パイプラインを手動で開始できます。

マッピング・ルールの追加

マッピング・ルールをプレビュー、追加または削除するには:
  1. 「パイプライン情報」ページで、「マッピング・ルール」を選択します。
  2. 「マッピング・ルール」リストでは、現在のマッピング・ルールを確認または編集し、次の操作を実行できます:
    • プレビュー: マッピング・ルールがレプリケーションに含まれるスキーマおよび表にどのように影響するかを確認します。
    • 追加: 含める、または除外する表およびスキーマを識別します。 オブジェクト名の任意の部分のかわりに、完全修飾オブジェクト名またはワイルドカードを使用できます。 詳細は、データベース・オブジェクト名でのワイルドカードの使用を参照してください。
    • 削除: マッピング・ルールを削除します。

パイプライン・ログの有効化

  1. 「パイプライン」ページで、ロギングを有効にするパイプラインを選択します。
  2. 「パイプライン詳細」ページで、「ログ」を選択します。
  3. パイプライン・ログのリストで、「クリティカル・イベント」「アクション」メニューから「ログの有効化」を選択します。
  4. ログの有効化パネル:
    1. 「ログ名」に、名前を入力します。
    2. 「コンパートメント」ドロップダウンから、コンパートメントを選択します。
    3. ログ・グループでは、次のことができます:
      • ドロップダウンからグループを選択
      • 新規グループの作成
      • 空白のままにすると、デフォルト・グループが自動的に割り当てられます
    4. 「ログの保持」で、ドロップダウンから月数を選択します。
    5. 「ログの有効化」をクリックします。
ステータスが「アクティブ」になるまで待ちます。

パイプラインを開始します

パイプラインを開始するには:
  1. パイプラインの詳細ページの「アクション」メニューから、「開始」を選択します。
  2. パイプラインの詳細ページで、「初期化」を選択します。

    初期化ステップには、パイプライン・ステップの現在のステータスが表示されます。 ステップごとに、「アクション」メニューから「詳細の表示」を選択し、対応するメッセージを確認できます。

  3. パイプラインのステータスが「アクティブ」(実行中)になったら、「ランタイム」を選択します。

    ランタイム・プロセスには、取得および適用プロセスの状態と待機時間が表示されます。

既知の問題

ZeroETLパイプライン適用のミラー化プロセスの失敗

パイプライン適用プロセスが、OCIロギングで次のエラーで失敗した場合:
Error mapping from ADMIN.DBTOOLS$EXECUTION_HISTORY to <ADB ID>.ADMIN.DBTOOLS$EXECUTION_HISTORY.

回避策: ADMIN.*を使用して除外ルールを作成し、パイプラインを再起動します。

ターゲット・データベースのタイムゾーン・ファイルのバージョンがソース・データベースより低い場合、Oracle Data Pumpは失敗

パイプライン・オプション「レプリケーションを開始する前に既存のデータをターゲット・データベースにコピー」では、Oracle Data Pumpが使用されます。 ターゲット・データベースのタイムゾーン・ファイルのバージョンがソース・データベースのバージョンより低い場合、Oracle Data Pumpは失敗します。

回避策: これを回避するには、ターゲット・データベースのタイム・ゾーン・バージョンをアップグレードする必要があります。 「Autonomous Databaseでのタイムゾーン・ファイルの更新の管理」を参照してください。