DEFSFILE

유효 기간

DEFGEN

설명

DEFSFILE 매개변수를 사용하여 DEFGEN가 데이터 정의를 쓸 파일의 이름을 식별합니다. 기본적으로 데이터 정의 파일은 로컬 운영 체제의 문자 집합으로 기록됩니다. CHARSET 옵션을 사용하여 문자 집합을 변경할 수 있습니다.

기본값

없음

구문

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

상대적 또는 전체 파일 이름입니다. 이 파일은 DEFGEN를 실행할 때 생성됩니다.

APPEND

지정된 파일이 이미 있는 경우 기존 콘텐츠의 끝에 현재 실행에서 새 콘텐츠를 작성하도록 DEFGEN에 지시합니다. 정의 파일이 존재하지만 이전 Oracle GoldenGate 릴리스 버전인 경우 오류를 방지하기 위해 FORMAT RELEASE 옵션을 기존 파일과 동일한 버전으로 설정할 수 있습니다. 그렇지 않으면 DEFGEN가 최신 메타데이터 기능을 추가하고 비정상 종료를 시도합니다. 다음은 APPEND를 사용할 때의 제한 사항입니다.

• 기존 데이터 정의 파일이 Oracle GoldenGate 11.2.1보다 오래된 형식인 경우 DEFGEN는 테이블 정의를 이전 형식으로 추가합니다. 여기서 멀티바이트 및 특수 문자가 포함된 테이블 및 열 이름은 지원되지 않습니다.

• 기존 데이터 정의 파일이 버전 11.2.1에 도입된 최신 형식인 경우 DEFGEN는 파일의 기존 문자 집합에 테이블 정의를 추가합니다.

• 기존 파일이 버전 11.2 이하인 경우 DEFGEN가 세 부분으로 구성된 객체 이름을 지원하지 않을 때 기록되고 새 메타데이터에 세 부분으로 구성된 이름이 포함된 경우 오류가 발생합니다. DEFGEN 매개변수 파일의 NOCATALOG 매개변수를 사용하여 컨테이너 또는 카탈로그 부분을 제거하는 경우 Oracle 컨테이너 데이터베이스에서 객체를 지정할 수 있습니다.

PURGE

현재 실행에서 새 콘텐츠를 쓰기 전에 지정된 파일을 비우도록 DEFGEN에 지시합니다. PURGE를 사용할 때 이전 버전의 DEFGEN에 의해 생성된 기존 정의 파일을 3개 부분 객체 이름과 같은 최신 기능을 지원하는 최신 메타데이터로 겹쳐쓸 수 있습니다.

CHARSET <character_set>

지정된 문자 집합에 정의 파일을 생성합니다. CHARSET가 없으면 운영 체제의 기본 문자 집합이 사용됩니다. 버전 11.2.1 이상인 정의 파일에 대해 APPEND 모드가 지정된 경우 CHARSET가 무시되고 기존 정의 파일의 문자 집합이 사용됩니다.

FORMAT RELEASE <major.minor>

DEFGEN에 의해 정의 파일로 전송되는 정의의 메타데이터 형식을 지정합니다. 메타데이터를 통해 읽기 장치 프로세스는 파일 레코드가 지원되는 버전인지 여부를 알 수 있습니다. 메타데이터 형식은 Oracle GoldenGate 프로세스의 버전에 따라 다릅니다. 오래된 Oracle GoldenGate 버전은 최신 버전과 다른 메타데이터를 포함합니다. 정의 파일이 현재 버전보다 오래된 Oracle GoldenGate 버전의 프로세스에서 사용될 경우 FORMAT를 사용합니다.

• FORMAT은 필수 키워드입니다.

• RELEASE는 Oracle GoldenGate 릴리스 버전을 지정합니다. <major>는 주 버전 번호이며 <minor>는 부 버전 번호입니다. X.x는 Oracle GoldenGate의 현재 또는 이전 GA(일반적으로 사용 가능한) 릴리스를 반영해야 합니다. 유효한 값은 9.0부터 현재 Oracle GoldenGate X.x 버전 번호(예: 11.2 또는 12.1)까지입니다. (9.0 이전 버전의 Oracle GoldenGate를 사용하는 경우 9.0 또는 9.5를 지정합니다.)

  릴리스 버전은 프로그래밍 방식으로 적절한 내부 호환성 레벨에 다시 매핑됩니다. 기본값은 이 추적에 쓴 프로세스의 현재 버전입니다. 12.1 이전의 RELEASE 버전은 세 부분으로 구성된 객체 이름을 지원하지 않습니다.

FORMAT RELEASE <major.minor>

Extract가 추적, 파일 또는 다른 프로세스(원격 작업인 경우)로 전송하는 데이터의 메타데이터 형식을 지정합니다. 메타데이터를 통해 읽기 장치 프로세스는 데이터 레코드가 지원되는 버전인지 여부를 알 수 있습니다. 메타데이터 형식은 Oracle GoldenGate 프로세스의 버전에 따라 다릅니다. 오래된 Oracle GoldenGate 버전은 최신 버전과 다른 메타데이터를 포함합니다.

FORMAT RELEASE는 Oracle GoldenGate 릴리스 버전을 지정합니다. major는 주 버전 번호이며 minor는 부 버전 번호입니다. X.x는 Oracle GoldenGate의 현재 또는 이전 GA(일반적으로 사용 가능한) 릴리스를 반영해야 합니다. 유효한 값은 11.1부터 현재 Oracle GoldenGate X.x 버전 번호(예: 11.2 또는 12.1)까지입니다. 릴리스 버전은 프로그래밍 방식으로 적절한 추적 형식 호환성 레벨에 다시 매핑됩니다. 기본값은 이 추적에 쓴 프로세스의 현재 버전입니다. 주: 12.1 이전의 RELEASE 버전은 세 부분으로 구성된 객체 이름을 지원하지 않습니다.

참고: 단일 Extract에서 다중 추적을 사용하는 경우 동일한 RELEASE 버전만 함께 사용할 수 있습니다.

Oracle Database 12.2 및 이후 버전에 대해서는 다음 설정이 지원됩니다.

• 호환성이 12.1로 설정된 Oracle Database 12.2 비CDB 또는 이전 버전의 경우 FORMAT RELEASE 12.2 이상이 지원됩니다.

• 호환성이 12.2로 설정된 Oracle Database 12.2 비CDB 또는 이전 버전의 경우 FORMAT RELEASE 12.2 이상이 지원됩니다.

• 호환성이 12.2로 설정된 Oracle Database 12.2 CDB/PDB 또는 이전 버전의 경우 FORMAT RELEASE 값 12.3 이상이 지원됩니다. This is due to the use of local undo for PDBs, which requires augmenting the transaction ID with the PDB number to ensure uniqueness of trx IDs.

예제

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2