이 페이지의 일부 또는 모든 정보는 S3NS의 Cloud de Confiance에 적용되지 않을 수 있습니다. 자세한 내용은 Google Cloud와의 차이점을 참조하세요.

스토리지 용량 업데이트 문제

MySQL | PostgreSQL | SQL Server

이 페이지에서는 인스턴스 스토리지 용량을 줄이려고 할 때 표시될 수 있는 일반적인 오류 메시지를 설명합니다.

C4A 및 N4 머신 유형의 스토리지 축소가 실패함

C4A 또는 N4 머신 유형에 스토리지 축소 작업을 적용하려고 하면 다음 오류가 발생할 수 있습니다.

  ERROR: (gcloud.sql.instances.perform-storage-shrink) HTTPError 400: Invalid
  request: Requested provisioned IOPS is too high for the machine type and/or data disk size.

C4A 및 N4 머신 유형은 사용자가 디스크 처리량 및 IOPS 값을 조정할 수 있는 Google Cloud Hyperdisk를 사용합니다. 구성된 처리량 및 IOPS 값이 무효화되는 지점까지 디스크 크기를 축소하려고 하면 디스크 축소 작업이 실패하고 오류가 반환됩니다.

이 예시 오류 메시지에서 요청된 인스턴스 IOPS 값이 새 소형 디스크 최대 IOPS 값보다 크므로 작업이 실패합니다.

이 문제를 해결하려면 머신의 Google Cloud Hyperdisk 제한에 따라 사용할 타겟 스토리지 크기를 다시 계산하고 스토리지 축소 작업을 다시 실행하세요.

읽기 풀에서 작업이 실패함

읽기 풀에서 스토리지 축소 관련 작업을 실행하려고 하면 다음 오류가 발생합니다.

예 1

gcloud sql instances perform-storage-shrink READ_POOL_NAME

ERROR: (gcloud.sql.instances.perform-storage-shrink) HTTPError 400: Invalid
request: Requested operation is not supported on a read pool.

읽기 풀 또는 읽기 풀 노드에는 스토리지 축소 작업이 지원되지 않습니다.

예 2

gcloud sql instances get-disk-shrink-config READ_POOL_NAME

ERROR: (gcloud.sql.instances.get-storage-shrink-config) HTTPError 400: Invalid
request: Requested operation is not supported on a read pool.

읽기 풀, 읽기 풀 노드 또는 복제본의 스토리지 축소 구성은 확인할 수 없습니다.

하지만 연결된 기본 인스턴스의 사용 가능한 스토리지 용량은 확인할 수 있습니다.

취소 상태를 확인할 수 없음

스토리지 축소 작업의 취소 요청 상태를 확인하려고 하면 다음 오류가 발생할 수 있습니다.

  {
    "kind": "sql#operation",
    "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/example_instance",
    "status": "RUNNING",
    "user": "user@example.com",
    "insertTime": "2023-12-18T22:54:11.663Z",
    "startTime": "2023-12-18T22:54:12.047Z",
    "error": {
      "kind": "sql#operationErrors",
      "errors": [
        {
          "kind": "sql#operationError",
          "code": "CANCEL_ERROR",
          "message": "The UPDATE operation 490cdbe6-8b75-415c-99c1-ccc80000004f can not be cancelled."
        }
      ]
    },
    "operationType": "UPDATE",
    "name": "OPERATION_ID",
    "targetId": "example_instance",
    "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
    "targetProject": "PROJECT_ID"
  }

이 문제를 해결하려면 다음 단계를 따르세요.

이 오류 메시지는 취소 요청이 거의 완료되었음을 나타낼 수 있습니다. 몇 분 후에 작업 상태를 다시 확인해 보세요.
동일한 오류 메시지가 계속 표시되면 Cloud SQL 지원팀에 문의하여 도움을 받으세요.

성공하면 다음과 유사한 메시지가 반환됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/example_instance",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2023-12-18T22:54:11.663Z",
  "startTime": "2023-12-18T22:54:12.047Z",
  "error": {
    "kind": "sql#operationErrors",
    "errors": [
      {
        "kind": "sql#operationError",
        "code": "CANCEL_SUCCESSFUL",
        "message": "The UPDATE operation is canceled."
      }
    ]
  },
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "example_instance",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

