CUSEREXIT

有效對象

Replicat

說明

使用 CUSEREXIT 參數，從 Windows DLL 或 UNIX 共用物件呼叫以 C 程式碼撰寫的自訂結束常式，該物件位於 Oracle GoldenGate 處理中定義的結束點。您的使用者結束常式必須能夠接受來自 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 時，一律使用 GETUPDATEBEFORES 參數進行 tranlog Extract 處理作業，以便將先前的影像寫入歷程檔。

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'