PostgreSQL용 Cloud SQL 오류 메시지

비공개 연결을 수정해야 합니다. 다음 명령어를 사용하고 --force 인수를 사용합니다.

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

Illegal Argument의 경우 요청을 검사하여 각 인수가 허용되고 각 인수 값이 유효한지 확인합니다. 그 외 모든 원인은 로그 파일을 검사하여 추가 정보가 있는지 확인합니다.

비공개 연결을 수정해야 합니다. 다음 명령어를 사용하고 --force 인수를 사용합니다.

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

내보내기를 수행하려고 하는데 Cloud Storage가 특정 기간 내에 데이터를 수신하지 않으면 연결이 재설정됩니다.

pg_dump를 사용하여 직접 내보내기를 시도합니다.

가능하면 Cloud SQL 인스턴스에서 모든 Authorized Networks 항목을 삭제합니다. 그렇지 않으면 Authorized Networks 항목 없이 복제본을 만듭니다.

기본 사용자와 연결한 후 사용자를 변경합니다.

기본 인스턴스를 수정하여 더 큰 디스크 크기로 업그레이드합니다.

할당된 IP 범위에서 여유 블록을 찾을 수 없습니다. 이 서비스 제공업체에 새 범위를 할당하세요.

할당된 IP 범위에 사용 가능한 주소가 더 이상 없습니다.

다음 시나리오를 고려해 보세요.

• 비공개 서비스 연결에 할당된 IP 범위의 크기가 /24보다 작습니다.
• 비공개 서비스 연결에 할당된 IP 범위의 크기가 Cloud SQL 인스턴스 수에 비해 너무 작습니다.
• 인스턴스가 여러 리전에서 생성되는 경우 할당된 IP 범위의 크기 요구사항이 더 커집니다. 할당된 범위 크기를 참조하세요.

위의 각 시나리오에서 비공개 서비스 연결에 대해 기존 IP 범위를 확장하거나 ���가 IP 범위를 할당할 수 있습니다.

새 범위를 할당하는 경우 기존 할당과 겹치는 할당을 만들지 않도록 주의합니다.

새 IP 범위를 만든 후 다음 명령어를 사용하여 VPC 피어링을 업데이트합니다.

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK
--project=PROJECT_ID \
--force

기존 할당을 확장하는 경우 할당 범위를 늘리기만 하고 줄이지 않도록 합니다. 예를 들어 원래 할당이 10.0.10.0/24인 경우 새 할당을 최소 10.0.10.0/23으로 만듭니다.

일반적으로 /24 할당에서 시작하는 경우 각 조건(추가 인스턴스 유형 그룹, 추가 리전)에 대해 /mask를 1만큼 줄이는 것이 좋은 규칙입니다. 예를 들어 동일한 할당에서 인스턴스 유형 그룹을 둘 다 만들려는 경우 /24에서 /23으로 전환하면 충분합니다.

기존 IP 범위를 확장한 후 다음 명령어를 사용하여 VPC 피어링을 업데이트합니다.

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force

현재 Cloud Shell에서 비공개 IP 주소만 있는 인스턴스로 연결할 수 없습니다.

서비스 권한을 복구하려면 Service Networking API를 사용 중지하고 5분 정도 기다린 후 다시 사용 설정합니다.

프로젝트에서 Service Networking API를 사용 설정합니다. Cloud SQL 인스턴스에 비공개 IP 주소를 할당하려고 하고 공유 VPC를 사용할 때 이 오류가 표시되면 호스트 프로젝트에도 Service Networking API를 사용 설정해야 합니다.

프로젝트에서 Service Networking API를 사용 설정합니다. Cloud SQL 인스턴스에 비공개 IP 주소를 할당하려고 하고 공유 VPC를 사용할 때 이 오류가 표시되면 호스트 프로젝트에도 Service Networking API를 사용 설정해야 합니다.

이전 작업이 완료될 때까지 기다린 후에 다른 작업을 시작합니다.

대상 인스턴스를 수정하여 스토리지 크기를 늘립니다.

Google Cloud Console에서 할당량 증가를 요청합니다.

max_connections 플래그의 값을 늘립니다. 데이터베이스 플래그 구성을 참조하세요.

GOOGLE_APPLICATION_CREDENTIALS 환경 변수에 저장된 위치에 유효한 서비스 계정 키 JSON 파일이 있고 이 변수가 올바른 위치를 가리키고 있는지 확인합니다.

새 서버 인증서를 만들고 순환합니다.

