Oracle Database用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。Oracle Database、OCI Autonomous Databases、Oracle ExadataおよびAmazon RDS for OracleテクノロジのExtractを追加する方法について学習します。手順は、GoldenGate 23aiと21cの両方のデプロイメント・コンソール・バージョンで使用できます。デプロイメント・バージョンに適した手順に従ってください。

Extractの追加(23ai)

始める前に
  • Oracle GoldenGateは、REDOログを使用して、ソース・トランザクションのレプリケートに必要なデータを取得します。単方向レプリケーションの場合はソース・データベースでサプリメンタル・ロギングを有効にし、双方向レプリケーションの場合はソースとターゲットの両方で有効にします:
    ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
  • TRANDATAを追加して、必ず表レベルのサプリメンタルを有効にしてください。スキーマ・レベルのサプリメンタル・ロギングが有効になっている場合は、これらのステップをスキップできます。
    1. OCI GoldenGateデプロイメント・コンソールで、「DB接続」を展開し、ソース・データベースを選択します。
    2. 「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)をクリックします。
    3. 「スキーマ名」にデータベース・スキーマ名を入力し、「送信」をクリックします。
  • Oracle GoldenGateのデータベースを準備します
  • ExtractおよびダウンストリームExtractについて学習します。
Oracle GoldenGate 23aiでExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールの管理サービスのホームページで、「Extractの追加」をクリックします。
  2. 「抽出の追加」パネルの「抽出情報」ページで、必要に応じて次のフィールドに入力し、「次へ」をクリックします。
    • 「抽出タイプ」を選択します:
      • 統合Extract
      • 初期ロードExtract
    • ダウンストリーム取得を有効にします(オプション)。該当する場合
    • 「プロセス名」には8文字以内で入力します。
    • 「説明」(オプション)を入力して、このプロセスを他のプロセスと区別できるようにします。
  3. 「抽出オプション」ページで、必要に応じて次のフィールドに入力し、「次」をクリックします:
    • 「ソース資格証明」を選択します。
      • ドメイン
      • エイリアス
    • 登録オプション:
      • コミット順序番号(CSN)を入力します。
      • 「共有」で、LogMinerデータ・ディレクトリを共有する方法を選択します:
        • 自動: システムによって共有方法が選択されます。
        • なし: ディクショナリを共有しません。
        • Extract名: このExtractのLogMinerディクショナリを共有します。
      • 「最適化」を有効にしてExtract登録を最適化します。
    • Extractトレイル:
      • Extractプロセスの「名前」を入力します。
      • サブディレクトリ名を入力して、生成された証跡ファイルのカスタムの場所を設定します。
      • 「証跡順序」を入力して、証跡ファイルの開始番号を設定します。
      • 「トレイル・サイズ」を入力して、生成されるトレイル・ファイルの最大サイズを設定します。
      • 「暗号化プロファイル」を選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
      • 「暗号化アルゴリズム」を選択します。
        • なし
        • AES256
        • AES192
        • AES128
  4. 「ダウンストリーム取得」ページは、「抽出情報」ページで「ダウンストリーム取得」が選択されている場合にのみ適用されます。
  5. 「管理対象オプション」ページで、必要に応じて次のオプション・フィールドに入力し、「次」をクリックします:
    • プロファイル名
    • デプロイメントのヘルスに不可欠
    • 自動開始
    • 自動再起動

    ノート:

    プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、「管理対象プロセスの構成」を参照してください。

  6. 「パラメータ・ファイル」ページで、テキスト領域でパラメータ・ファイルを編集して、取得する表詳細をリストできます。次に例を示します。
    table source.table1;

    ノート:

    GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、Extractのデフォルト設定をオーバーライドします。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")
  7. 「作成および実行」をクリックして、Extractを作成します。If you click Create, then you can manually start the Extract later from the Administration Service Home page.

Extractの追加(21c)

