ADD EXTTRAIL

ADD EXTTRAIL을 사용하여 로컬 시스템에서 온라인 처리를 위해 추적을 생성하고 다음을 수행할 수 있습니다.

• Extract 그룹과 연관합니다.

• 최대 파일 크기를 지정합니다.

• 단일 Extract 프로세스에서 ADD EXTTRAIL를 사용하여 여러 추적 파일을 생성하려고 시도할 때 추적 파일 수가 특정 제한을 초과하면 작업이 실패합니다. 특히 12개가 넘는 트레일이 생성되면 다음과 같은 오류가 발생할 수 있습니다.

  2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in
  
  checkpoint file /path/to/checkpoint/file.cpe.

  이 오류는 체크포인트 파일이 레코드 크기 제한인 32,767개를 초과하여 발생합니다. 체크포인트 파일에는 CSN(커밋 시퀀스 번호), XID(트랜잭션 ID) 및 파일 크기에 영향을 주는 레코드 번호가 포함됩니다.

  이 오류를 방지하려면 특히 성능상의 이유로 단일 Extract에서 여러 개의 트레일 파일을 생성하지 않는 것이 좋습니다. 선호되는 접근 방법은 단일 Extract가 필요한 모든 데이터를 캡처하고 배포 서비스를 사용하여 다른 대상에 배포하도록 하는 것입니다.

  각 개별 대상에 대한 트레일 파일 크기를 줄여야 하는 경우 여러 Extract 프로세스를 실행할 수도 있습니다.

Oracle GoldenGate용 매개변수 및 함수 참조의 EXTTRAIL를 참조하십시오.

구문

ADD EXTTRAIL trail_name, EXTRACT group_name
[, MEGABYTES n]
[SEQNO n]

trail_name

두 개의 문자 트레일 이름입니다. 두 문자는 모두 영문자여야 하지만 첫 문자는 숫자가 아니어야 합니다. Oracle GoldenGate는 새 파일이 생성될 때마다 이 이름에 9자리 시퀀스 번호를 추가합니다.

추적 이름 앞에는 디렉토리가 붙을 수도 있습니다. 예를 들어, north/ea 트레일 이름이 ea000000000인 경우 트레일 파일 이름은 ea000000001, $OGG_DATA_HOME/north 하위 디렉토리가 됩니다.

group_name

추적이 바인드된 Extract 그룹의 이름입니다. 트레일은 하나의 Extract에만 지정될 수 있습니다. 다중 Extract는 동일한 트레일에 쓸 수 없습니다. 단, 필요한 경우 하나의 Extract가 여러 개별 트레일에 쓸 수 있지만 일반적으로 필수 사항은 아닙니다.

MEGABYTES n

시퀀스에서 각 추적 파일의 최대 크기(MB)입니다. 기본값은 500MB이고 최대값은 2000MB입니다.

SEQNO n

추적의 첫번째 파일이 지정된 추적 시퀀스 번호로 시작되도록 지정합니다. 0 채우기를 포함하지 마십시오. 예를 들어, 이름이 tr인 추적의 시퀀스 3에서 시작하려면 SEQNO 3을 지정합니다. 실제 파일의 이름은 /ea000000003이 됩니다. 이 옵션은 특정 추적 시퀀스 번호로 Replicat의 위치를 재배치해야 할 때 문제 해결 중 사용될 수 있습니다. 이 옵션을 사용할 경우 필요한 시퀀스 번호를 읽도록 Replicat를 변경할 필요가 없음 기본값은 1이고,

제한 사항

이전 Extract 추적과 동일한 이름으로 Extract 추적을 생성할 때 trail_name가 동일한 해당 디렉토리의 모든 추적이 삭제되었는지 확인합니다.

그룹 복제에 대해 사용으로 설정된 MySQL 데이터베이스에서 캡처하는 경우 Extract에는 하나의 트레일만 허용됩니다.

예제

---

다음 명령은 트레일 이름 ea를 생성합니다.

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

출력은 다음과 같이 표시됩니다.

2019-11-20T23:49:19Z  INFO    OGG-08100  EXTTRAIL added.