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

이 페이지에서는 인스턴스 스토리지 용량을 줄이거나 축소하려고 할 때 발생할 수 있는 일반적인 오류 메시지를 설명합니다.

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

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

이 문제를 해결하려면 머신의 Google Cloud Hyperdisk 제한사항을 기반으로 사용할 대상 스토리지 크기를 다시 계산하고 스토리지 축소 작업을 다시 실행합니다.

취소 상태를 확인할 수 없음

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

  {
    "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"
  }

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

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

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

    {
  "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": ...
  }

이 오류 메시지는 인스턴스에 저장공간이 충분하지 않음을 나타낼 수 있습니다.

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

  1. 모든 스토리지 축소 단계를 따르세요.
  2. 대상 스토리지 크기가 이전에 설정한 최소 대상 크기 보다 큰지 확인합니다.

10일 후 스토리지 축소 실패

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

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

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

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

이 문제를 해결하려면 Cloud SQL 지원팀 에 문의하세요.

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

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

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

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

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

다음 단계