始める前に
  • Oracle GoldenGateは、REDOログを使用して、ソース・トランザクションのレプリケートに必要なデータを取得します。単方向レプリケーションの場合はソース・データベースでサプリメンタル・ロギングを有効にし、双方向レプリケーションの場合はソースとターゲットの両方で有効にします:
    ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
  • TRANDATAを追加して、必ず表レベルのサプリメンタルを有効にしてください。スキーマ・レベルのサプリメンタル・ロギングが有効になっている場合は、これらのステップをスキップできます。
    1. GoldenGateデプロイメント・コンソールにまだログインしていない場合は、ログインします。
    2. ナビゲーション・メニューで「構成」をクリックします。
    3. 「データベース」タブに移動し、ソース・データベースの接続アイコンをクリックします。
    4. 「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)をクリックします。
    5. 「スキーマ名」にデータベース・スキーマ名を入力し、「送信」をクリックします。
  • Oracle GoldenGateのデータベースを準備します。
GoldenGate 21cでOracle Database用のExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページにあることを確認し、「Extractの追加」(プラス・アイコン)をクリックします。
  2. 「Add Extract」ページの「Extract Type」で、次のいずれかを選択し、「Next」をクリックします。
    • 統合Extract
    • 初期ロードExtract
  3. 「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
    1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
    2. (オプション)「説明」に、このプロセスを他のプロセスから区別するのに役立つ簡単な説明を入力します。
    3. 「目的」で、このExtractの目的を最適に説明するオプションを選択します:
      • 一方向(デフォルト)
      • 高可用性
      • ディザスタ・リカバリ
      • N-Way
    4. 「開始」で、Extractがデータの取得を開始するREDOまたはトランザクション・ログの場所を選択します:
      • Now
      • カスタム時間
      • CSN
    5. For Trail Name, enter a two character name for the Trail file.
    6. (Optional) For Trail Subdirectory, set a custom location for the generated Trail file.
    7. 「トレイル・サイズ」で、生成されるトレイル・ファイルの最大数を設定します。
    8. 「リモート」で、ExtractトレイルをリモートのOracle GoldenGateインストールに直接書き込む場合、このオプションを有効にします。
  4. 「ソース・データベース資格証明」で、新しい資格証明を作成するか、ソース・データベースの既存の資格証明ドメインおよび別名を選択できます。
  5. (オプション)「登録情報」で、必要に応じてフィールドに入力します:
    1. 「CSN」に、コミット順序番号(CSN)を入力します。
    2. 「共有」で、LogMinerデータ・ディクショナリを共有する方法を選択します:
      • 自動: システムによって共有方法が選択されます。
      • なし: ディクショナリを共有しません。
      • Extract: LogMinerディクショナリをこのExtractと共有します。
    3. 「最適化済」で、Extract登録を最適化するには、このオプションを有効にします。
    4. 「ダウンストリーム取得」で、ログ・マイニング用のダウンストリームExtractを設定するには:
  6. 「ダウンストリーム・マイニング」で、必要に応じて次のフィールドに入力します:
    1. 「マイニング資格証明ドメイン」に、ダウンストリーム・マイニング・データベースのドメイン名を入力します。
    2. 「マイニング資格証明別名」に、ダウンストリーム・マイニング・データベースの別名を入力します
    3. 「UserIDなし」で、ソース・データベース接続がない場合、このオプションを有効にします。選択すると、ADGフェッチ・オプションが有効になります。
    4. 「資格証明ドメインのフェッチ」に、ADGフェッチ・データベースのドメイン名を入力します。
    5. 「ADGフェッチ資格証明別名」に、ADGフェッチ・データベースの別名を入力します。
  7. (オプション)「暗号化プロファイル」で、暗号化プロファイルの説明を入力します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
    1. ドロップダウンからプロファイル名を選択します。ローカル・ウォレット・プロファイルまたはカスタム・プロファイルを選択できます。
    2. ドロップダウンから暗号化プロファイルを選択します。
    3. 暗号化プロファイルのマスターキーを指定します。
  8. 「管理対象オプション」で、「デプロイメントのヘルスに不可欠」を有効にすると、Oracle Cloudコンソールの「デプロイメントの詳細」ページおよびモニタリング・ダッシュボードにメトリックが表示されます。必要に応じて他のオプション・フィールドに入力します。

    ノート:

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

    ノート:

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

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

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

さらに学ぶ

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