Snowflake용 Replicat 추가

OCI GoldenGate 데이터 복제에서 Snowflake 대상에 대한 Replicat 프로세스를 추가하는 방법을 알아봅니다.

시작하기 전에

Snowflake 데이터베이스에 대상 테이블이 존재하는지 확인합니다.
S3, ADLS Gen2 또는 GCS와 같은 외부 스테이지 위치를 사용하려는 경우 Amazon Web Services, Google Cloud Platform 또는 Azure 클라우드 계정을 설정해야 합니다.
Snowflake JDBC 드라이버 접속 문자열
Snowflake로 복제하는 데 사용되는 데이터베이스 사용자에게 다음 권한을 부여해야 합니다.
- 대상 테이블의 INSERT, UPDATE, DELETE 및 TRUNCATE
- Snowflake의 CREATE 및 DROP이 단계 및 외부 단계로 명명되었습니다.
- 외부 스테이지(S3, ADLS, GCS), CREATE, ALTER 및 DROP 외부 테이블을 사용하는 경우
Snowflake에 대한 구성 고려 사항 및 모범 사례 검토

Replicat 추가(26ai)

이 대상 유형에 특정한 필수 조건을 검토해야 합니다.

OCI GoldenGate 배치 콘솔 탐색 메뉴에서 복제를 선택합니다.
Replicat 페이지에서 Add Replicat를 선택합니다.
[복제 추가] 패널의 복제 정보 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 선택합니다.
- 복제 유형을 선택합니다.
  - 클래식 Replicat
  - 조정 Replicat
- 프로세스 이름을 5자 이하로 입력합니다.
- 이 프로세스를 다른 프로세스와 구별하는 데 도움이 되도록 설명을 입력합니다.
복제 옵션 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 선택합니다.
1. Replicat Trail의 경우:
  - 이름을 입력합니다.
  - 추적 파일이 기본값이 아닌 다른 위치에 있어야 하는 경우 하위 디렉토리를 입력합니다.
  - 암호화 프로파일을 선택합니다. 암호화 프로파일이 생성되지 않은 경우 기본적으로 로컬 전자 지갑이 선택됩니다.
  - 시작에 대해 데이터 처리의 시작점을 선택합니다.
    - 로그의 위치(기본값)
    - Now
    - 사용자정의 시간
2. 추적 위치:
  - 순서 번호를 입력합니다.
  - RBA 오프셋을 입력합니다.
3. 대상의 경우 드롭다운에서 눈 조각을 선택한 후 다음 중 하나를 선택합니다.
  1. 스트리밍
  2. 스테이지 및 병합 후 사용 가능한 스테이지 위치 선택
4. 대상 인증서의 경우:
  - 도메인을 선택합니다.
  - 지정된 도메인 내에서 별칭을 선택합니다.
  - 체크포인트 테이블을 선택합니다. 기본 선택을 그대로 두거나 대상 배치에 대해 생성한 체크포인트 테이블을 선택합니다.
  - 최대 스레드 번호를 선택합니다(조정된 복제만 해당).
관리되는 옵션 페이지에서 필요에 따라 선택적 필드에 정보를 입력한 다음 다음을 선택합니다.
- 프로파일 이름을 사용할 수 있는 경우 선택합니다.
- 배치 건전성에 중요를 사용합니다.
- 자동 시작 설정을 사용으로 설정하고 구성합니다.
매개변수 파일 페이지에서 매개변수를 추가하여 Replicat를 추가로 구성할 수 있습니다. 예:
```
table source.table1;
```
참고:

GoldenGate는 기본적으로 그리니치 표준시(GMT)를 사용합니다. SETENV를 사용하여 Replicat에 대한 기본 설정을 대체합니다. 이 변경 사항은 배포에 적용되지 않습니다. 예:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
(선택 사항) [속성 파일] 페이지에서 다음 속성을 검토합니다.
- jvm.bootoptions: Replicat JVM에 메모리를 더 추가해야 하는 경우 -Xmx 값을 늘립니다(최대 16GB의 메모리를 사용하려면 -Xmx16g, 최대 32GB의 경우 -Xmx32g 등).
  주: Snowflake Streaming Handler와 관련된 알려진 문제가 Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper" 오류로 인해 실패합니다. 이 문제를 해결하려면 Replicat 속성 파일에 다음을 추가합니다.
