Extractの追加
特定の要件およびOracle GoldenGateで使用されるデータベースに応じて、様々なタイプのExtractの追加について学習します。
トピック:
プライマリExtractの追加
デプロイメント用にExtractを追加する準備ができました。
-
Administration Serviceの「概要」ページで、Extractの横にある+記号をクリックします。
-
作成するExtractのタイプを選択して、「次」をクリックします。
ノート:
初期ロードExtractの作成の詳細は、「初期ロードExtractを使用したインスタンス化について」を参照してください。MySQLおよびSQL Serverデータベースのチェンジ・データ・キャプチャ(CDC)のExtractを作成することもできます。「チェンジ・データ・キャプチャ(CDC)のExtractの追加」を参照してください。 -
アスタリスク(*)で指定された必須情報を指定します。「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です。 すべてのデータベース 資格証明別名 ユーザー名に対して別名を指定します。ユーザー名をパラメータ・ファイルまたはコマンドに指定したくない場合にはこのオプションを使用します。もし
を使用しない場合、別名はデフォルトでユーザーの名前になり、ログインが必要な場合に、これがパラメータ・ファイルおよびコマンドで使用される必要があります。1ユーザーに対して、それぞれ別名が異なる複数のエントリを作成できます。そのためには、ALIAS
オプションを次とともに使用しますADD USER
。ALIAS
すべてのデータベース ダウンストリーム・マイニング マイニング資格証明ドメイン ダウンストリーム・マイニング・データベースのドメイン名。 Oracle マイニング資格証明別名 マイニング・ダウンストリーム・データベースの別名。 Oracle ユーザーIDなし ソース・データベース接続がない場合は、このオプションを有効にします。このオプションを選択すると、ADGフェッチ・オプションが有効になります。 Oracle ADGフェッチ資格証明ドメイン ADGフェッチ・データベースのドメイン名。 Oracle ADGフェッチ資格証明別名 ADGフェッチ・データベースのドメイン別名。 Oracle -
(オプション)暗号化プロファイルの説明を入力します。暗号化プロファイルを作成していない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
-
リスト・ボックスからプロファイル名を選択します。「ローカル・ウォレット」またはカスタム・プロファイルを選択できます。
-
リスト・ボックスから暗号化プロファイル・タイプを選択します。
-
暗号化プロファイルのマスター・キーを指定します。このオプションは、SQL Serverには存在しません。
-
-
これは省略可能なステップです。すべてのタイプのExtractプロセスの作成時に、管理対象オプションを入力します。「管理対象プロセスの構成」を参照してください。
次の表に、これらのオプションを示します。
オプション 説明 プロファイル名 自動起動および自動再起動プロファイルの名前を指定します。デフォルトまたはカスタムのオプションを選択できます。
すでにプロファイルを作成している場合は、そのプロファイルを選択することもできます。「カスタム」オプションを選択すると、このセクション自体から新しいプロファイルを設定できます。
デプロイメントのヘルスに不可欠 (Oracleのみ)プロファイルがデプロイメントのヘルスに重要な場合は、このオプションを有効にします。ノート:このオプションは、ExtractまたはReplicatの作成時にのみ表示され、「プロファイル」ページで管理対象プロセスを設定するときには表示されません。 自動開始 プロセスの自動起動を有効にします。 開始の遅延 プロセスを開始するまでの待機時間(秒) 自動再起動 プロセスが終了した場合の再起動方法を構成します 最大再試行回数 プロセスの起動を試行する最大再試行回数を指定します 再試行の遅延 プロセスの起動を試行する際の遅延時間 再試行期間 プロセスの起動を試行する継続時間間隔 失敗時にのみ再起動 trueの場合、タスクは失敗したときにのみ再起動されます。 試行回数に達したらタスクを無効化 trueの場合、プロセスの再起動のすべての試行を空にした後で、タスクが無効化されます。 -
「次」をクリックします。
-
テキスト領域でパラメータ・ファイルを編集して、取得を検討している表の詳細を指定できます。たとえば、
table source.table1;
とします。 -
「Register Extract in the background」を選択すると、Extractをバックグラウンドで非同期で登録できます。このオプションは、OracleおよびPostgreSQLデータベースに必要です。「Extractの登録」を参照してください。
-
「作成」および「実行」をクリックして、Extractを作成および起動します。「作成」を選択するとExtractは作成されますが、起動するためには概要ページの「Extract」ドロップダウンを使用する必要があります。
Administration Serviceの「概要」ページに戻ります。Extractの詳細(プロセス情報、チェックポイント、統計、パラメータ、レポートなど)を表示するには、アクションリストを選択します。
トピック:
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
です(はい)。
「サーバー・リソースの管理」を参照してください。
親トピック: プライマリExtractの追加
チェンジ・データ・キャプチャ(CDC)のExtractの追加
次のステップでは、ソース・データベースからトランザクション・データを取得するようにCDC Extractを構成します。
CDC Extractは、SQL ServerおよびPostgreSQLデータベースで使用できます。
ノート:
通常、データベースごとに1つのExtractで十分ですが、レプリケーション・スロットが使用可能な場合は複数のExtractが許可されます。- ソース・システムの管理クライアントまたはREST APIクライアントで、Extractパラメータ・ファイルを作成します。
EDIT PARAMS extname
この例では、
extname
はプライマリExtractの名前であり、前のステップでデータベースに登録されたExtractの名前と一致しています。Oracle GoldenGate Microservicesを使用してこのタスクを実行する方法の詳細は、「プライマリExtractの追加」を参照してください。
- 次に示す順序で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.*を使用することはできません。 - 構成に推奨されるオプションのExtractパラメータを入力します。このファイルは、
EDIT PARAMS
コマンドを使用して処理を開始する前にいつでも編集できます。 - 保存してファイルを閉じます。
- Extractとそれに関連付けられた証跡ファイルを追加します。
トピック:
PostgreSQL: チェンジ・データ・キャプチャ(CDC)のExtract
PostgreSQL用のOracle GoldenGate Extractプロセスでは、PostgreSQL test_decoding
データベース・プラグインから論理レコードを受信し、それをReplicatによるダウンストリーム消費のためにコミット順序で証跡ファイルに書き込みます。
SQL Server: チェンジ・データ・キャプチャ(CDC)のExtract
SQL Server用のCDC Extractを追加する際の操作上の考慮事項は、「CDCキャプチャ方法の操作に関する考慮事項」を参照してください。
オンラインExtractグループの追加
MA Webインタフェースまたは管理クライアントのコマンドライン・インタフェースを使用して、これらのフォームにExtractグループを設定できます。この項では、ADD EXTRACT
コマンドで使用されるオプションおよびパラメータについて説明します。
トピック:
Extractグループの追加
ADD EXTRACT group
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']
説明:
-
group
は、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データベースにのみ登録する必要があります。YYYY-MM-DD HH:MM[:SS[.CCCCCC ]]
は、開始ポイントとして正確なタイムスタンプを指定するための書式です。レプリケーションまたはロギングが有効化された時点より後の開始ポイントを使用してください。
-
-
position_point
では、特定のトランザクション・ログ・ファイル内で処理を開始する特定の位置を指定します。データベースで使用する特定の構文。 -
PARAMS
pathnameは、このグループのパラメータ・ファイルをOracle GoldenGateディレクトリのdirprmサブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。 -
REPORT pathname
は、このグループのプロセス・レポートをOracle GoldenGateディレクトリのdirrpt
サブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。 -
DESC 'description'
では、グループの説明を指定します。
親トピック: オンラインExtractグループの追加
オンライン抽出用のパラメータ・ファイルの作成
次の手順に従って、オンラインExtractグループのパラメータ・ファイルを作成します。パラメータ・ファイルは、別名Extractグループには必要ありません。
- ソース・システムで、次のコマンドを発行します。
EDIT PARAMS name
説明:
name
は、ADD EXTRACT
コマンドで作成したExtractグループの名前です。または、グループの作成時に代替の場所を定義した場合は、パラメータ・ファイルの完全修飾名です。 -
次の表に表示されている順序でパラメータを入力します。パラメータ文ごとに新規行を開始します。一部のパラメータは、特定の構成にのみ適用されます。
パラメータ 説明 EXTRACT group
- groupは、
ADD EXTRACT
コマンドで作成したExtractグループの名前です。
Extractは、チェックポイント付きのオンライン・プロセスとして構成します。 [SOURCEDB dsn | container | catalog] [, USERIDALIAS alias options | , USERID user, options]
データベース接続情報を指定します。 SOURCEDB
には、ソースのデータソース名(DSN)を指定します。詳細は、参照してください。USERID
とUSERIDALIAS
で、必要に応じてデータベース資格証明を指定します。RMTHOSTOPTIONS host, MGRPORT port, [, ENCRYPT algorithm KEYNAME key_name]
ターゲット・システム、Managerが稼働しているポート、およびTCP/IP経由でのデータ暗号化(オプション)を指定します。IPを通じてリモート・システムにデータを送信する場合にのみ必要です( ADD RMTTRAIL
を使用して証跡を作成した場合)。証跡がローカル・システムに存在する場合には、必要ありません(ADD EXTTRAIL
を使用した場合)。パッシブExtractグループにも無効です。
ENCRYPTTRAIL algorithm
このエントリの後に指定した証跡がすべて暗号化されます。 LOGALLSUPCOLS
Oracleターゲットに対して統合Replicatを使用する場合、または競合検出および解決(CDR)のサポートを使用する場合に使用します。スケジューリング列のビフォア・イメージを証跡に書き込みます。(スケジューリング列は、主キー、一意索引および外部キー列です。)『Oracle GoldenGateリファレンス』の LOGALLSUPCOLS
に関する項を参照してください。SOURCECATALOG
Oracleマルチテナント・コンテナ・データベース内のデフォルト・コンテナを SEQUENCE
文に指定します。それらのデータベースに対して3つの部分からなる名前が必要とされる場合に、2つの部分からなる名前(schema.object
)を使用できるようにします。このパラメータのインスタンスを複数使用すると、TABLE
またはSEQUENCE
のパラメータの異なる組合せに対して、異なるデフォルト・コンテナまたはカタログを指定できます。SEQUENCE [container.]owner.sequence;
取得するOracleシーケンスの完全修飾名を指定します。データベースがマルチテナント・コンテナ・データベース(CDB)の場合は、コンテナ名を含めます。 TABLE [container. | catalog.]owner.object;
オブジェクトの完全修飾名(複数オブジェクトの場合は完全修飾ワイルドカード表記)を指定します。データベースがOracleマルチテナント・コンテナ・データベースの場合は、 SOURCECATALOG
が使用されていないかぎり、オブジェクト名にコンテナまたはカタログの名前を含める必要があります。パラメータ・ファイル内のオブジェクト名指定のガイドラインは、「Oracle GoldenGateの入力におけるオブジェクト名の指定」を参照してください。CATALOGEXCLUDE
SCHEMAEXCLUDE
TABLEEXCLUDE
EXCLUDEWILDCARDOBJECTSONLY
関連付けられた TABLE
文のワイルドカード表記から特定のオブジェクトを除外するために、互いに組み合せて使用できるパラメータ。 - groupは、
-
Oracle GoldenGateパラメータにリストされている適切なオプションのExtractパラメータを入力します。
-
パラメータ・ファイルを保存して閉じます。
親トピック: オンラインExtractグループの追加
Extractアクション
Extractの操作には、Extractのモニタリング詳細、チェックポイント詳細、DDL/DML統計、キャッシュ・マネージャ統計およびその他の詳細などのタスクが含まれます。
「アクション」ボタンを使用して、Extractを起動または停止するか、その詳細を表示および管理します。Extractに対して「アクション」、「詳細」オプションを選択すると、次のタスクを実行できます。
ステータスを変更すると、リストのオプションもそれに応じて変わります。ステータスが変更されると、アイコンは現在のステータスと最終ステータスを示すように変更されます。イベントは「クリティカル・イベント」表に追加されます。また、進捗を示すポップアップ通知がページの一番下に表示されます。
トピック:
Extractの詳細へのアクセス
-
プロセス情報:
選択したExtractプロセスのステータス(タイプ、資格証明、証跡の詳細(証跡名、証跡のサブディレクトリ、証跡順序、証跡サイズなど)を含む)。
-
チェックポイント:
チェックポイント・ログの名前、パス、タイムスタンプ、順序およびオフセット値。入力の詳細(開始時刻、リカバリ時、現在の状態など)をモニターできます。チェックポイントの出力値には、現在のチェックポイントの詳細が表示されます。
-
統計:
アクティブなレプリケーション・マップと、プロセスのタイプに基づいたレプリケーション統計。統計データ全体、日単位または時間単位で表示する場合は消失をソートします。
-
キャッシュ・マネージャ統計:
このページから、Extractプロセスのグローバル統計およびオブジェクト・プール統計情報にアクセスします。
-
パラメータ:
プロセスの追加時に構成されたパラメータ。鉛筆アイコンをクリックすると、パラメータを編集できます。変更が適用されたことを確認してください。
-
レポート:
プロセスの詳細レポート(パラメータ設定やトランザクションのログを含む)。レポートのテキストをコピーしてファイルに保存することで、レポートの共有やアーカイブが可能になります。
親トピック: Extractアクション
Extractの開始または停止
Administration Serviceの「概要」ページで、「アクション」、「開始」/「停止」オプションをクリックします。Extractが異常終了状態の場合は、黄色のアイコンで表示されます。緑色のアイコンはExtractが実行中であることを示し、赤色のアイコンはExtractが停止状態であることを示します。
親トピック: Extractアクション
Extractの削除
Extractを削除する手順:
-
Administration Serviceの「概要」ページの「Extract」セクションにある「アクション」、「停止」オプションを使用して、Extractを停止します。
-
「削除」をクリックしてExtractを削除します。
ノート:
「削除」オプションは、Extractが「停止済」状態の場合にのみ表示されます。親トピック: Extractアクション