Problèmes de mise à jour de la capacité de stockage

Cette page décrit les messages d'erreur courants que vous pouvez recevoir lorsque vous tentez de réduire ou de réduire la capacité de stockage d'une instance.

Échec de la réduction de l'espace de stockage pour les types de machines C4A et N4

L'erreur suivante peut se produire lorsque vous essayez d'appliquer une opération de réduction de l'espace de stockage à un type de machine C4A ou 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.

Les types de machines C4A et N4 utilisent Google Cloud Hyperdisk, ce qui permet aux utilisateurs d'ajuster les valeurs de débit et d'IOPS du disque. Si vous essayez de réduire la taille du disque à un point où les valeurs de débit et d'IOPS configurées deviennent non valides, l'opération de réduction du disque échoue et renvoie une erreur.

Dans cet exemple de message d'erreur, la valeur d'IOPS demandée pour l'instance est supérieure à la nouvelle valeur maximale d'IOPS pour le petit disque, et l'opération échoue.

Pour résoudre ce problème, recalculez la taille de stockage cible que vous souhaitez utiliser en fonction des limites Google Cloud Hyperdisk de votre machine, puis exécutez à nouveau l'opération de réduction de l'espace de stockage.

Échec des opérations pour un pool de lecture

Les erreurs suivantes se produisent lorsque vous essayez d'exécuter une opération liée à la réduction de l'espace de stockage sur un pool de lecture :

Exemple 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.

Les opérations de réduction de l'espace de stockage ne sont pas compatibles avec les pools de lecture ni les nœuds de pool de lecture.

Exemple 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.

Vous ne pouvez pas vérifier la configuration de réduction de l'espace de stockage d'un pool de lecture, d'un nœud de pool de lecture ni d'une instance répliquée.

Vous pouvez toutefois vérifier la capacité de stockage disponible de l' instance principale associée.

Impossible de vérifier l'état de l'annulation

L'erreur suivante peut se produire lorsque vous essayez de vérifier l'état d'une demande d'annulation pour une opération de réduction de l'espace de stockage :

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

Pour résoudre ce problème, procédez comme suit :

  1. Ce message d'erreur peut indiquer que la demande d'annulation est presque terminée. Essayez de vérifier à nouveau l'état de l'opération dans quelques minutes.
  2. Si le même message d'erreur s'affiche toujours, contactez l'assistance Cloud SQL pour obtenir de l'aide.

  3. En cas de réussite, un message semblable à celui-ci s'affiche :

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

Échec de la réduction de l'espace de stockage

L'erreur suivante peut se produire lorsque vous essayez d'exécuter une opération de réduction de l'espace de stockage :

  There is a pending blocking operation for instance: INSTANCE_NAME

Ce message d'erreur peut indiquer qu'une autre opération est toujours en cours d'exécution, par exemple :

  • Opération de sauvegarde
  • Opération d'importation
  • Opération de réduction de l'espace de stockage précédente sur l'instance
  • Opération de réduction de l'espace de stockage toujours en cours d'exécution sur une instance principale associée à l'instance répliquée avec accès en lecture que vous souhaitez modifier

Pour résoudre le problème, attendez la fin de l'opération précédente.

Si une opération IMPORT précédente est bloquée, contactez l'assistance Cloud SQL pour demander de l'aide afin d'annuler l'opération.

Pour en savoir plus, consultez la section Limites.

Taille de stockage non valide pour une instance principale

Les erreurs suivantes peuvent se produire lorsque vous essayez d'exécuter une opération de réduction de l'espace de stockage sur une instance principale et que la taille cible demandée n'est pas valide :

Exemple 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.

  • La taille cible demandée doit être supérieure ou égale à la taille de stockage minimale autorisée pour l'instance.

    Pour résoudre le problème, spécifiez une taille de stockage cible plus grande et exécutez à nouveau l'opération.

    Pour en savoir plus, consultez la section Limites.

