Amazon S3용 Replicat 추가

OCI GoldenGate에서 Amazon S3 대상에 대한 Replicat 프로세스를 생성하는 방법을 알아보세요

시작하기 전에

Amazon S3용 Replicat를 추가하고 실행하기 전에 다음 사항이 있는지 확인하십시오.

  • 대상 Big Data 배치에 생성되어 지정된 Amazon S3 접속
  • AWS(Amazon Web Services) 리전

Replicat(23ai) 추가

시작하기 전에

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

GoldenGate 23ai에서 Replicat를 추가하려면 다음과 같이 하십시오.
  1. OCI GoldenGate 배치 콘솔관리 서비스 홈 페이지에서 복제 추가(더하기 아이콘)를 누릅니다.
  2. 복제 추가 패널의 복제 정보 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 누릅니다.
    • 복제 유형을 선택합니다.
      • 클래식 Replicat
      • 조정 Replicat
    • 프로세스 이름을 5자 이하로 입력합니다.
    • 이 프로세스를 다른 프로세스와 구분하는 데 도움이 되도록 설명을 입력합니다.
  3. 복제 옵션 페이지에서 필요에 따라 필드에 정보를 입력한 다음 다음을 누릅니다.
    • Replicat 트레일:
      • 이름을 입력하십시오.
      • 트레일 파일이 기본값이 아닌 다른 위치에 있어야 하는 경우 하위 디렉토리를 입력합니다.
      • 암호화 프로파일을 선택합니다. 암호화 프로파일이 생성되지 않은 경우 기본적으로 로컬 전자 지갑이 선택됩니다.
      • 시작에 대해 데이터 처리의 시작점을 선택합니다.
        • 로그의 위치(기본값)
        • Now
        • 사용자정의 시간
    • 트레일 위치:
      • 순서 번호를 입력합니다.
      • RBA 오프셋을 입력합니다.
      • 드롭다운에서 대상을 선택합니다.

        주:

        대상 선택에 따라 스트리밍, 스테이지 및 병합, 스테이지 위치와 같은 추가 옵션이 있을 수 있습니다.
    • 대상 인증서:
      • 도메인을 선택합니다.
      • 지정된 도메인 내에서 별칭을 선택합니다.
      • 체크포인트 테이블을 선택합니다. 기본 선택 항목을 그대로 두거나 대상 배치에 대해 생성한 체크포인트 테이블을 선택합니다.
      • 최대 스레드 번호를 선택합니다(조정된 복제본만 해당).
  4. 관리되는 옵션 페이지에서 필요에 따라 선택적 필드에 정보를 입력한 다음 다음을 누릅니다.
    • 프로파일 이름(사용 가능한 경우)을 선택합니다.
    • 배치 건전성에 위기 사용.
    • 자동 시작 설정을 사용으로 설정하고 구성합니다.
  5. 매개변수 파일 페이지에서 매개변수를 추가하여 복제를 추가로 구성할 수 있습니다. 예를 들면, 다음과 같습니다.
    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")
  6. [속성 파일] 페이지에서 다음 Amazon S3 속성을 구성합니다.
    • gg.eventhandler.s3.region는 대상 S3 버킷에 대한 AWS 영역을 제공합니다.
    • gg.eventhandler.s3.bucketMappingTemplate:는 대상 S3 버킷 이름을 제공합니다. 버킷이 없으면 OCI GoldenGate에서 자동으로 생성할 수 있지만 버킷은 존재하지 않습니다. 정적 버킷 이름을 제공하거나 템플리트 키워드를 사용하여 버킷 이름을 동적으로 지정할 수 있습니다.

      주:

      버킷 이름에 소문자만 포함되어 있는지 확인하십시오. 대문자로 인해 Replicat가 실패할 수 있습니다.
    • (선택사항) gg.handler.abs.format: 출력 형식 지정 방법을 선택합니다. JSON이 기본 설정입니다. 사용 가능한 옵션은 다음과 같습니다.

      파케의 경우 추가 속성을 적용해야 합니다. 자세한 내용은 Parquet for Amazon S3를 참조하십시오.

      이 대상의 등록 정보에 대한 자세한 내용은 Oracle GoldenGate for Distributed Applications and Analytics 설명서의 Amazon S3를 참조하십시오.

  7. 생성 및 실행을 누릅니다. 생성을 누르면 나중에 관리 서비스 홈 페이지에서 복제를 수동으로 시작할 수 있습니다.