```
jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true
```
이 대상의 속성에 대한 자세한 내용과 스테이지와 병합 및 스트리밍 처리기의 차이점에 대한 자세한 내용은 Oracle GoldenGate for Distributed Applications and Analytics 가이드의 Snowflake를 참조하십시오.
생성 및 실행을 선택합니다. 생성을 선택하면 나중에 [복제] 페이지에서 수동으로 Replicat를 시작할 수 있습니다.

Replicat 추가(21c)

Oracle GoldenGate 21c에서 Snowflake용 Replicat를 추가하려면 다음을 수행합니다.

OCI GoldenGate 배치 콘솔의 [관리 서비스 개요] 페이지에서 복제 추가(더하기 아이콘)를 선택합니다.
Add Replicat 페이지에서 Replicat 유형을 선택한 후 Next를 선택합니다.

Replicat의 유형은 다음과 같습니다.
- 클래식 Replicat
- 조정 Replicat
[복제 옵션] 페이지에서 다음 필드에 정보를 입력한 다음 다음을 선택합니다.
1. 프로세스 이름에 Replicat 프로세스의 이름을 입력합니다.
2. 트레일 이름에 2자 추적 이름을 입력합니다.
3. 대상의 경우 드롭다운에서 대상 Snowflake 접속을 선택합니다.
4. 사용 가능한 별칭의 경우 드롭다운에서 별칭을 선택합니다.
5. (선택 사항) 외부 저장소를 사용으로 설정하여 드롭다운에서 사용 가능한 스테이지 위치를 선택합니다.
[복제 매개변수] 페이지에서 필요한 매핑을 추가한 다음 다음을 선택합니다.
참고:
- Coordinated Replicat를 사용하는 경우 매개변수 파일의 두번째 행에 다음 매개변수를 추가합니다.
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/.properties
```
조정된 복제를 사용하면 여러 파일이 생성됩니다. 생략할 경우 다음 오류가 발생합니다.
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file "/u02/Deployment/etc/conf/ogg/001.properties" (error 2, No such file or directory).
```
- Snowflake에 장기 실행 병합 작업이 있고 많은 수의 잠금이 관찰되는 경우 다른 테이블이 동일한 테이블을 수정하지 않는지 확인합니다. 또한 테이블 잠금 수가 많아질 수 있으므로 조율된 복제본을 주의해서 사용하십시오.
- GoldenGate는 기본적으로 그리니치 표준시(GMT)를 사용합니다. SETENV를 사용하여 Replicat에 대한 기본 설정을 대체합니다. 이 변경 사항은 배포에 적용되지 않습니다. 예:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
SETENV에 대해 자세히 알아보십시오.
(선택 사항) [속성 파일] 페이지에서 다음 속성을 검토합니다.

주: 이러한 속성은 접속을 생성할 때 설정되며 여기서 수정해서는 안됩니다.
- ggs.eventhandler.snowflake.connectionURL: Snowflake에 연결할 JDBC URL입니다.
- ggs.eventhandler.snowflake.UserName: Snowflake 데이터베이스 사용자 이름입니다.
- ggs.eventhandler.snowflake.Password: Snowflake 데이터베이스 사용자와 연관된 비밀번호입니다.
- ggs.eventhandler.snowflake.storageIntegration: 해당 객체 저장소 파일에 액세스하기 위한 Snowflake 데이터 웨어하우스의 인증서입니다. 자세한 내용은 Snowflake 스토리지 통합을 참조하십시오.
- jvm.bootoptions: Replicat JVM에 메모리를 더 추가해야 하는 경우 -Xmx 값을 늘립니다(최대 16GB의 메모리를 사용하려면 -Xmx16g, 최대 32GB의 경우 -Xmx32g 등).
생성 및 실행을 선택합니다. 생성을 선택한 경우 나중에 [관리 서비스 개요] 페이지에서 수동으로 Replicat를 시작할 수 있습니다.

Replicat 프로세스 생성을 확인하고 Replicat 작업에 액세스할 수 있는 Administration Service Overview 페이지로 돌아갑니다.

Snowflake 대상 세부정보

알려진 문제

버그 37518857: OGGDAA GGS Snowflake 스트리밍 Replicat 오류

Snowflake Streaming Handler 실패: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

임시해결책: Replicat Properties 파일에 다음을 추가합니다.

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true