• 사용자에게 필요한 일부 Cloud Storage 권한이 없을 수 있습니다.
• 데이터베이스 테이블이 없을 수 있습니다.

해결 방법:

• 최소한 버킷에 대한 WRITER 권한과 내보내기 파일에 대한 READER 권한이 있는지 확인합니다. Cloud Storage에서 액세스 제어를 구성하는 방법에 대한 자세한 내용은 액세스제어 목록 만들기 및 관리를 참조하세요.
• 테이블이 있는지 확인합니다. 테이블이 있으면 스토리지 버킷에 대한 올바른 권한이 있는지 확인합니다.

내보내기 작업 중에 다음 문을 사용하면 덤프 트랜잭션이 실패할 수 있습니다.

• ALTER TABLE
• CREATE TABLE
• DROP TABLE
• RENAME TABLE
• TRUNCATE TABLE

덤프 작업에서 이러한 문을 삭제합니다.

temp_file_limit 크기를 늘립니다. 데이터베이스 플래그 구성을 참조하세요.

CSV 형식을 사용하고 여러 개의 작은 내보내기 작업을 실행하여 각 작업의 크기와 길이를 ���입니다.

max_connections 플래그 값을 낮추거나 고객지원에 연락하여 플래그 삭제 후 hard drain을 요청합니다. 이렇게 하면 플래그 또는 설정 없이 새 구성으로 인스턴스가 다른 호스트에서 강제로 다시 시작됩니다.

• 데이터베이스 수준에서 데이터베이스 사용자가 있어야 하며 비밀번호가 일치해야 합니다.
• 프로젝트 수준에서 사용자에게 serviceusage.services.use 또는 cloudsql.instances.connect 권한을 포함한 올바른 IAM 권한이 없을 수 있습니다.
• 네트워크 수준에서 Cloud SQL 인스턴스가 공개 IP를 사용하는 경우 연결의 소스 IP가 승인된 네트워크에 있어야 합니다.

해결 방법:

• 사용자가 존재하고 비밀번호가 일치하는지 확인합니다.
• 사용자 계정에 Service Usage Consumer 역할을 할당합니다. 이 역할에는 serviceusage.services.use 권한이 포함됩니다.
• 공개 IP를 사용하는 경우 소스 IP가 승인된 네트워크에 있는지 확인합니다.

해결될 때까지 해결 방법이 나와 있는 GitHub의 토론을 참조하세요.

• 이 오류는 최근에 삭제한 인스턴스와 동일한 이름을 다시 사용하려고 할 때 발생할 수 있습니다.
• 또한 간헐적인 연결 문제로 인해 발생할 수도 있습니다.
• 프로젝트에 대해 Service Networking API가 사용 설정되지 않았다고 로그에 표시될 수 있습니다.
• 여러 인스턴스를 동시에 만들려고 할 때도 이 오류가 표시됩니다. 예를 들어 Terraform 스크립트를 사용하면 이 시도가 가능합니다.
• 또 다른 원인은 특정 리소스가 소진되었거나 할당량 한도가 초과되었기 때문일 수 있습니다. 로그에서 Quota 'INTERNAL_FORWARDING_RULES_WITH_TARGET_INSTANCE_PER_NETWORK' exceeded. Limit: 100.0 globally와 같은 항목을 찾습니다.
• 이 오류는 IP 범위에 사용 가능한 주소가 더 이상 없으면 서브넷을 만들 수 없는 경우에 발생할 수 있습니다.

• 인스턴스 이름은 삭제 후 일주일이 지나야 다시 사용할 수 있습니다.
• 간헐적인 연결 문제의 경우에 다시 시도하면 문제가 해결됩니다.
• 프로젝트에 Service Networking API를 사용 설정합니다.
• 병렬 인스턴스 만들기 스크립트는 인스턴스 중 하나만 만들 때만 성공합니다. 다음 인스턴스 작업을 계속하기 전에 각 인스턴스 만들기 작업이 완료될 때까지 기다리도록 스크립트를 수정합니다.
• 새 범위를 할당합니다.

오류가 set Service Networking service account as servicenetworking.serviceAgent role on consumer project이면 Service Networking API를 사용 중지했다가 다시 사용 설정합니다. 이렇게 하면 프로세스를 계속 진행하는 데 필요한 서비스 계정이 생성됩니다.

오류가 The instance creation failed due to a permission error with the CMEK key defined이면 키 설정 및 위치를 검토합니다.