Oracle AI Database用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。OCI GoldenGateのすべてのOracle AI Database、Autonomous AI Database、Oracle Exadata、Oracle Exadata ExascaleおよびAmazon RDS for OracleテクノロジのExtractを追加する方法について学習します。

ノート:手順は、GoldenGate 26aiと21cの両方のデプロイメント・コンソール・バージョンで使用できます。使用しているデプロイメント・バージョンに適した手順に従ってください。

Oracle GoldenGate 26aiでのExtractの追加

開始する前に

Oracle GoldenGateは、REDOログを使用して、ソース・トランザクションのレプリケートに必要なデータを取得します。単方向レプリケーションの場合はソース・データベースでサプリメンタル・ロギングを有効にし、双方向レプリケーションの場合はソースとターゲットの両方で有効にします:
```
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
```
TRANDATAを追加して、表レベルのサプリメンタルを有効にしてください。スキーマ・レベルのサプリメンタル・ロギングがすでに有効になっている場合は、このステップをスキップできます。

OCI GoldenGateデプロイメント・コンソールで、「DB接続」を展開し、ソース・データベースを選択します。
「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)を選択します。
「スキーマ名」にデータベース・スキーマ名を入力し、「送信」を選択します。
- Oracle GoldenGateのデータベースを準備します
- Extractについて学習およびダウンストリームExtract。

Extractの追加

OCI GoldenGateデプロイメント・コンソール・ナビゲーション・メニューで、「Extract」を選択します。
「Extract」ページで、「Extractの追加」(プラス・アイコン)を選択します。
「抽出の追加」フォームは、4つのページで構成されています。必要に応じて、「抽出の追加」フォームに入力します。
1. 「抽出情報」ページで、次の手順を実行します。
  1. 「抽出タイプ」を選択します:
    - 統合Extract
    - 初期ロードExtract
  2. 必要に応じて、「ダウンストリーム取得」を有効にします(オプション)。
  3. 「プロセス名」に8文字以内で入力します。
  4. このプロセスと他のプロセスの区別に役立つ「説明」(オプション)を入力します。
2. 「抽出オプション」ページで、必要に応じて次のフィールドに入力し、「次へ」を選択します。
  1. 「ソース資格証明」を選択します。
    - ドメイン
    - エイリアス
  2. 登録オプション
    - コミット順序番号(CSN)を入力します。
    - 「共有」で、LogMinerデータ・ディレクトリを共有する方法を選択します:
      - 自動: システムで共有方法を選択できます。
      - なし: ディクショナリを共有しません。
      - Extract名: このExtractのLogMinerディクショナリを共有します。
    - 「最適化済」を有効にしてExtract登録を最適化します。
  3. Extract証跡:
    - Extractプロセスの「名前」を入力します。
    - サブディレクトリ名を入力して、生成された証跡ファイルのカスタムの場所を設定します。
    - 「証跡順序」を入力して、証跡ファイルの開始番号を設定します。
    - 「トレイル・サイズ」を入力して、生成されるトレイル・ファイルの最大サイズを設定します。
    - 「暗号化プロファイル」を選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
    - 「暗号化のアルゴリズム」を選択します。
      - なし
      - AES256
      - AES192
      - AES128
3. 「ダウンストリーム取得」ページは、「Extract情報」ページで「ダウンストリーム取得」が選択されている場合にのみ適用されます。
4. 「管理対象オプション」ページで、必要に応じて次のオプション・フィールドに入力し、「次へ」を選択します。
  - プロファイル名
  - デプロイメントのヘルスに不可欠
  - 自動開始
  - 自動再起動
    
    ノート:プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
5. 「パラメータ・ファイル」ページでは、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。たとえば:
```
table source.table1;
```
  ノート:
  
  GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
「Create and Run」を選択すると、Extractが作成されて起動されます。「作成」を選択した場合は、後で「Extract」ページでExtractを手動で起動できます。

GoldenGate 21cでのExtractの追加

開始する前に

