Extractの追加

特定の要件およびOracle GoldenGateで使用されるデータベースに応じて、様々なタイプのExtractの追加について学習します。

プライマリExtractの追加

データベース資格証明の追加のステップを使用して、Extractを作成および実行するためのデータベース資格証明を設定します。

デプロイメント用にExtractを追加する準備ができました。

  1. Administration Serviceの「概要」ページで、Extractの横にある+記号をクリックします。

  2. 作成するExtractのタイプを選択して、「次」をクリックします。

    ノート:

    初期ロードExtractの作成の詳細は、「初期ロードExtractを使用したインスタンス化について」を参照してください。MySQLおよびSQL Serverデータベースのチェンジ・データ・キャプチャ(CDC)のExtractを作成することもできます。「チェンジ・データ・キャプチャ(CDC)のExtractの追加」を参照してください。

  3. アスタリスク(*)で指定された必須情報を指定します。「Extractの追加」画面の様々なセクションのオプションの説明を次に示します。

    オプション 説明 データベース
    基本情報セクション
    プロセス名 Extractプロセスの名前Extractプロセスの名前は最大8文字です。 すべてのデータベース
    説明 作成するExtractプロセスの説明。 すべてのデータベース
    目的 Extractを作成する目的について説明します。デフォルト・オプションは「一方向」です。その他のオプションには、「高可用性」、「障害回復」、「N-Way」がありますが、これらは情報提供のみです。 すべてのデータベース
    開始 Extractがデータの取得を開始するREDOログまたはトランザクション・ログ内の開始位置を設定するために使用されます。使用可能なオプションは、サポートされているデータベースに応じて、「今すぐ」、「カスタム時間」、「CSN」、「ログでの位置」および「EOF」です。 すべてのデータベース
    トレイル名 2文字の証跡名。 すべてのデータベース
    トレイルのサブディレクトリ、サイズ、順序およびオフセット 証跡の詳細をさらに細かく構成できます。 すべてのデータベース
    リモート

    Extract証跡がリモートの場合は、このオプションを有効にします。

    Oracleデータベースでは、Extract証跡をリモートのOracle GoldenGate Classicインストールに直接書き込む場合、このオプションを有効にします。

    MySQLでは、このオプションを設定すると、TRANLOGOPTIONS ALTLOGDEST REMOTEパラメータでリモートExtractをサポートできますが、証跡には関連しません。

    		Oracle、MySQL
    登録情報セクション
    CSN コミット順序番号(CSN)値 Oracle
    共有 LogMinerデータ・ディクショナリを共有する方法を選択します。オプションは次のとおりです。
    • 自動: このオプションを使用すると、ディクショナリを共有する方法を選択できます。
    • なし: このオプションを選択すると、ディクショナリを共有できません。
    • Extract: 特定のExtractに対してLogMinerディクショナリの共有を許可する場合は、このオプションを選択します。
    		 Oracle
    最適化済 Extract登録を最適化するには、このオプションを有効にします。 Oracle
    ダウンストリーム取得 ログ・マイニング用のダウンストリームExtractを設定するには、このオプションを有効にします。 Oracle
    登録のみ このオプションは、Extractを登録するだけで、Extractを追加しない場合に使用します。登録では、Extractの登録時または「登録のみ」オプションの使用時にレプリケーション・スロットが作成されます。 PostgreSQL
    ソース・データベース資格証明
    新規資格証明の作成 データベース・ログイン資格証明を設定していない場合は、ここからデータベース・ログイン資格証明を作成して保存できます。 すべて
    資格証明ドメイン データベースのドメインを作成します。 すべて
    資格証明別名 データベース・ログインの資格証明を指定します。 すべて
    ユーザーID データベースにログインするためのユーザー名を指定します。 すべて
    「パスワード」、「パスワードの確認」 データベースへのログインに使用するパスワードを入力し、確認のためにパスワードを再入力します。 すべて
    資格証明ドメイン 指定したドメイン名の下に資格証明ユーザーを保存できます。同じ別名を、同じ資格証明ストアを使用する複数のOracle GoldenGateインストールが使用できるようにします。デフォルトのドメインはOracle GoldenGateです。 すべてのデータベース
    資格証明別名 ユーザー名に対して別名を指定します。ユーザー名をパラメータ・ファイルまたはコマンドに指定したくない場合にはこのオプションを使用します。もし 
    ALIAS
    を使用しない場合、別名はデフォルトでユーザーの名前になり、ログインが必要な場合に、これがパラメータ・ファイルおよびコマンドで使用される必要があります。1ユーザーに対して、それぞれ別名が異なる複数のエントリを作成できます。そのためには、 
    ADD USER
    オプションを次とともに使用します 
    ALIAS
    。    		 すべてのデータベース
    ダウンストリーム・マイニング
    マイニング資格証明ドメイン ダウンストリーム・マイニング・データベースのドメイン名。 Oracle
    マイニング資格証明別名 マイニング・ダウンストリーム・データベースの別名。 Oracle
    ユーザーIDなし ソース・データベース接続がない場合は、このオプションを有効にします。このオプションを選択すると、ADGフェッチ・オプションが有効になります。 Oracle
    ADGフェッチ資格証明ドメイン ADGフェッチ・データベースのドメイン名。 Oracle
    ADGフェッチ資格証明別名 ADGフェッチ・データベースのドメイン別名。

    ノート:

    ADGを使用したダウンストリーム取得では、PDBごとのExtractはサポートされていません。
    		Oracle

  4. (オプション)暗号化プロファイルの説明を入力します。暗号化プロファイルを作成していない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。

    1. リスト・ボックスからプロファイル名を選択します。「ローカル・ウォレット」またはカスタム・プロファイルを選択できます。

    2. リスト・ボックスから暗号化プロファイル・タイプを選択します。

    3. 暗号化プロファイルのマスター・キーを指定します。このオプションは、SQL Serverには存在しません。

  5. これは省略可能なステップです。すべてのタイプのExtractプロセスの作成時に、管理対象オプションを入力します。「管理対象プロセスの構成」を参照してください。

    次の表に、これらのオプションを示します。

    オプション 説明
    プロファイル名

    自動起動および自動再起動プロファイルの名前を指定します。デフォルトまたはカスタムのオプションを選択できます。

    すでにプロファイルを作成している場合は、そのプロファイルを選択することもできます。「カスタム」オプションを選択すると、このセクション自体から新しいプロファイルを設定できます。
    デプロイメントのヘルスに不可欠 (Oracleのみ)プロファイルがデプロイメントの状態にとって重要な場合、このオプションを有効にします。

    ノート: このオプションは、ExtractまたはReplicatの作成時にのみ表示され、「プロファイル」ページで管理対象プロセスを設定する場合には表示されません。

    自動開始 プロセスの自動起動を有効にします。
    開始の遅延 プロセスを開始するまでの待機時間(秒)
    自動再起動 プロセスが終了した場合の再起動方法を構成します
    最大再試行回数 プロセスの起動を試行する最大再試行回数を指定します
    再試行の遅延 プロセスの起動を試行する際の遅延時間
    再試行期間 プロセスの起動を試行する継続時間間隔
    失敗時にのみ再起動 trueの場合、タスクは失敗したときにのみ再起動されます。
    試行回数に達したらタスクを無効化 trueの場合、プロセスの再起動のすべての試行を空にした後で、タスクが無効化されます。

  6. 「次」をクリックします。

  7. テキスト領域でパラメータ・ファイルを編集して、取得を検討している表の詳細を指定できます。たとえば、table source.table1;とします。

  8. 「Register Extract in the background」を選択すると、Extractをバックグラウンドで非同期で登録できます。このオプションは、OracleおよびPostgreSQLデータベースに必要です。「Extractの登録」を参照してください。

  9. 「作成」および「実行」をクリックして、Extractを作成および起動します。「作成」を選択するとExtractは作成されますが、起動するためには概要ページの「Extract」ドロップダウンを使用する必要があります。

    Administration Serviceの「概要」ページに戻ります。Extractの詳細(プロセス情報、チェックポイント、統計、パラメータ、レポートなど)を表示するには、アクションリストを選択します。

