Extractの追加

Extractを追加するための前提条件および考慮事項について学習します。

Extractの追加を開始する前に、次の設定が構成されていることを確認してください。

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

以前のExtract証跡ファイルが存在する場合のExtractの作成に関する考慮事項

抽出情報画面

マイクロサービスのホーム・ページにログインした後、「作成」列の+記号をクリックして、Extractの追加ウィザードを開きます。

「Extractの情報」画面で、Extractのタイプを選択します。データベース・プラットフォームに応じて、使用可能なExtractのタイプは、「統合Extract」、「チェンジ・データ・キャプチャExtract」および「初期ロードExtract」です。

Oracle AI DatabaseにダウンストリームExtractを設定する必要がある場合は、ダウンストリームExtractトグル・スイッチを有効にします。

作成するExtractのタイプを選択し、次を指定します。

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

「Extractの登録」画面- PostgreSQLおよびYugabyte Database

ノート: Oracle GoldenGate Extract for Oracle、異なるPostgreSQLフレーバおよびYugabyte Databaseを登録する必要があります。ただし、Extractを追加すると、Extractを登録するための構成オプションが様々な画面に表示されます。

注意: 「PGOUTPUTプラグイン・タイプのガイドラインと制限」も参照してください。

「Register Extract」画面で、次のオプションを構成し、「Register」をクリックします。

Extractの登録が成功したら、「次へ」をクリックします。

Extractが正常に登録されたことを示すメッセージが表示されます。

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

管理クライアントからのPostgreSQLおよびYugabyteデータベースのExtractの登録

PostgreSQLのExtractは、データベースに登録して、予約済レプリケーション・スロットを付与する必要があります。レプリケーション・スロットは、データベース構成設定max_replication_slotsを介して割り当てられ、データベース構成の説明に従って構成できます。

次の手順に従って、Extractを登録します。Extractの登録は、Extractを作成する前に実行する必要があります。詳細は、Oracle GoldenGateコマンド・ライン・インタフェース・リファレンスのREGISTER EXTRACTを参照してください。

  1. デプロイメントに接続してから、ソース・データベースと資格証明別名に接続してください。

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Extractを登録します。これにより、Extractのレプリケーション・スロットが内部的に作成されます。Extract名は、8文字以内の英数字にする必要があります。

    REGISTER EXTRACT *extname*

    Extractをpgoutputプラグインに明示的に登録するには、pgoutputプラグイン・タイプを指定する必要があります。

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

Oracle GoldenGate MA WebインタフェースからExtractを登録することもできます。「Extractの追加」を参照してください。

PGOUTPUTプラグイン・タイプのガイドラインおよび制限事項

PGOUTPUTプラグインタイプを構成する際のガイドライン

PostgreSQLのプラグイン・タイプを設定する場合は、次のガイドラインに従います。

制限事項

PostgreSQLのプラグイン・タイプを選択する際には、次の制限が適用されます。

「抽出オプション」画面

ノート:この画面には、Extract for Oracle AI Databaseを登録するためのオプションが表示されます。PostgreSQLのExtractを追加する場合、Extractの登録は「Extractの登録」画面で完了します。

「Extractオプション」画面で、次の設定を構成します。

管理クライアントからのOracleのExtractの登録

次の手順に従って、Extractを登録します。Extractの登録は、Extractを作成する前に実行する必要があります。

DBLOGINコマンドを使用して、データベースに接続していることを確認します。

詳細は、Oracle GoldenGateコマンドライン・インタフェース・リファレンスの[REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3)を参照してください。

  1. 管理クライアントを使用してデプロイメントに接続してから、ソース・データベースの資格証明別名に接続します。

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    CONNECTコマンドを実行すると、次の例に示すように、コマンド・プロンプトがnot connectからhttps://servername:port deployment_nameに変わります:

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. DBLOGINコマンドを使用してデータベースに接続します。

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Extractを登録します。Extract名は、8文字以内の英数字にする必要があります。

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

Oracle GoldenGate MA WebインタフェースからExtractを作成するときに、バックグラウンドで抽出を登録することもできます。詳細は、Extractの追加を参照してください。

ダウンストリーム取得画面

Oracleでのみ有効です。

Extractの情報画面で「ダウンストリーム取得」を選択した場合は、「ダウンストリーム取得」オプション画面が表示されます。この画面を使用して、ダウンストリームExtractのダウンストリーム・マイニング・データベース接続を構成します。

ノート: ADGによるダウンストリーム取得では、PDBごとのExtractはサポートされていません。

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

「管理対象オプション」画面

「管理対象オプション」画面で、Extractプロセスの自動開始および自動再起動オプションを構成します。次の表に、これらのオプションを示します:

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

オプション 摘要
プロファイル名

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

すでにプロファイルを作成している場合は、そのプロファイルも選択できます。「カスタム」オプションを選択した場合は、このセクション自体から新しいプロファイルを設定できます。
デプロイメントのヘルスに不可欠

(Oracleのみ)プロファイルがデプロイメントのヘルスにとってクリティカルな場合、このオプションを有効にします。

ノート:

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

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

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

「Extractパラメータ・ファイル」画面

「パラメータ・ファイル」画面で、テキスト領域でパラメータ・ファイルを編集して、取得を試行している表詳細をリストできます。Extractパラメータ・ファイルのサンプルを次に示します。

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

「作成および実行」をクリックして、Extractを作成および起動します。「作成」を選択した場合、Extractは作成されますが、Extractのオプションを使用して起動する必要があります。

管理サービスのホームページまたは作成したすべてのExtractがリストされる「Extract」ページに戻ります。

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

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

  1. (MySQLのみ) Windowsサーバーおよびリモート・ホスト上にあるLinuxサーバー(23.10.xより前のOGGバージョン)でMySQL用のOracle GoldenGateを実行する場合データベース・サーバーでは、タイムゾーンが同じであることを確認し、同じでない場合は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](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05)を参照してください。
    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用のその他のパラメータ・オプション

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

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

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

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

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