Oracle GoldenGateは、REDOログを使用して、ソース・トランザクションのレプリケートに必要なデータを取得します。単方向レプリケーションの場合はソース・データベースでサプリメンタル・ロギングを有効にし、双方向レプリケーションの場合はソースとターゲットの両方で有効にします:
```
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
```
TRANDATAを追加して、表レベルのサプリメンタルを有効にしてください。スキーマ・レベルのサプリメンタル・ロギングがすでに有効になっている場合は、このステップをスキップできます。
1. GoldenGateデプロイメント・コンソールにまだログインしていない場合は、ログインします。
2. ナビゲーション・メニューで、「構成」を選択します。
3. 「データベース」タブに移動し、ソース・データベースの接続アイコンを選択します。
4. 「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)を選択します。
5. 「スキーマ名」にデータベース・スキーマ名を入力し、「送信」を選択します。
Oracle GoldenGateのデータベースを準備します。

Extractの追加

OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページが表示されていることを確認し、「Extractの追加」(プラス・アイコン)を選択します。
「Extractの追加」ページで、次の手順を実行します。
1. 「Extractタイプ」で、次のいずれかを選択し、「次へ」を選択します。
  - 統合Extract
  - 初期ロードExtract
2. 「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
  1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
  2. (オプション)「説明」に、このプロセスをほかのプロセスから区別するのに役立つ簡単な説明を入力します。
  3. 「目的」で、このExtractの目的を最もよく説明するオプションを選択します:
    - 一方向(デフォルト)
    - 高可用性
    - ディザスタ・リカバリ
    - N-Way
  4. 「開始」で、Extractがデータの取得を開始するREDOまたはトランザクション・ログの場所を選択します:
    - Now
    - カスタム時間
    - CSN
  5. 「トレイル名」に、トレイル・ファイルの2文字の名前を入力します。
  6. (オプション)「トレイルのサブディレクトリ」で、生成されるトレイル・ファイルのカスタムの場所を設定します。
  7. (オプション)「トレイル・サイズ」で、生成されるトレイル・ファイルの最大サイズを設定します。
  8. 「リモート」で、ExtractトレイルをリモートOracle GoldenGateインストールに直接書き込む場合、このオプションを有効にします。
3. 「ソース・データベース資格証明」で、新しい資格証明を作成するか、ソース・データベースの既存の資格証明ドメインおよび別名を選択できます。
4. (オプション)「登録情報」で、必要に応じてフィールドに入力します:
  1. 「CSN」に、コミット順序番号(CSN)を入力します。
  2. 「共有」で、LogMinerデータ・ディクショナリを共有する方法を選択します:
    - 自動: システムで共有方法を選択できます。
    - なし: ディクショナリを共有しません。
    - Extract: このExtractのLogMinerディクショナリを共有します。
  3. 「最適化済」で、Extract登録を最適化するには、このオプションを有効にします。
  4. 「ダウンストリーム取得」で、ログ・マイニング用のダウンストリームExtractを設定するには、このオプションを有効にします。
5. 「ダウンストリーム・マイニング」で、必要に応じて次のフィールドに入力します:
  1. 「マイニング資格証明ドメイン」に、ダウンストリーム・マイニング・データベースのドメイン名を入力します。
  2. 「マイニング資格証明別名」に、ダウンストリーム・マイニング・データベースの別名を入力します
  3. 「ユーザーIDなし」で、ソース・データベース接続がない場合、このオプションを有効にします。選択すると、ADGフェッチ・オプションが有効になります。
  4. 「ADGフェッチ資格証明ドメイン」に、ADGフェッチ・データベースのドメイン名を入力します。
  5. 「ADGフェッチ資格証明別名」に、ADGフェッチ・データベースの別名を入力します。
6. (オプション)「暗号化プロファイル」で、暗号化プロファイルの説明を入力します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
  1. ドロップダウンからプロファイル名を選択します。ローカル・ウォレット・プロファイルまたはカスタム・プロファイルを選択できます。
  2. ドロップダウンから暗号化プロファイルを選択します。
  3. 暗号化プロファイルのマスターキーを指定します。
7. 管理対象オプションで、「デプロイメントのヘルスに不可欠です」を有効にすると、Oracle Cloudコンソールの「デプロイメントの詳細」ページおよびモニタリング・ダッシュボードにメトリックが表示されます。必要に応じて他のオプション・フィールドに入力します。
  
  ノート:プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
8. 「次へ」を選択します。
「Extractパラメータ」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。たとえば:
```
table source.table1;
```
ノート:

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

You’re returned to the Administration Service Overview page, where you can view the status of the Extract process. Select Details from the Extract Action menu to view process information, checkpoint, statistics, parameters, and reports.

さらに学ぶ

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