Extractのパラメータ・ファイルの作成

Extractのパラメータ・ファイルを作成するには、次の手順に従います。

  1. (MySQLのみ) データベース・サーバーから見てリモートのホストにあるWindowsサーバーおよびLinuxサーバーでOracle GoldenGate for MySQLを実行する場合(21.20.xより前のOGGバージョンの場合)は、それらのタイム・ゾーンが同じであることを確認し、そうでない場合は、Extract内のSETENV(TZ)パラメータを使用して、データベース・サーバーのタイム・ゾーンに設定します。

    TZ形式および詳細については、パラメータおよび関数リファレンス・ガイドのSETENVパラメータを参照してください。

    参照情報は次のリンクを参照してください:

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. ソース・システムで、次のコマンドを発行します。

    EDIT PARAMS extract_name

    説明:

    extract_nameは、ADD EXTRACTコマンドで作成したExtractの名前です。または、グループの作成時に代替の場所を定義した場合は、パラメータ・ファイルの完全修飾名です。

  3. 次の表に表示されている順序でパラメータを入力します。パラメータ文ごとに新規行を開始します。一部のパラメータは、特定の構成にのみ適用されます。

    パラメータ 説明
    EXTRACT group
    • groupは、ADD EXTRACTコマンドで作成したExtractグループの名前です。

    Extractは、チェックポイント付きのオンライン・プロセスとして構成します。
    [, USERIDALIAS alias options ]

    データベース資格証明を指定するには、USERIDALIASを参照してください。

    ENCRYPTTRAIL algorithm

    このエントリの後に指定した証跡がすべて暗号化されます。
    SOURCECATALOG

    Oracleマルチテナント・コンテナ・データベース内のデフォルト・コンテナをSEQUENCE文に指定します。それらのデータベースに対して3つの部分からなる名前が必要とされる場合に、2つの部分からなる名前(schema.object)を使用できるようにします。このパラメータのインスタンスを複数使用すると、TABLEまたはSEQUENCEのパラメータの異なる組合せに対して、異なるデフォルト・コンテナまたはカタログを指定できます。

    TABLE [container. | catalog.]owner.object | schema.object | library/file | library/file(member);

    オブジェクトの完全修飾名(複数オブジェクトの場合は完全修飾ワイルドカード表記)を指定します。データベースがOracleマルチテナント・コンテナ・データベースの場合は、SOURCECATALOGが使用されていないかぎり、オブジェクト名にコンテナまたはカタログの名前を含める必要があります。

    • schemaは、スキーマ名またはスキーマのワイルドカード・セットです。

    • objectは表名またはワイルドカードを使用した表のセットです。

    • libraryは、IBM iライブラリ名またはワイルドカードを使用したライブラリのセットです。

    • fileは、IBM i物理ファイル名またはワイルドカードを使用した物理ファイルのセットです。

    • memberは、IBM i物理ファイル・メンバー名またはワイルドカードを使用したメンバー名のセットです。IBM iネイティブ名の形式(オプション・メンバーを含むライブラリ/ファイル)を使用する場合、有効なワイルドカードは、少なくとも1つの有効な文字の後に末尾のアスタリスク(*)または*ALLが続く名前のみです。

    ノート:

    メンバー名はオプションであり、オブジェクト名の一部として証跡にメンバー名を書き込む必要がある場合に指定する必要があります。メンバー名を指定しない場合、物理ファイル内のすべてのメンバーは、証跡内の単一のオブジェクトとして暗黙的にマージされます。

    パラメータ・ファイル内のオブジェクト名を指定するためのガイドラインは、「Oracle GoldenGateの入力におけるオブジェクト名の指定」を参照してください。

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    関連付けられたTABLE文のワイルドカード表記から特定のオブジェクトを除外するために、互いに組み合せて使用できるパラメータ。

  4. Oracle GoldenGateパラメータにリストされている適切なオプションのExtractパラメータを入力します。

  5. パラメータ・ファイルを保存して閉じます。

