SET_SESSION_CHARSET

유효 기간

추출 및 복제

설명

SET_SESSION_CHARSET 함수를 사용하여 User Exit의 문자 집합을 설정합니다. User Exit 세션의 문자 집합은 다음과 같은 메타 데이터를 포함하여 User Exit과 호출자 프로세스(Extract, Data Pump, Replicat) 간에 사용되는 문자 기반 콜백 구조 멤버의 인코딩을 나타냅니다.

이 함수는 User Exit에서 제어할 수 있는 언제든지 호출할 수 있습니다. User Exit에서 세션 Character Set을 설정하면 이 Character Set은 즉시 적용되며 모든 문자 값은 지정된 셋으로 변환되기 시작합니다. 이 함수를 호출하는 데 권장되는 위치는 호출 유형 EXIT_CALL_START입니다.

참고: SET_SESSION_CHARSET는 스레드에 안전하지 않습니다.

SET_SESSION_CHARSET가 호출되지 않은 경우 세션은 운영 체제의 기본 문자 집합으로 설정됩니다. 이 문자 집합은 ucharset.h 파일의 ULIB_CS_DEFAULT에 미리 정의된 열거 유형 값입니다. 세션 문자 집합이 ULIB_CS_DEFAULT의 기본값인 경우 User Exit과 호출자 프로세스 간에 교환되는 문자 유형 값에 대해 Oracle GoldenGate에서 변환을 수행하지 않습니다. 또한 데이터베이스의 객체 이름 메타 데이터는 운영 체제의 기본 문자 집합으로 간주됩니다. 기본값은 올바르지 않을 수 있습니다.

User Exit이 로드되고 SET_SESSION_CHARSET가 호출될 때 User Exit의 문자 집합이 보고서 파일에 인쇄됩니다. 세션 문자 집합이 ULIB_CS_DEFAULT인 경우 열 데이터 문자 집합 변환이 수행되지 않는다는 메시지가 나타납니다.

구문

#include usrdecs.h
short result_code;
session_def session_charset_def;
ERCALLBACK (SET_SESSION_CHARSET, &session_charset_def, &result_code);

버퍼

typedef struct
{
ULibCharSet  session_charset;
} session_def;

입력

<session_charset>

세션 문자 집합의 유효한 값은 헤더 파일 ucharset.h에 정의되어 있습니다.

출력

없음

반환 값

EXIT_FN_RET_OK