START EXTRACT
START EXTRACTでは、Extractプロセスを起動します。Extractが起動したことを確認するには、INFO EXTRACTまたはSTATUS EXTRACTコマンドを使用します。Extractは、通常開始ポイントから(初期の、または現在のチェックポイントから)開始することも、データ・ソースのユーザー指定の代替位置から開始することもできます。
通常開始ポイント
オプションなしのSTART EXTRACTでは、Extractに対し、データ整合性を維持するために、次のいずれかのデータ・ソースの場所で処理を開始するように指示されます:
-
正常終了または異常終了の後: 現在の読取りチェックポイントによって示される、前の実行におけるデータ・ソース内の最初の未処理トランザクションから。
-
グループ作成後の初回起動時:
ADD EXTRACTコマンドで指定された開始ポイント。
代替開始ポイント
ATCSNまたはAFTERCSNを使用してExtractを開始する前に、次のいずれかのコマンドで物理的な開始位置を設定する必要があります。
-
BEGINオプションがATCSNまたはAFTERCSNで指定されたCSN値より前のタイムスタンプに設定されたADD EXTRACT。その後のタイムスタンプおよびすべてのログを含むトランザクション・ログが、Extractの起動前にシステムで使用可能になっている必要があります。 -
ATCSNまたはAFTERCSNで指定されたCSNを含むログの順序番号に対するALTER EXTRACT。
構文
START EXTRACT group_name
[ATCSN csn | AFTERCSN csn]
[BRoptions]
group_name
Extractグループの名前またはワイルドカード(*) (複数のグループを指定する場合)。たとえば、T*と指定すると、名前がTから始まるすべてのExtractグループが起動されます。
ATCSN csn |
AFTERCSN csn |
代替開始ポイントを指定します。
ATCSN
Extractに対し、指定したCSNを持つ最初のトランザクションに開始ポイントを配置するように指示します。指定した値未満のCSN値を持つデータ・ソース内のトランザクションは、すべてスキップされます。
AFTERCSN
Extractに対し、指定したCSNを持つものより後の最初のトランザクションの開始時点に開始ポイントを配置するように指示します。指定した値以下のCSN値を持つデータ・ソース内のトランザクションは、すべてスキップされます。
csn
CSN値を指定します。データベースに有効なフォーマットでCSN値を入力します。フォーマットが無効な場合、Extractは異常終了し、レポート・ファイルにメッセージが書き込まれます。初期ロードの完了後に指定するCSNを決定するには、ロード・ユーティリティが完了した時点のシリアル識別子を使用します。それ以外の場合、Extractの開始時点を決定するための初期ロード手順の指示に従います。
ATCSNとAFTERCSNを使用する場合に従う追加のガイドラインを次に示します。
-
CSNは、ダウンストリーム・プロセスで使用できるようにファイル・ヘッダーに格納されます。
-
CSNで指定されたレコードが見つかると、Extractはチェックポイントを発行します。チェックポイントにより、後続のExtractの起動がリクエストされた場所から開始し、リクエストされたCSNより前のポイントからは開始しないことが保証されます。
-
ATCSNまたはAFTERCSNを使用する前に、ADD EXTRACTまたはALTER EXTRACTでExtractのトランザクション・ログまたはトレイルに物理的な開始位置を設定する必要があります。これらのオプションは、Extractがデータ・ソースの物理的な場所に配置された後に、追加のフィルタとなります。
BR options
BRオプションを使用してExtractを起動できます。次に、BRオプションの例を示します:
-
START EXTRACT BROFF -
START EXTRACT BRRESET -
START EXTRACT BRInterval# BRKEEPSTALEFILES -
START EXTRACT BRKEEPSTALEFILES -
START EXTRACT BRFSOPTION
詳細は、Oracle GoldenGateパラメータおよび機能リファレンスのBRを参照してください。
例
START EXTRACT exte
START EXTRACT exte ATCSN 684993
START EXTRACT exte AFTERCSN 684993