스토리지 축소 실패

스토리지 축소 작업을 실행하려고 하면 다음 오류가 발생할 수 있습니다.

  There is a pending blocking operation for instance: INSTANCE_NAME

이 오류 메시지는 다음과 같은 다른 작업이 아직 실행 중임을 나타낼 수 있습니다.

백업 작업
가져오기 작업
인스턴스에서 이전에 실행된 스토리지 축소 작업
수정하려는 읽기 복제본과 연결된 기본 인스턴스에서 스토리지 축소 작업이 아직 실행 중입니다.

이 문제를 해결하려면 이전 작업이 완료될 때까지 기다립니다.

이전 IMPORT 작업이 멈춘 경우 Cloud SQL 지원팀에 문의하여 작업 취소를 요청하세요.

자세한 내용은 제한사항을 참고하세요.

기본 인스턴스의 스토리지 크기가 잘못됨

기본 인스턴스에서 스토리지 축소 작업을 실행하려고 하는데 요청된 타겟 크기가 유효하지 않으면 다음 오류가 발생할 수 있습니다.

예 1

  Invalid target storage size SIZE. Target storage
  size should be at least 10GB, which is the minimum storage size for a
  Cloud SQL instance.

요청된 타겟 크기는 인스턴스에 허용된 최소 스토리지 크기보다 크거나 같아야 합니다.

이 문제를 해결하려면 더 큰 타겟 스토리지 크기를 지정하고 작업을 다시 실행하세요.

자세한 내용은 제한사항을 참고하세요.

예 2

  Instance INSTANCE_NAME cannot shrink storage further
  because the storage size is 10GB and the minimum storage size for a Cloud SQL
  instance is 10GB.

요청된 타겟 크기가 너무 작습니다. --storage-size의 요청된 타겟 크기가 이미 최소 크기인 10GB인 경우 더 줄일 수 없습니다.

이 문제를 해결하려면 더 큰 대상 스토리지 크기를 지정하고 작업을 다시 실행하세요.

자세한 내용은 제한사항을 참고하세요.

예시 3

  ERROR: (gcloud.sql.instances.perform-storage-shrink) argument --storage-size: VALUE
  must be greater than or equal to 10GB; received: SIZE

--storage-size의 요청된 타겟 크기가 너무 작으면 기본 인스턴스에서 다음 명령어를 실행하여 허용되는 최소 스토리지 용량을 가져옵니다.
```
gcloud sql instances get-storage-shrink-config PRIMARY_INSTANCE_NAME
```
응답에는 minimalTargetSizeGb 값이 포함됩니다. --storage-size 매개변수에 이 값을 사용하고 작업을 다시 실행할 수 있습니다.

예 4

  Invalid target storage size SIZE. Target storage
  size should be smaller than present storage size CURRENT_SIZE.

--storage-size의 요청된 타겟 크기가 너무 크면 값이 기본 인스턴스의 현재 스토리지 크기보다 크다는 의미이므로 더 작은 값을 사용해야 합니다.

더 큰 디스크를 사용하려면 먼저 인스턴스를 수정한 후 작업을 다시 시도하세요.

예시 5

  Requested storage size is too close to current storage usage, request storage
  size should be minimum SIZEGB.

요청된 타겟 크기가 기존 스토리지 크기와 너무 가까운 경우 값을 수정하고 작업을 다시 실행해야 합니다. 수정 옵션에는 다음이 포함됩니다.
- 목표 값을 늘립니다.
- 타겟 값을 minimalTargetSizeGb 값과 동일하게 설정합니다.
자세한 내용은 제한사항을 참고하세요.

복제본의 스토리지 크기가 잘못됨

복제본에서 스토리지 축소 작업을 실행하려고 하는데 요청된 타겟 크기가 유효하지 않으면 다음 오류가 발생할 수 있습니다.

예 1

  Cannot shrink storage further for replica INSTANCE_NAME
  because the minimum storage size for a Cloud SQL replica is 10GB.

--storage-size의 요청된 타겟 크기가 이미 최소 크기인 10GB인 경우 더 줄일 수 없습니다.

이 문제를 해결하려면 허용되는 범위 내에 있는 대상 스토리지 크기를 지정하고 작업을 다시 실행하세요.

