ユーザー終了

有効な対象

Replicat

摘要

CUSEREXITパラメータを使用して、Oracle GoldenGate処理内の定義済イグジット・ポイントで、Windows DLLまたはUNIX共有オブジェクトから、Cプログラミング・コードで記述されたカスタム・イグジット・ルーチンをコールします。ユーザー・イグジット・ルーチンは、Replicatプロセスから様々なイベントと情報を受け入れ、リクエストどおりに情報を処理し、コール元(この関数をコールしたOracle GoldenGateプロセス)にレスポンスと情報を返す必要があります。

ユーザー・イグジットは、Oracle GoldenGateソリューション内で使用可能なデータ変換ファンクションのかわりとしても、こうしたファンクションと一緒にも使用できます。

ノート: 調整Replicatを使用してユーザー・イグジット・ルーチンをコールする場合、スレッドセーフの方法でユーザー・イグジットを記述する責任があります。

ユーザー・イグジットの作成および実装の詳細は、ユーザー・イグジットを使用したOracle GoldenGate機能の拡張を参照してください。

デフォルト

なし

構文

CUSEREXIT {<DLL> | <shared_object>} <routine>
[, INCLUDEUPDATEBEFORES]
[, PARAMS '<string>']

{<DLL> | <shared_object>}

ユーザー・イグジット・ファンクションを含むWindows DLLまたはUNIX共有オブジェクトの名前。

<routine>

実行するイグジット・ルーチン名。

INCLUDEUPDATEBEFORES

列値のビフォア・イメージをユーザー・イグジットに渡します。このパラメータを使用するときは、requesting_before_after_indフラグをサポートするコールバック・ファンクション内でこのフラグをBEFORE_IMAGE_VALに設定し、ビフォア・イメージを明示的にリクエストする必要があります。この設定を行わないと、アフター・イメージのみがユーザー・イグジットに渡されます。デフォルトでは、Oracle GoldenGateはアフター・イメージのみを使用します。

Replicatからコールされるユーザー・イグジットに対してINCLUDEUPDATEBEFORESを使用する場合は、常にtranlog ExtractプロセスでGETUPDATEBEFORESパラメータを使用することによって、ビフォア・イメージがトレイルに書き込まれるようにしてください。

PARAMS <'string'>

指定した文字列を起動時に渡します。プロパティ・ファイル、起動パラメータ、その他の文字列を渡すために使用できます。文字列は一重引用符で囲みます。

この文字列のデータは、EXIT_CALL_START exit_params_def.function_paramのユーザー・イグジットに渡されます。PARAMSで、引用符で囲まれた文字列が指定されない場合、exit_params_def.function_paramはNULLです。

例

例1

CUSEREXIT userexit.dll MyUserExit

例2

CUSEREXIT userexit.dll MyUserExit, PARAMS 'init.properties'

例3

CUSEREXIT userexit.dll MyUserExit, INCLUDEUPDATEBEFORES, PARAMS 'init.properties'

例4

CUSEREXIT userexit.dll MyUserExit, INCLUDEUPDATEBEFORES, &
  PARAMS 'init.properties'

例5

CUSEREXIT cuserexit.dll MyUserExit, &
  INCLUDEUPDATEBEFORES, PARAMS 'Some text to start with during startup'