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 du stockage pour les types de machines C4, C4A et N4

L'erreur suivante peut se produire lorsque vous essayez d'appliquer une opération de réduction du stockage à un type de machine C4, 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 C4, 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 de Google Cloud Hyperdisk de votre machine, puis exécutez à nouveau l'opération de réduction du 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 du 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 du stockage ne sont pas compatibles avec les pools de lecture ni avec 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 du 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 du 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 du stockage

L'erreur suivante peut se produire lorsque vous essayez d'exécuter une opération de réduction du 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 du stockage précédente sur l'instance
  • Opération de réduction du 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 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 du 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 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 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 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 du 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 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 du stockage sur son instance principale associée.

Pour en savoir plus, consultez Limites.

Espace de stockage insuffisant

L'erreur suivante peut se produire lorsque vous essayez de définir la taille de réduction du 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. Assurez-vous de suivre toutes les étapes de réduction du 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 du stockage après 10 jours

Les opérations de réduction du stockage expirent si elles persistent pendant plus de 10 jours.

Pour résoudre le problème, mettez à niveau le processeur de l'instance afin de réduire le temps d'opération global.

Échec de la réduction du stockage avec une erreur interne

Les opérations de réduction du 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 du 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