MySQLにExtractを追加します

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。MySQL Database Server用のExtract、OCI上のHeatWave、MySQL用のAzure Database、AWS上のHeatWave、Amazon Aurora MySQL、Amazon RDS for MySQL、MariaDB用のAmazon RDS、MySQL用のGoogle Cloud SQL、SingleStoreDB、SingleStoreDB Cloud、AWS上のHeatWaveおよびAzureテクノロジ上のHeatWaveを追加する方法について学習します。

開始する前に

Extractを追加して実行する前に、Oracle GoldenGateのシステムを準備して構成してください。

Replicatの追加(23ai)

開始する前に

中断が発生した場合に再適用するトランザクションを再取得することなく、Replicatが再起動するチェックポイント表を追加してください。

  1. OCI GoldenGateデプロイメント・コンソールで、「DB接続」を展開し、ターゲット・データベースを選択します。
  2. 「チェックポイントの追加」(プラス・アイコン)をクリックします。
  3. 「チェックポイント表」にターゲット・スキーマ名を入力し、「発行」をクリックします。
GoldenGate 23aiでMySQL用のReplicatを追加するには:
  1. 「管理サービス」ナビゲーション・メニューで、Replicatsをクリックします。
  2. Replicatsページで、Replicatの追加(プラス・アイコン)をクリックします。
  3. Replicatの追加」フォームは、4つのページで構成されます。必要に応じてフォームに入力します。
    1. Replicatの「情報」ページで、次の手順を実行します。
      1. Replicatタイプを選択します:
        • Classic Replicat
        • Coordinated Replicat
        • Parallel Replicat
        ノート

        様々なReplicatタイプについて学習します。
      2. 「次へ」をクリックします
    2. Replicatオプション・ページで、次の手順を実行します。
      1. Replicat証跡の詳細を入力します。
        • 名前(2文字のみ)
        • サブディレクトリ
      2. ターゲット資格証明の選択:
        • ドメイン
        • エイリアス
        • Checkpoint Table
        • (オプション)開始するタイミング
      3. 証跡の位置「シーケンス番号」および「RBAオフセット」を入力します。
      4. 「次へ」をクリックします
    3. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力します。
      1. 「プロファイル名」を選択します。
      2. 「デプロイメントのヘルスに不可欠」を有効にします。
      3. 「自動開始」を有効にします。
      4. 「自動再起動」を有効にします。
      5. 「次へ」をクリックします
    4. 「パラメータ・ファイル」ページでは、Replicatによるソース表とターゲット表のマップ方法を構成できます。例:
      MAP table.*, TARGET table.*;
  4. 作成および実行をクリックして、Replicatを起動します。「作成」をクリックすると、後でReplicatsページでReplicatを手動で起動できます。
Replicatsページに戻り、Replicatを選択してその詳細を表示できます。

Extractの追加(21c)

Extractを追加して実行する前に、Oracle GoldenGateのシステムを準備して構成してください。

Oracle GoldenGate 21cでMySQLデータベース用のExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページであることを確認し、「Extractの追加」(プラス・アイコン)をクリックします。
  2. 「Extractの追加」ページの「Extractタイプ」で、次のいずれかを選択し、「次」をクリックします。
    • 変更データ取得
    • 初期ロード
  3. 「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
    1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
    2. (オプション)「説明」に、このプロセスを他のプロセスから区別するのに役立つ簡単な説明を入力します。
    3. 「目的」で、このExtractの目的を最も適切に説明するオプションを選択します:
      • 一方向(デフォルト)
      • ディザスタ・リカバリ
      • N-Way
    4. グローバル・トランザクション識別子(GTID)を使用していないMySQLデータベースからデータを取得する場合のみ、「リモート」を有効にします。
    5. 「資格証明ドメイン」で、「Oracle GoldenGate」を選択します。
    6. 「資格証明別名」で、ソースMySQL接続を選択します。
    7. 「トレイル名」に、トレイル・ファイルの2文字の名前を入力します。
    8. (オプション)「トレイルのサブディレクトリ」で、生成されるトレイル・ファイルのカスタムの場所を設定します。
    9. (オプション)「トレイル・サイズ」で、生成されるトレイル・ファイルの最大サイズを設定します。
  4. (オプション)「暗号化プロファイル」で、暗号化プロファイルの説明を入力します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
    1. ドロップダウンからプロファイル名を選択します。ローカル・ウォレット・プロファイルまたはカスタム・プロファイルを選択できます。
    2. ドロップダウンから暗号化プロファイルを選択します。
    3. 暗号化プロファイルのマスターキーを指定します。
  5. (オプション)「管理対象オプション」で、次を構成できます。
    • プロファイル名
    • 自動開始
    • 自動再起動
    ノート

    プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、「管理対象プロセスの構成」を参照してください。
  6. 「次へ」をクリックします
  7. 「Extractパラメータ」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。例:
    table source.table1;
    ノート

    GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、Extractのデフォルト設定をオーバーライドします。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

    SETENVについてさらに学習します。

  8. Extractをバックグラウンドで非同期に登録するには、「バックグラウンドでExtractを登録」を選択します。
  9. 「作成および実行」をクリックして、Extractを作成および起動します。「作成」をクリックすると、後で管理サービスの「概要」ページからExtractを手動で起動できます。
管理サービスの「概要」ページに戻り、Extractプロセスのステータスを確認できます。Extractの「アクション」メニューから「詳細」を選択して、プロセス情報、チェックポイント、統計、パラメータおよびレポートを表示します。

さらに学ぶ

Extractプロセスおよびデータの取得についてさらに学習しますか。参照:

既知の問題

GTID対応データベースに対するリモート変更データ取得Extractsが失敗します

グローバル・トランザクション識別子(GTID)を使用するMySQLデータベースに対してリモート・オプションを有効にしてChange Data Capture Extractプロセスを作成すると、Extractプロセスは失敗し、次のエラーがレポートされます:
ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

回避策: Change Data Capture Extractの「パラメータ・ファイル」画面で、行TRANLOGOPTIONS ALTLOGDEST REMOTEを削除します。

詳細は、Oracle GoldenGate for MySQLの使用を参照してください。