OCI 오브젝트 스토리지에 대한 복제본 추가

OCI Object Storage 대상에 대한 Replicat 프로세스를 추가하고 구성하는 방법을 알아봅니다.

관련 항목

시작하기 전에

Replicat를 추가하기 전에 다음 사항이 있는지 확인합니다.

컴파트먼트 OCID
참고:
컴파트먼트 OCID는 컴파트먼트 세부 정보 페이지에서 찾을 수 있습니다.
1. Oracle Cloud 콘솔 탐색 메뉴를 열고 ID, 구획을 차례로 선택합니다.
2. 목록에서 컴파트먼트를 선택하여 컴파트먼트 세부정보 페이지에 액세스합니다.
3. 컴파트먼트 정보 섹션에서 컴파트먼트 OCID를 복사합니다.
자세한 내용은 구획의 OCID 찾기를 참조하십시오.
OCI Object Storage 버킷 이름
참고:
Oracle은 고유한 OCI Object Storage 버킷을 생성할 것을 권장합니다.
1. Oracle Cloud 콘솔 탐색 메뉴를 열고 스토리지, 버킷을 차례로 선택합니다.
2. 버킷 생성을 누릅니다.
3. [버킷 생성] 패널에서 이름을 입력한 다음 생성을 누릅니다.
자세한 내용은 콘솔을 사용하여 버킷 생성을 참조하십시오.

Replicat(23ai) 추가

시작하기 전에

이 대상 유형과 관련된 필요 조건을 검토해야 합니다.

GoldenGate 23ai에서 Replicat를 추가하려면 다음과 같이 하십시오.

OCI GoldenGate 배치 콘솔의 관리 서비스 홈 페이지에서 복제 추가(더하기 아이콘)를 누릅니다.
복제 추가 패널의 복제 정보 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 누릅니다.
- 복제 유형을 선택합니다.
  - 클래식 Replicat
  - 조정 Replicat
- 프로세스 이름을 5자 이하로 입력합니다.
- 이 프로세스를 다른 프로세스와 구분하는 데 도움이 되도록 설명을 입력합니다.
복제 옵션 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 누릅니다.
- Replicat 트레일:
  - 이름을 입력하십시오.
  - 트레일 파일이 기본값이 아닌 다른 위치에 있어야 하는 경우 하위 디렉토리를 입력합니다.
  - 암호화 프로파일을 선택합니다. 암호화 프로파일이 생성되지 않은 경우 기본적으로 로컬 전자 지갑이 선택됩니다.
  - 시작에 대해 데이터 처리의 시작점을 선택합니다.
    - 로그의 위치(기본값)
    - Now
    - 사용자정의 시간
- 트레일 위치:
  - 순서 번호를 입력합니다.
  - RBA 오프셋을 입력합니다.
  - 드롭다운에서 대상을 선택합니다.
    
    주:
    대상 선택에 따라 스트리밍, 스테이지 및 병합, 스테이지 위치와 같은 추가 옵션이 있을 수 있습니다.
- 대상 인증서:
  - 도메인을 선택합니다.
  - 지정된 도메인 내에서 별칭을 선택합니다.
  - 체크포인트 테이블을 선택합니다. 기본 선택 항목을 그대로 두거나 대상 배치에 대해 생성한 체크포인트 테이블을 선택합니다.
  - 최대 스레드 번호를 선택합니다(조정된 복제본만 해당).
관리되는 옵션 페이지에서 필요에 따라 선택적 필드에 정보를 입력한 다음 다음을 누릅니다.
- 프로파일 이름(사용 가능한 경우)을 선택합니다.
- 배치 건전성에 위기 사용.
- 자동 시작 설정을 사용으로 설정하고 구성합니다.
매개변수 파일 페이지에서 매개변수를 추가하여 복제를 추가로 구성할 수 있습니다. 예를 들면, 다음과 같습니다.
```
table source.table1;
```
조정된 Replicat를 사용하는 경우 매개변수 파일에 TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties를 추가합니다.
주:

GoldenGate는 기본적으로 그리니치 표준시(GMT)를 사용합니다. SETENV를 사용하여 이 Replicat 프로세스에 대한 기본 설정을 무효화합니다. 이 변경사항은 배치에 적용되지 않습니다. 예:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
[속성 파일] 페이지에서 필요에 따라 [파일 처리기] 및 [OCI 이벤트 처리기] 속성을 구성한 다음 다음을 누릅니다. 수정을 고려할 일부 등록 정보는 다음과 같습니다.
1. gg.handler.name.format: 출력 데이터의 형식 지정 방법을 선택합니다. 사용 가능한 옵션은 다음과 같습니다.
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row
  - avro_op
  - avro_row_ocf
  - avro_op_ocf
  파케의 경우 추가 속성을 적용해야 합니다. 자세한 내용은 OCI Object Storage용 Parquet를 참조하십시오.
2. gg.handler.name.fileNameMappingTemplate: 템플리트 키워드를 사용하여 동적으로 파일 이름을 생성합니다.
3. gg.handler.name.inactivityRollInterval: GoldenGate는 파일을 생성하고 쓰기용으로 열린 상태로 유지합니다. 이 속성은 지정된 비활성 기간(수신 트랜잭션 없음) 후에 파일을 닫은 다음 OCI Object Storage에 로드합니다.
4. gg.eventhandler.name.compartmentID: 컴파트먼트 OCID를 입력합니다.
5. gg.eventhandler.name.bucketMappingTemplate: 오브젝트 스토리지 버킷 이름을 입력합니다.
파일 작성기 처리기 및 OCI 이벤트 처리기 구성 속성에 대해 자세히 알아봅니다.

