MySQL用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。Learn to add an Extract for MySQL Database Server, HeatWave, Azure Database for MySQL, HeatWave on AWS, Amazon Aurora MySQL, Amazon RDS for MySQL, Amazon RDS for MariaDB, Google Cloud SQL for MySQL, SingleStoreDB, SingleStoreDB Cloud, HeatWave on AWS, and HeatWave on Azure technologies.

Extractの追加(23ai)

Extractを追加および実行する前に、Oracle GoldenGate 23ai用のデータベースを準備してください。
Oracle GoldenGate 23aiでMySQLソースのExtractを追加するには:
  1. Administration Serviceナビゲーション・メニューで、Extractsをクリックします。
  2. Extractsページで、Extractの追加」(プラス・アイコン)をクリックします。
  3. Extractの追加」フォームは、4つのページで構成されます。必要に応じて、「Extractの追加」フォームに入力します。
    1. Extractの「情報」ページで:
      1. Extractタイプを選択します:
        • Change Data Capture Extract
        • Initial Load Extract
      2. プロセス名を入力します。
      3. 「説明」を入力します(オプション)。
      4. 「次へ」をクリックします。
    2. Extractオプション・ページ:
      1. 開始するタイミングを選択します。
        • Now
        • カスタム時間
        • ログでの位置
        • ログの終わり
      2. Extract Trailの詳細を入力します。
        • 名前(2文字のみ使用できます。)
        • サブディレクトリ
        • トレイル・サイズ
        • トレイル・シーケンス
        • トレイル・オフセット
      3. ドロップダウンから「ソース資格証明」「ドメイン」および「別名」を選択します。
      4. 「次へ」をクリックします。
    3. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力します。
      1. 「プロファイル名」を選択します。
      2. 「デプロイメントのヘルスに不可欠」を有効にします。
      3. 「自動開始」を有効にします。
      4. 「自動再起動」を有効にします。
      5. 「次へ」をクリックします。
    4. 「パラメータ・ファイル」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。次に例を示します。
      table source.table1;

      ノート:

      GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、Extractのデフォルト設定をオーバーライドします。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
      setenv (TZ="US/Eastern")
      setenv (TZ="GMT+5")
  4. 「Create and Run」をクリックしてExtractを起動します。「作成」をクリックすると、後でExtractsページからExtractを手動で起動できます。
Extractsページに戻り、Extractプロセスを選択してその詳細を表示できます。

Extractの追加(21c)

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

Oracle GoldenGate 21cでMySQLデータベース用のExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページにあることを確認し、「Extractの追加」(プラス・アイコン)をクリックします。
  2. 「Add Extract」ページの「Extract Type」で、次のいずれかを選択し、「Next」をクリックします。
    • 変更データ取得
    • 初期ロード
  3. 「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
    1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
    2. (オプション)「説明」に、このプロセスを他のプロセスから区別するのに役立つ簡単な説明を入力します。
    3. 「目的」で、このExtractの目的を最適に説明するオプションを選択します:
      • 一方向(デフォルト)
      • ディザスタ・リカバリ
      • N-Way
    4. グローバル・トランザクション識別子(GTID)を使用していないMySQLデータベースからデータを取得する場合のみ、「リモート」を有効にします。
    5. 「資格証明ドメイン」で、「Oracle GoldenGate」を選択します。
    6. 「資格証明別名」で、ソースMySQL接続を選択します。
    7. For Trail Name, enter a two character name for the Trail file.
    8. (Optional) For Trail Subdirectory, set a custom location for the generated Trail file.
    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対応データベースに対するリモート変更データ取得Extractが失敗します

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

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

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