OCI GoldenGate 연결과 관련하여 알려진 문제

연결과 관련된 알려진 문제 및 해결 방법을 살펴봅니다.

Oracle AI Data Platform: 리소스 주체 인증

Oracle AI Data Platform 연결에 대한 리소스 주체 인증에 다음 오류가 발생합니다.

JDBCMDP-00034 Current attempt to connect failed with error: [[JDBC Driver]Could not find private key: /tmp/ogg/ocid1.goldengateconnection.oc1.phx.amaa...lqabqqxq/privateKeyFile].

임시해결책: 접속을 편집하고 현재 테넌시 및 사용자 사용 또는 다른 테넌시 및 사용자 지정과 같은 다른 인증 방법을 선택합니다.

암호가 있는 접속을 사용하는 중 오류가 발생했습니다.

다음 버전의 OCI GoldenGate에서 암호 및 저장소가 포함된 접속을 사용할 때 접속 오류가 발생할 수 있습니다.

임시해결책: OCI Vault Secrets를 사용하지 않고 연결을 다시 생성하십시오.

  1. 접속 생성 페이지에서 페이지 하단의 고급 옵션을 확장합니다.

  2. 고급 옵션에서 설정을 확장합니다.

  3. Use secrets in vault의 선택을 해제합니다.

  4. 생성을 선택합니다.

또는 연결에서 고급 옵션을 사용할 수 없는 경우 이전 버전의 배포를 사용해 보십시오.

리소스 주체를 사용할 때 Oracle Object Storage 복제 오류가 발생했습니다.

Oracle Object Storage 연결에서 리소스 주체 인증을 사용하는 경우 다음 오류로 인해 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

임시해결책: 이 문제를 해결하려면 연결을 편집한 후 다른 인증 방법을 선택합니다.

AI 데이터 카탈로그 서비스 인증에 대한 Apache Iceberg 접속 오류

AI 데이터 카탈로그 서비스에 대한 Apache Iceberg 접속이 토큰 만료로 인한 인증 오류로 인해 만료됩니다. 이 문제가 발생하면 Oracle Support에 문의하십시오.

Apache Iceberg NoSuchFileException 오류

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

Caused by: java.nio.file.NoSuchFileException: /tmp/ogg/ocid1.goldengateconnection.oc1...../restCatalogProperties

Amazon S3 및 Google Cloud Storage 연결에 대한 Java.net.UnknownHostException 오류

공유 엔드포인트가 있는 Amazon S3 및 Google Cloud Storage 연결에 Java.net.UnknownHostException 오류가 발생합니다.

임시해결책: 연결을 편집하고 Amazon S3 및 Google 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> --connection-region <amazon_s3_bucket_region>

  3. 배치에 연결을 지정합니다.

  4. Amazon S3용 Replicat를 추가하고 실행합니다.

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

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

MongoDB 접속 문제 테스트

MongoDB 접속과 함께 테스트 접속을 사용할 때 오류가 발생할 수 있습니다. 이 오류를 무시하고 OCI GoldenGate 배치 콘솔에서 MongoDB 접속을 테스트할 수 있습니다. 배치 콘솔에서 관리 서비스에 대한 탐색 메뉴를 열고 구성을 선택합니다. MongoDB 접속이 인증서로 나열되어야 합니다. 여기서 **접속**을 선택하여 접속을 테스트할 수 있습니다.

mTLS 인증을 사용하는 자율운영 AI 데이터베이스 접속에 필요한 작업입니다.

자율운영 AI 데이터베이스 전자 지갑이 교체되면 이 데이터베이스에 대한 OCI GoldenGate 접속을 새로고침하여 최신 전자 지갑 정보를 검색해야 합니다.

자세한 내용은 My Oracle Support (MOS) Document 2911553.1을 참조하십시오.

자율운영 AI 데이터베이스 접속을 새로 고치려면 다음과 같이 하십시오. 자율운영 AI 데이터베이스(자율운영 AI 트랜잭션 처리(ATP) 또는 자율운영 AI 레이크하우스(ADL)에 대한 접속을 편집하고 저장합니다. 접속을 저장하면 전자 지갑이 자동으로 다운로드되고 새로 고쳐집니다. 연결에 대한 다른 변경 사항은 필요하지 않습니다.

확인하려면 다음을 수행합니다.

  1. 자율운영 AI 데이터베이스 접속을 사용하는 배치에 대한 배치 콘솔을 실행합니다.

  2. 배치 콘솔에서 탐색 메뉴를 열고 구성을 선택합니다.

  3. Credentials 화면에서 Autonomous AI Database 연결 문자열을 확인합니다.

    전자 지갑을 새로 고치기 전에 연결 문자열은 다음과 같습니다.

    ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))

    전자 지갑(wallet)이 refresh되면 연결 문자열이 다음과 같이 갱신됩니다.

    ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_dn_match=yes)))

MySQL 데이터베이스가 인증서 별칭 목록에 나타나지 않습니다.

MySQL '@' 기호가 포함된 데이터베이스 사용자 이름은 OCI GoldenGate 배치 콘솔에서 Extract를 생성할 때 인증서 별칭 목록에 나타나지 않습니다.

임시해결책: 목록에서 다른 별칭을 선택한 후 다음 화면에서 매개변수 파일을 수동으로 업데이트합니다.

네트워크 시간 초과는 프라이빗 끝점을 사용한 데이터베이스 접속에 영향을 줍니다.

프라이빗 끝점을 사용하여 데이터베이스에 접속하는 경우 Extract 프로세스를 시작하거나 정지할 때 네트워크 시간 초과가 발생할 수 있습니다.

임시해결책: 다음 중 하나를 수행합니다.

SCAN 프록시가 TLS를 지원하지 않습니다.

OCI GoldenGate는 Oracle SCAN(단일 클라이언트 액세스 이름) 호스트 및 IP를 지원하지만 SCAN 프록시는 TLS를 지원하지 않습니다.

임시해결책: 데이터베이스 노드 IP를 사용하여 RAC 데이터베이스에 연결할 수 있습니다.

Oracle Object Storage 접속에서 사용자 OCID 불일치(통합 사용자만 해당)

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

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

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