Apache Iceberg에 연결

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

시작하기 전에

연결을 생성하기 전에 다음 사항을 확인하십시오.

접속을 생성합니다.

Apache Iceberg에 대한 연결을 생성하려면 다음을 수행합니다.
  1. OCI GoldenGate 개요 페이지에서 연결을 누릅니다.
    시작하기 섹션에서 접속 생성을 누르고 3단계로 건너뛸 수도 있습니다.
  2. 접속 페이지에서 접속 생성을 누릅니다.
  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. 드롭다운에서 저장소 유형을 선택한 다음 관련 저장 영역 필드를 완성합니다.
  4. 고급 옵션을 표시합니다. 다음과 같은 옵션을 구성할 수 있습니다.
    • 보안
      • 이 접속에 비밀번호 암호를 사용하지 않으려는 경우 저장소 암호 사용을 선택 해제합니다. 선택되지 않은 경우:
        • 모든 암호화 키 관리를 Oracle에 그대로 두려면 Oracle 관리 암호화 키 사용을 선택합니다.
        • 고객 관리 암호화 키 사용을 선택하여 OCI 저장소에 저장된 특정 암호화 키를 선택하여 접속 인증서를 암호화합니다.
    • 네트워크 접속
      • 공유 끝점 - 지정된 배치와 끝점을 공유합니다. 배포의 수신 IP에서 연결을 허용해야 합니다.
      • 전용 엔드포인트 - VCN의 지정된 서브넷에 있는 전용 엔드포인트를 통한 네트워크 트래픽용입니다. 이 접속의 수신 IP에서 접속을 허용해야 합니다.

        주:

        • 전용 연결이 7일 동안 할당되지 않은 상태로 유지되면 서비스가 해당 연결을 공유 연결로 변환합니다.
        • Oracle GoldenGate 연결에 대해 자세히 알아보십시오.
    • 보안 속성: Zero Trust Packet Routing(ZPR)을 사용하여 이 연결에 대한 액세스를 제어하는 보안 속성을 추가합니다.
    • 태그: 리소스를 구성하기 위한 태그를 추가합니다.
  5. 생성을 누릅니다.
연결이 생성된 후 Connection 리스트에 표시됩니다. 데이터 복제 프로세스에서 사용할 배치에 연결을 지정해야 합니다.

알려진 문제

OCI의 Apache Iceberg 연결 문제 GoldenGate

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.