Replicat 추가(21c)

Amazon S3에 대한 복제 프로세스를 추가하는 방법을 알아보십시오.

Amazon S3 대상에 대한 Replicat를 추가하려면 다음과 같이 하십시오.
  1. OCI GoldenGate 배치 콘솔의 [관리 서비스 개요] 페이지에서 복제 추가(더하기 아이콘)를 누릅니다.
  2. [복제 추가] 페이지에서 [복제] 유형을 선택한 다음 다음을 누릅니다.
    복제본 유형은 다음과 같습니다.
    • 클래식 Replicat
    • 조정 Replicat
  3. 복제 옵션 페이지에서 다음 필드에 정보를 입력한 후 다음을 누릅니다.
    1. 프로세스 이름에 Replicat 프로세스의 이름을 입력합니다.
    2. (선택 사항) 설명에 이 프로세스를 다른 프로세스와 구분하기 위한 간단한 설명을 입력합니다.
    3. 추적 이름에 2자 추적 이름을 입력합니다.
    4. 대상의 경우 드롭다운에서 Amazon S3를 선택합니다.
    5. Amazon S3에 사용 가능한 별칭의 경우 드롭다운에서 별칭을 선택합니다.
  4. 매개변수 파일 페이지에서 필요에 따라 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.

  5. [속성 파일] 페이지에서 다음 Amazon S3 속성을 구성합니다.
    • gg.eventhandler.s3.region는 대상 S3 버킷에 대한 AWS 영역을 제공합니다.
    • gg.eventhandler.s3.bucketMappingTemplate:는 대상 S3 버킷 이름을 제공합니다. 버킷이 없으면 OCI GoldenGate에서 자동으로 생성할 수 있지만 버킷은 존재하지 않습니다. 정적 버킷 이름을 제공하거나 템플리트 키워드를 사용하여 버킷 이름을 동적으로 지정할 수 있습니다.

      주:

      버킷 이름에 소문자만 포함되어 있는지 확인하십시오. 대문자로 인해 Replicat가 실패할 수 있습니다.
    • (선택사항) gg.handler.abs.format: 출력 형식 지정 방법을 선택합니다. JSON이 기본 설정입니다. 사용 가능한 옵션은 다음과 같습니다.

      파케의 경우 추가 속성을 적용해야 합니다. 자세한 내용은 Parquet for Amazon S3를 참조하십시오.

  6. 생성 및 실행을 누릅니다. 생성을 누르면 나중에 [관리 서비스 개요] 페이지에서 수동으로 Replicat를 시작할 수 있습니다.
Replicat 프로세스 생성을 확인하고 Replicat 작업에 액세스할 수 있는 Administration Service Overview 페이지로 돌아갑니다.

알려진 문제

Amazon S3 및 공유 엔드포인트와의 Google Cloud Storage 연결에 대한 Java.net.UnknownHostException 오류 발생

임시해결책: 연결을 편집하고 트래픽 경로 지정 방법전용으로 변경하거나, Amazon S3Google Cloud Storage 연결을 생성할 때 전용을 선택합니다.

OCI GoldenGate의 Amazon S3 연결 관련 문제

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

ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
      [ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com

그런 다음 다음 다음 단계를 임시해결책으로 사용할 수 있습니다.

임시해결책:

  1. Cloud Shell에 접속합니다.
  2. 다음 CLI 샘플을 사용하여 새 Amazon S3 연결을 만듭니다.
    oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret>
  3. 배치에 연결을 할당합니다.
  4. Amazon S3Replicat를 추가하고 실행합니다.

또는 공용 액세스를 사용하지 않으려는 경우 AWS VPC Endpoints를 사용하도록 Amazon S3 연결의 버킷을 구성합니다. OCI GoldenGateVPC Endpoints를 사용하여 S3 버킷에 액세스하려면 VCN과 AWS VPC 간에 IPsec VPN도 구성해야 합니다.

Amazon S3에 대한 끝점을 설정하려면 gg.eventhandler.s3.url 속성을 Replicat 속성 파일에 추가하고 프라이빗 접속에 대한 끝점을 제공합니다.