Apache Iceberg에 연결

OCI GoldenGate에서 Apache Iceberg에 대한 접속을 생성하는 방법을 알아봅니다.

시작하기 전에

다음 사항을 확인합니다.

OCI GoldenGate가 소스 및 대상에 연결하는 방법을 검토합니다.
암호 사용, 저장소 사용 및 암호 번들 읽기와 같은 보안 저장소 및 암호 액세스를 사용으로 설정하는 데 필요한 정책을 구성합니다. 자세한 내용은 최소 권장 정책을 참조하십시오.

접속을 생성합니다.

Apache Iceberg에 대한 연결을 생성하려면 다음을 수행합니다.

OCI GoldenGate 개요 페이지에서 연결을 선택합니다.

시작하기 섹션에서 접속 생성을 선택하고 3단계로 건너뛸 수도 있습니다.
[접속] 페이지에서 접속 생성을 선택합니다.
Create Connection 페이지에서 다음과 같이 필드에 정보를 입력합니다.
1. 이름에 연결의 이름을 입력합니다.
2. (선택 사항) 설명에 이 연결을 다른 연결과 구별하는 데 도움이 되는 설명을 입력합니다.
3. (멀티클라우드의 GoldenGate에만 해당) 구독을 선택한 후 다음 필드에 정보를 입력합니다.
  1. 구획 드롭다운에서 리소스 앵커가 상주하는 컴파트먼트를 선택합니다.
  2. 멀티클라우드 파트너 지역을 선택합니다.
  3. 파트너 가용성 영역을 선택합니다. 사용 가능한 옵션은 선택한 멀티클라우드 파트너 영역을 기반으로 채워집니다.
4. 구획에서 접속을 생성할 구획을 선택합니다.
5. 유형의 경우 빅 데이터에서 Apache Iceberg를 선택합니다.
6. 드롭다운에서 카탈로그 유형을 선택한 다음 관련 카탈로그 필드에 정보를 입력합니다.
  1. 글루에 글루 ID를 입력합니다.
  2. Hadoop의 경우 추가 정보가 필요하지 않습니다.
  3. 네시의 경우 다음을 지정합니다.
    - URI: Nessie 카탈로그 URI를 입력합니다.
    - 분기: Nessie가 테이블 메타데이터를 읽고 쓸 수 있는 활성 분기 이름을 입력합니다.
  4. Polaris의 경우 다음을 지정합니다.
    - URI: Polaris 카탈로그 URI를 입력합니다.
    - 이름: Polaris가 Iceberg 테이블을 등록하는 이름을 입력합니다.
    - 클라이언트 ID: 인증에 사용할 OAuth 클라이언트 ID를 입력합니다.
    - 클라이언트 암호: 클라이언트 암호를 선택하거나 클라이언트 암호 생성을 선택하여 새 암호를 생성합니다. 새 클라이언트 암호를 만들도록 선택할 경우 다음 정보를 제공합니다.
      - 이름
      - (선택 사항) 설명
      - 속성 암호가 상주하는 구획을 선택합니다.
      - 속성 암호를 저장할 저장소를 선택합니다.
      - 사용할 암호화 키를 선택합니다.
      - 사용자 비밀번호를 입력한 다음 사용자 비밀번호를 확인합니다.
    - 주체 롤: Polaris에 액세스하는 데 사용되는 Snowflake 롤을 입력합니다.
  5. 복원의 경우 다음을 지정합니다.
    - URI: REST 카탈로그 API에 대한 기본 URL을 입력합니다.
    - 속성 암호: 속성 암호를 선택하거나 속성 암호 생성을 선택하여 새로 생성합니다. 새 속성 암호를 만들도록 선택할 경우 다음 정보를 제공합니다.
      - 이름
      - (선택 사항) 설명
      - 속성 암호가 상주하는 구획을 선택합니다.
      - 속성 암호를 저장할 저장소를 선택합니다.
      - 사용할 암호화 키를 선택합니다.
      - 속성 암호 ID를 업로드합니다.
7. 드롭다운에서 스토리지 유형을 선택한 다음 관련 스토리지 필드에 정보를 입력합니다.
  - Amazon S3: Amazon S3에 연결 참조
  - Google Cloud Storage: Google Cloud Storage에 연결을 참조하십시오.
  - Azure Data Lake Storage: Azure Data Lake Storage에 연결하기 참조
8. 고급 옵션을 표시합니다를 확장합니다. 다음과 같은 옵션을 구성할 수 있습니다.
  - 보안
    - 이 접속에 비밀번호 암호를 사용하지 않으려는 저장소 암호 사용의 선택을 해제합니다. 선택되지 않은 경우:
      - 모든 암호화 키 관리를 Oracle에 그대로 두려면 Oracle 관리 암호화 키 사용을 선택합니다.
      - 고객 관리 암호화 키 사용을 선택하여 OCI 저장소에 저장된 특정 암호화 키를 선택하여 접속 인증서를 암호화합니다.
  - 네트워크 접속
    - 공유 끝점 - 지정된 배치와 끝점을 공유합니다. 배포의 수신 IP에서 연결을 허용해야 합니다.
    - 전용 엔드포인트 - VCN의 지정된 서브넷에 있는 전용 엔드포인트를 통한 네트워크 트래픽용입니다. 이 접속의 수신 IP에서 접속을 허용해야 합니다.
      참고:
      
      전용 연결이 7일 동안 할당되지 않은 상태로 유지되면 서비스가 해당 연결을 공유 연결로 변환합니다.
      
      Oracle GoldenGate 연결에 대해 자세히 알아보십시오.
  - 보안 속성: Zero Trust Packet Routing(ZPR)을 사용하여 이 접속에 대한 액세스를 제어하는 보안 속성을 추가합니다.
  - 태그: 리소스를 구성하기 위한 태그를 추가합니다.
생성을 선택합니다.

연결이 생성된 후 Connection 리스트에 표시됩니다. 데이터 복제 프로세스에서 사용할 배치에 연결을 지정해야 합니다.

다음 단계

알려진 문제

OCI GoldenGate에서 Apache Iceberg 연결 문제 해결

Apache Iceberg 연결을 사용할 때 다음 오류가 발생하면 지원 티켓을 열고 세부정보 및 오류 메시지를 공유하십시오.

ERROR 2025-07-08 13:34:09.000481 [main] -  Parameter [awsSecretKey] is missing in the
      connection payload. Parameter [awsSecretKey] is missing in the connection payload.