Exemple 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.

  • La taille cible demandée est trop petite. Si la taille cible demandée pour --storage-size est déjà à la taille minimale de 10 Go, vous ne pouvez pas la réduire davantage.

    Pour résoudre le problème, spécifiez une taille de stockage cible plus grande et exécutez à nouveau l'opération.

    Pour en savoir plus, consultez la section Limites.

Exemple 3

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

  • Si la taille cible demandée pour --storage-size est trop petite, exécutez la commande suivante sur l'instance principale pour obtenir la capacité de stockage minimale autorisée :

    gcloud sql instances get-storage-shrink-config PRIMARY_INSTANCE_NAME

    La réponse inclut une valeur pour minimalTargetSizeGb. Vous pouvez utiliser cette valeur pour le paramètre --storage-size et exécuter à nouveau l'opération.

Exemple 4

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

  • Si la taille cible demandée pour --storage-size est trop grande, cela indique que la valeur est supérieure à la taille de stockage actuelle de l'instance principale et que vous devez utiliser une valeur plus petite.

    Si vous souhaitez disposer d'un disque plus grand, modifiez d'abord l'instance , puis réessayez l'opération.

Exemple 5

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

  • Si la taille cible demandée est trop proche de la taille de stockage existante, vous devez modifier la valeur et exécuter à nouveau l'opération. Voici quelques options de modification :

    • Augmentez la valeur cible.
    • Définissez la valeur cible sur la même valeur que la minimalTargetSizeGb valeur.

    Pour en savoir plus, consultez la section Limites.

Taille de stockage non valide pour une instance répliquée

Les erreurs suivantes peuvent se produire lorsque vous essayez d'exécuter une opération de réduction de l'espace de stockage sur une instance répliquée et que la taille cible demandée n'est pas valide :

Exemple 1

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

Si la taille cible demandée pour --storage-size est déjà à la taille minimale de 10 Go, vous ne pouvez pas la réduire davantage.

Pour résoudre le problème, spécifiez une taille de stockage cible qui se situe dans une plage acceptable et exécutez à nouveau l'opération.

Pour en savoir plus, consultez la section Limites.

Exemple 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.

Une instance répliquée avec accès en lecture ne peut à aucun moment avoir une capacité de stockage inférieure à celle de son instance principale associée. Si vous souhaitez réduire la capacité de stockage d'une instance répliquée, vous devez d'abord effectuer une opération de réduction de l'espace de stockage sur son instance principale associée.

Pour en savoir plus, consultez la section Limites.

Espace de stockage insuffisant

L'erreur suivante peut se produire lorsque vous essayez de définir la taille de réduction de l'espace de stockage :

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

Ce message d'erreur peut indiquer que vous ne disposez pas de suffisamment d'espace de stockage sur l' instance.

Pour résoudre ce problème, procédez comme suit :

  1. Veillez à suivre toutes les étapes de réduction de l'espace de stockage.
  2. Assurez-vous que la taille de stockage cible est supérieure à la taille cible minimale que vous avez définie précédemment.

Échec de la réduction de l'espace de stockage après 10 jours

Les opérations de réduction de l'espace de stockage expirent si elles durent plus de 10 jours.

Pour résoudre le problème, mettez à niveau le processeur de l'instance afin de réduire la durée globale de l'opération.

Échec de la réduction de l'espace de stockage avec une erreur interne

Les opérations de réduction de l'espace de stockage qui échouent peuvent renvoyer un message indiquant une erreur interne.

Pour résoudre le problème, contactez l'assistance Cloud SQL pour obtenir de l'aide.

Échec de la commande gcloud de réduction de l'espace de stockage après 10 minutes

L'erreur suivante peut se produire lorsque vous essayez de réduire la taille de stockage d'une instance à l'aide de la gcloud sql instances commande :

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

Ce message d'erreur peut s'afficher si l'opération dure plus de 10 minutes.

Pour résoudre le problème, ajoutez l'--async indicateur à la fin de la commande pour attendre l'opération de manière asynchrone.

Étape suivante