MySQL用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。Extract for MySQL Database Server、HeatWave on OCI、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、およびHeatWave on Azureテクノロジを追加する方法について学習します。

Extractの追加(26ai)

Extractを追加および実行する前に、Oracle GoldenGate 26aiのデータベースを準備してください。

Oracle GoldenGate 26aiでMySQLソースのExtractを追加するには:

OCI GoldenGateデプロイメント・コンソール・ナビゲーション・メニューで、「Extract」を選択します。
「Extract」ページで、「Extractの追加」(プラス・アイコン)を選択します。
「抽出の追加」フォームは、4つのページで構成されています。必要に応じて、「抽出の追加」フォームに入力します。
1. 「Extract Information」ページで、次の手順を実行します。
  1. 抽出タイプを選択します:
    - 変更データ取得Extract
    - 初期ロードExtract
  2. プロセス名を入力します。
  3. (オプション)「説明」を入力します。
  4. 「次へ」を選択します。
2. 「抽出オプション」ページで、次の手順を実行します。
  1. 開始するタイミングを選択します。
    - Now
    - カスタム時間
    - ログでの位置
    - ログの終わり
  2. 抽出証跡の詳細を入力します。
    - 名前(2文字のみ可能)
    - サブディレクトリ
    - トレイル・サイズ
    - トレイル・シーケンス
    - 証跡オフセット
  3. ドロップダウンからソース資格証明の「ドメイン」および「別名」を選択します。
  4. 「次へ」を選択します。
3. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力し、「次へ」を選択します。
- プロファイル名
- デプロイメントのヘルスに不可欠
- 自動開始
- 自動再起動
  
  ノート:プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
1. 「パラメータ・ファイル」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。たとえば:
```
table source.table1;
```
  ノート:
  
  GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
「作成および実行」を選択すると、Extractが起動されます。「作成」を選択した場合は、後で「抽出」ページからExtractを手動で起動できます。

「Extract」ページに戻り、Extractプロセスを選択してその詳細を表示できます。

Extractの追加(21c)

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

Oracle GoldenGate 21cでMySQLデータベース用の抽出を追加するには:

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

GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
SETENVについてさらに学習します。
Extractを非同期でバックグラウンドに登録するには、「バックグラウンドでExtractを登録」を選択します。
「Create and Run」を選択すると、Extractが作成されて起動されます。「作成」を選択すると、後で管理サービスの「概要」ページからExtractを手動で起動できます。

管理サービスの「概要」ページに戻り、Extractプロセスのステータスを確認できます。Select Details from the Extract Action menu to view process information, checkpoint, statistics, parameters, and reports.

さらに学ぶ

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

MySQLからAutonomous AI Lakehouseへのデータのレプリケート

既知の問題

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の使用を参照してください。