次のExtractパラメータ・ファイルのサンプルでは、Extractの様々な構成パラメータおよびオプションについて説明します。

ADD EXTRACT extract_name
{, datasource} 
{, BEGIN start_point} | {position_point} 
[, PARAMS pathname] 
[, REPORT pathname] 
[, DESC 'description']

  • extract_nameは、Extractグループの名前です。グループ名は必須です。

  • datasourceは、抽出するデータのソースを指定する場合に必要です。次のいずれかを使用します。

    • TRANLOGでは、データソースとしてトランザクション・ログを指定します。Oracle Enterprise Editionでこのオプションを使用する場合は、ADD EXTRACTを使用する前に(かつ、DELETE EXTRACTを発行してExtractグループを削除する前に)、Extractデータベース・ユーザー(または同じ権限を持つユーザー)としてDBLOGINコマンドを発行する必要があります。

      Db2 z/OSのbsdsオプションを使用して、トランザクション・ログのブートストラップ・データセットのファイル名を指定します。

    • INTEGRATED TRANLOGでは、このExtractが統合キャプチャ・モードで動作して、Oracle Databaseログマイニング・サーバーから論理変更レコード(LCR)を受信することを指定します。このパラメータは、Oracleデータベースにのみ適用されます。

    • EXTTRAILSOURCE trail_nameでは、ローカル証跡の相対名または完全修飾名を指定します。

  • BEGIN start_pointでは、処理のための初期チェックポイントおよび開始ポイントを確定してオンラインExtractグループを定義します。このポイントより前に開始されたトランザクションは、破棄されます。次のいずれかを使用します。

    • NOWは、グループを作成するためにADD EXTRACTコマンドが実行された時点(統合モードのExtractの場合は、REGISTER EXTRACTコマンドに登録された時点から)のタイムスタンプが指定された変更の抽出を開始します。Extractは、OracleおよびPostgreSQLデータベースにのみ登録する必要があります。

      Timestamp: 開始ポイントとして正確なタイムスタンプを指定するための書式です。レプリケーションまたはロギングが有効化された時点より後の開始ポイントを使用してください。

      次の例は、特定のタイムスタンプを使用したExtractの再配置を示しています。
      OGG (http://localhost:11000 ggeast as pdb1@east.oracle.com) 95> dblogin useridalias ggma

Successfully logged into database PDB1.
      OGG (http://localhost:11000 ggeast as ggma@ggeast/PDB1) 96> alter extract exte , begin 2024-05-03T03:48:00Z

2024-05-03T03:50:49Z  INFO    OGG-08100  Extract exte I/O position is altered and reposition to older date and time position 2024-05-03 03:48:00.000000 current date and time position 2024-05-03 03:49:04.000000. 
Duplicate transactions are filtered out. Perform output trail ETROLLOVER if duplicate transaction output is desired, or Extract configuration was updated.
2024-05-03T03:50:49Z  INFO    OGG-08100  Extract altered.

  • position_pointでは、特定のトランザクション・ログ・ファイル内で処理を開始する特定の位置を指定します。データベースで使用する特定の構文。

  • PARAMS pathnameは、このグループのパラメータ・ファイルをOracle GoldenGateディレクトリのdirprmサブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。

  • REPORT pathnameは、このグループのプロセス・レポートをOracle GoldenGateディレクトリのdirrptサブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。

  • DESC 'description'では、グループの説明を指定します。

Extract用のその他のパラメータ・オプション

Extract構成に必要なその他のパラメータについて学習します。

Extractでは、マイニング・データベースのデータベース・ログマイニング・サーバーを使用して、ソース・データベースのREDOストリームをマイニングします。Extractパラメータ・ファイルでINTEGRATEDPARAMSオプションを指定してTRANLOGOPTIONSパラメータを使用することで、ログマイニング・サーバーに固有のパラメータを設定できます。

ノート:

これらのパラメータの詳細情報と使用方法は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』の「DBMS_CAPTURE_ADM」を参照してください。

INTEGRATEDPARAMSとともに設定できるパラメータは、次のとおりです。

  • CAPTURE_IDKEY_OBJECTS: FETCHでサポートされるオブジェクトのキャプチャを制御します。Oracle GoldenGateのデフォルトはYです(キャプチャIDキーの論理変更レコード)。

  • DOWNSTREAM_REAL_TIME_MINE: ログマイニング・サーバーが、リアルタイムのダウンストリーム・キャプチャ・プロセスとして動作するか、アーカイブ・ログのダウンストリーム・キャプチャ・プロセスとして動作するかを制御します。デフォルトはNです(アーカイブ・ログ・モード)。ダウンストリーム・ログマイニング・サーバー構成でリアルタイム・キャプチャを使用するには、このパラメータを指定します。ダウンストリーム・マイニング構成の設定の詳細は、「ダウンストリーム・データベース・マイニングのダウンストリームExtract」を参照してください。

  • INLINE_LOB_OPTIMIZATION: LOBチャンクLCRを送信するかわりに、インラインで処理できるLOB (小さいLOBなど)をLCRに直接含めるかどうかを制御します。Oracle GoldenGateのデフォルトはYです(はい)。

  • MAX_SGA_SIZE: ログマイニング・サーバーで使用される共有メモリーの量を制御します。共有メモリーはSGAのStreamsプールから取得されます。デフォルトは1GBです。

  • PARALLELISM: ログマイニング・サーバーで使用されるプロセスの数を制御します。デフォルトは2です。Oracle Standard Editionの場合は、1に設定する必要があります。

  • TRACE_LEVEL: Extractログマイニング・サーバーのトレース・レベルを制御します。Oracleサポートの指示を受ける場合のみ使用します。Oracle GoldenGateのデフォルトは0です(トレースなし)。

  • WRITE_ALERT_LOG: Extractログマイニング・サーバーがOracleアラート・ログにメッセージを書き込むかどうかを制御します。Oracle GoldenGateのデフォルトはYです(はい)。

「サーバー・リソースの管理」を参照してください。

チェンジ・データ・キャプチャ(CDC)のExtractの追加

次のステップでは、ソース・データベースからトランザクション・データを取得するようにCDC Extractを構成します。

CDC Extractは、SQL ServerおよびPostgreSQLデータベースで使用できます。

ノート:

通常、データベースごとに1つのExtractで十分ですが、レプリケーション・スロットが使用可能な場合は複数のExtractが許可されます。
  1. ソース・システムの管理クライアントまたはREST APIクライアントで、Extractパラメータ・ファイルを作成します。EDIT PARAMS extname

    この例では、extnameはプライマリExtractの名前であり、前のステップでデータベースに登録されたExtractの名前と一致しています。

    Oracle GoldenGate Microservicesを使用してこのタスクを実行する方法の詳細は、「プライマリExtractの追加」を参照してください。

  2. 次に示す順序でExtractパラメータを入力します。パラメータ文ごとに新しい行を開始します。Microservicesインストール用のExtractの基本パラメータの例は、次のとおりです。
    EXTRACT extname
SOURCEDB dsn_name 
USERIDALIAS alias
EXTTRAIL ep
GETTRUNCATES
TABLE schema.*;
    パラメータ 説明
    EXTRACT extname extnameはExtractの名前で、長さが英数字8文字を超えることはできません。詳細は、Oracle GoldenGateリファレンスのextractを参照してください。
    SOURCEDB dsn_name データベース接続DSNの名前を指定します。
    USERIDALIAS alias Extractに割り当てられるユーザーのデータベース・ログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。
    EXTTRAIL trailname プライマリExtractによって取得されたデータが書き込まれる2文字のローカル証跡を指定します。
    GETTRUNCATES オプションのパラメータですが、切捨て操作を取得するために必要です。

    TABLE schema.object;

    または

    TABLE schema.*;     		データをキャプチャするデータベース・オブジェクトを指定します。
    • TABLEは、表または表のワイルドカード・セットを指定します。
    • schemaは、スキーマ名またはスキーマのワイルドカード・セットです。
    • objectは、表または順序名、またはこれらのオブジェクトのワイルドカード・セットです。
    • *は、スキーマ内のすべての表に対するワイルドカードです。

    パラメータ文はセミコロンで終了します。

    名前をワイルドカード指定から除外するには、必要に応じて、SCHEMAEXCLUDE、TABLEEXCLUDEおよびEXCLUDEWILDCARDOBJECTSONLYパラメータを使用します。

    ノート:

    取得する表のスキーマがGLOBALSファイルのGGSCHEMAにあるスキーマと同じ場合(推奨されません)、TABLE文でschema.*を使用することはできません。
  3. 構成に推奨されるオプションのExtractパラメータを入力します。このファイルは、EDIT PARAMSコマンドを使用して処理を開始する前にいつでも編集できます。
  4. 保存してファイルを閉じます。
  5. Extractとそれに関連付けられた証跡ファイルを追加します。

PostgreSQL: チェンジ・データ・キャプチャ(CDC)のExtract

PostgreSQL用のOracle GoldenGate Extractプロセスでは、PostgreSQL test_decodingデータベース・プラグインから論理レコードを受信し、それをReplicatによるダウンストリーム消費のためにコミット順序で証跡ファイルに書き込みます。

SQL Server: チェンジ・データ・キャプチャ(CDC)のExtract

SQL Server用のCDC Extractを追加する際の操作上の考慮事項は、「CDCキャプチャ方法の操作に関する考慮事項」を参照してください。