CUSEREXIT

유효 기간

Replicat

설명

CUSEREXIT 매개변수를 사용하여 Oracle GoldenGate 처리 내의 정의된 종료 지점에서 Windows DLL 또는 UNIX 공유 객체의 C 프로그래밍 코드로 작성된 사용자정의 종료 루틴을 호출할 수 있습니다. User Exit 루틴은 Replicat 프로세스와 다른 이벤트 및 정보를 받아들이고, 원하는 대로 정보를 처리한 다음 호출자에게 응답 및 정보를 반환할 수 있어야 합니다(호출한 Oracle GoldenGate 프로세스).

User Exit은 Oracle GoldenGate 솔루션 내에서 사용할 수 있는 데이터 변환 기능의 대안으로 또는 이와 함께 사용할 수 있습니다.

주: 조정된 Replicat를 사용하여 User Exit 루틴을 호출하는 경우 스레드 안전 방식으로 User Exit을 작성해야 합니다.

User Exit 생성 및 구현에 대한 도움말은 Using User Exits to Extend Oracle GoldenGate Capabilities을 참조하십시오.

기본값

없음

구문

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

{<DLL> | <shared_object>}

User Exit 함수를 포함하는 Windows DLL 또는 UNIX 공유 객체의 이름입니다.

<routine>

실행할 종료 루틴의 이름입니다.

INCLUDEUPDATEBEFORES

열 값의 이전 이미지를 사용자 출구로 전달합니다. 이 매개변수를 사용할 때는 이 플래그를 지원하는 콜백 함수 내에서 requesting_before_after_ind 플래그를 BEFORE_IMAGE_VAL로 설정하여 이전 이미지를 명시적으로 요청해야 합니다. 그렇지 않은 경우 이후 이미지만 User Exit에 전달됩니다. 기본적으로 Oracle GoldenGate는 애프터 이미지에서만 작동합니다.

Replicat에서 호출된 사용자 종료에 INCLUDEUPDATEBEFORES를 사용할 때는 이전 이미지가 트레일에 기록되도록 항상 tranlog Extract 프로세스에 GETUPDATEBEFORES 매개변수를 사용하십시오.

PARAMS <'string'>

시작 시 지정된 문자열을 전달합니다. 속성 파일, 시작 매개변수 또는 기타 문자열을 전달하는 데 사용할 수 있습니다. 문자열을 작은 따옴표로 묶습니다.

문자열의 데이터가 EXIT_CALL_START exit_params_def.function_param의 User Exit에 전달됩니다. 따옴표로 묶인 문자열이 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'