자세한 내용은 제한사항을 참고하세요.

예 2

  Cannot shrink storage further for replica REPLICA_INSTANCE_NAME
  because current replica storage size isn't greater than primary instance
  PRIMARY_INSTANCE_ID storage size. If you want to shrink
  both primary and replica instance, please shrink primary instance first.

읽기 복제본의 스토리지 용량은 언제든지 연결된 기본 인스턴스보다 작을 수 없습니다. 복제본의 스토리지 용량을 줄이려면 먼저 연결된 기본 인스턴스에서 스토리지 축소 작업을 완료해야 합니다.

자세한 내용은 제한사항을 참고하세요.

저장공간 부족

스토리지 축소 크기를 설정하려고 하면 다음 오류가 발생할 수 있습니다.

  {
    "error": {
      "code": 400,
      "message": "Invalid target storage size TARGET_SIZE. ...",
      "errors": ...
  }

이 오류 메시지는 인스턴스의 저장용량이 부족함을 나타낼 수 있습니다.

이 문제를 해결하려면 다음 단계를 따르세요.

모든 저장소 축소 단계를 따라야 합니다.
타겟 스토리지 크기가 이전에 설정한 최소 타겟 크기보다 큰지 확인합니다.

`max_wal_size` 값이 너무 큼

PostgreSQL 인스턴스의 스토리지 크기를 줄이려고 하면 다음 오류가 발생할 수 있습니다.

  {
    "error": {
      "code": 400,
      "message": "Operation not allowed on instance INSTANCE_NAME with max_wal_size = MAX_WAL_SIZE, should be set less than 5120 before disk shrink operation..",
      "errors": ...
  }

max_wal_size 플래그의 설정 값이 너무 높으면 인스턴스가 다시 시작되는 데 시간이 오래 걸려 작업이 시간 초과되고 실패할 수 있습니다.

이 문제를 해결하려면 max_wal_size 값을 5128MB 미만으로 업데이트해야 합니다. 데이터베이스 플래그를 수정하는 방법의 예를 보려면 데이터베이스 플래그 구성을 참고하세요.

다음은 명령어의 예시입니다.

  gcloud sql instances patch INSTANCE_NAME \
  --database-flags=max_wal_size=MAX_WAL_SIZE

다음을 바꿉니다.

INSTANCE_NAME: 복제본 인스턴스의 이름
MAX_WAL_SIZE: 사용할 최대 미리 쓰기 로그입니다.

10일 후 스토리지 축소 실패

작업이 10일 이상 지속되면 스토리지 축소 작업이 시간 초과됩니다.

이 문제를 해결하려면 인스턴스의 CPU를 업그레이드하여 전체 작업 시간을 줄이세요.

내부 오류로 인해 스토리지 축소 실패

스토리지 축소 작업이 실패하면 내부 오류를 나타내는 메시지가 반환될 수 있습니다.

이 문제를 해결하려면 Cloud SQL 지원팀에 문의하여 도움을 받으세요.

10분 후 스토리지 축소 `gcloud` 명령어가 실패함

gcloud sql instances 명령어를 사용하여 인스턴스의 스토리지 크기를 줄이려고 하면 다음 오류가 발생할 수 있습니다.

  Performing a storage size decrease on a Cloud SQL instance....failed.

작업이 10분 이상 지속되면 이 오류 메시지가 표시될 수 있습니다.

이 문제를 해결하려면 명령어 끝에 --async 플래그를 추가하여 작업을 비동기식으로 기다립니다.

스토리지 용량 업데이트 문제

C4A 및 N4 머신 유형의 스토리지 축소가 실패함

읽기 풀에서 작업이 실패함

예 1

예 2

취소 상태를 확인할 수 없음

스토리지 축소 실패

기본 인스턴스의 스토리지 크기가 잘못됨

예 1

예 2

예시 3

예 4

예시 5

복제본의 스토리지 크기가 잘못됨

예 1

예 2

저장공간 부족

max_wal_size 값이 너무 큼

10일 후 스토리지 축소 실패

내부 오류로 인해 스토리지 축소 실패

10분 후 스토리지 축소 gcloud 명령어가 실패함

다음 단계

`max_wal_size` 값이 너무 큼

10분 후 스토리지 축소 `gcloud` 명령어가 실패함