주:
필요에 따라 플러그인할 수 있는 포맷터를 추가할 수도 있습니다. 자세한 내용은 플러그인할 수 있는 포맷터를 참조하십시오.
생성 및 실행을 누릅니다. 생성을 누르면 나중에 관리 서비스 홈 페이지에서 복제를 수동으로 시작할 수 있습니다.

Replicat 추가(21c)

OCI Object Storage 대상에 대한 Replicat를 추가하려면 다음과 같이 하십시오.

OCI GoldenGate 배치 콘솔의 [관리 서비스 개요] 페이지에서 복제 추가(더하기 아이콘)를 누릅니다.
[복제 추가] 페이지에서 [복제] 유형을 선택한 다음 다음을 누릅니다.
복제본 유형은 다음과 같습니다.
- 클래식 Replicat
- 조정 Replicat
복제 옵션 페이지에서 다음 필드에 정보를 입력한 후 다음을 누릅니다.
1. 프로세스 이름에 Replicat 프로세스의 이름을 입력합니다.
2. (선택 사항) 설명에 이 프로세스를 다른 프로세스와 구분하기 위한 간단한 설명을 입력합니다.
3. 추적 이름에 2자 추적 이름을 입력합니다.
4. 대상에 대해 드롭다운에서 Oracle Object Storage를 선택합니다.
5. OCI에 사용 가능한 별칭의 경우 드롭다운에서 별칭을 선택합니다.
매개변수 파일 페이지에서 필요에 따라 Replicat 매개변수를 추가 및 구성하고 다음을 누릅니다.
주:
- Coordinated Replicat를 사용하는 경우 매개변수 파일의 두번째 행에 다음 매개변수를 추가합니다.
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties
```
  조정된 복제본을 사용하면 여러 파일이 생성됩니다.
  
  생략할 경우 다음 오류가 발생합니다.
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
```
- GoldenGate는 기본적으로 그리니치 표준시(GMT)를 사용합니다. SETENV를 사용하여 기본 설정을 재정의합니다. 예:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
  자세히 알아보기 SETENV.
[속성 파일] 페이지에서 필요에 따라 [파일 처리기] 및 [OCI 이벤트 처리기] 속성을 구성한 다음 다음을 누릅니다. 수정을 고려할 일부 등록 정보는 다음과 같습니다.
1. gg.handler.name.format: 출력 데이터의 형식 지정 방법을 선택합니다. 사용 가능한 옵션은 다음과 같습니다.
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row
  - avro_op
  - avro_row_ocf
  - avro_op_ocf
  파케의 경우 추가 속성을 적용해야 합니다. 자세한 내용은 OCI Object Storage용 Parquet를 참조하십시오.
2. gg.handler.name.fileNameMappingTemplate: 템플리트 키워드를 사용하여 동적으로 파일 이름을 생성합니다.
3. gg.handler.name.inactivityRollInterval: GoldenGate는 파일을 생성하고 쓰기용으로 열린 상태로 유지합니다. 이 속성은 지정된 비활성 기간(수신 트랜잭션 없음) 후에 파일을 닫은 다음 OCI Object Storage에 로드합니다.
4. gg.eventhandler.name.compartmentID: 컴파트먼트 OCID를 입력합니다.
5. gg.eventhandler.name.bucketMappingTemplate: 오브젝트 스토리지 버킷 이름을 입력합니다.
파일 작성기 처리기 및 OCI 이벤트 처리기 속성에 대해 자세히 알아봅니다.

주:
필요에 따라 플러그인할 수 있는 포맷터를 추가할 수도 있습니다. 자세한 내용은 플러그인할 수 있는 포맷터 사용을 참조하십시오.
추가 및 실행을 누릅니다.

Replicat 프로세스의 상태를 모니터할 수 있는 [관리 서비스 개요] 페이지로 돌아갑니다. 프로세스 이름을 눌러 세부정보 및 액세스 보고서를 봅니다.

알려진 문제

리소스 주체를 사용할 때 OCI 오브젝트 스토리지 복제 오류 발생

리소스 주체가 인증에 사용되는 경우 Replicat가 실패하고 다음 오류가 발생합니다.

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

OCI 오브젝트 스토리지 접속에서 사용자 OCID 불일치(통합 사용자만 해당)

통합 사용자가 OCI Object Storage 접속을 생성할 때 현재 사용자 사용을 선택하는 경우 해당 OCID가 시스템에서 선택한 OCID와 일치하지 않습니다.

임시해결책: OCI Object Storage 접속을 생성할 때 다른 사용자 지정을 선택하고 통합 사용자의 OCID를 입력하십시오.

사용자 OCID를 찾으려면 Oracle Cloud 콘솔 전역 헤더에서 프로파일을 누른 다음 사용자 이름을 선택합니다. 사용자 세부정보 페이지의 사용자 정보에서 OCID에 대해 표시를 누릅니다.

제목 및 저작권 정보

Oracle and/or its affiliates.