Mettre à niveau une instance vers l'édition Cloud SQL Enterprise Plus en utilisant la mise à niveau sur place


Cette page explique comment utiliser la méthode de mise à niveau sur place pour mettre à niveau une instance Cloud SQL Enterprise vers l'édition Cloud SQL Enterprise Plus. En outre, elle décrit également la procédure à suivre pour basculer d'une instance Cloud SQL Enterprise Plus à l'édition Cloud SQL Enterprise.

La mise à niveau vers l'édition Cloud SQL Enterprise Plus vous offre plusieurs avantages et des améliorations de performances. Pour en savoir plus, consultez la page Présentation des éditions Cloud SQL pour PostgreSQL.

Pour activer ces améliorations pour vos instances Cloud SQL Enterprise existantes, vous devez les mettre à niveau vers l'édition Cloud SQL Enterprise Plus. Le processus de mise à niveau prend quelques minutes et n'entraîne que très peu de temps d'arrêt. Le basculement vers l'édition Cloud SQL Enterprise peut entraîner jusqu'à 60 secondes d'indisponibilité.

De plus, ce processus de mise à niveau ne nécessite pas que vous modifiiez les points de terminaison auxquels vos applications se connectent.

Avant de commencer

  • Assurez-vous d'exécuter une instance Cloud SQL Enterprise sur PostgreSQL 12 ou version ultérieure.

    Si votre instance utilise une version antérieure de PostgreSQL, vous devez la mettre à niveau vers PostgreSQL 12 ou version ultérieure. Pour en savoir plus, consultez la page Mettre à niveau la version majeure de la base de données sur place.

Vérifier l'emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis

Toutes les instances de l'édition Cloud SQL Enterprise Plus sont automatiquement activées avec la récupération à un moment précis (PITR). Si l'instance Cloud SQL Enterprise que vous souhaitez mettre à niveau stocke les journaux WAL utilisés pour la récupération PITR sur le disque, le processus de mise à niveau vers l'édition Cloud SQL Enterprise Plus change l'emplacement de stockage des journaux WAL vers Cloud Storage.

Avant de passer à l'édition Cloud SQL Enterprise Plus, vérifiez si votre instance Cloud SQL Enterprise sera soumise au changement d'emplacement de stockage des journaux WAL utilisés pour la récupération à un moment précis. Pour en savoir plus et obtenir des instructions sur la vérification de votre instance, consultez la section Vérifier l'emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis.

Pour en savoir plus sur le changement d'emplacement de stockage des journaux de transactions lors du processus de mise à niveau, consultez la section Emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis.

Mettre à niveau une instance vers l'édition Cloud SQL Enterprise Plus

Suivez la procédure décrite dans cette section pour passer d'une instance Cloud SQL Enterprise à l'édition Cloud SQL Enterprise Plus.

Console

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Cliquez sur Modifier.
  4. Dans la section Choisir une édition Cloud SQL, cliquez sur Mettre à niveau.
  5. Dans le panneau Passer à l'édition Enterprise Plus, saisissez l'ID de votre instance, puis cliquez sur Mettre à niveau l'édition.

Vous pouvez également mettre à niveau une instance en cliquant sur Mettre à niveau dans la section Configuration de la page Présentation de l'instance.

gcloud

L'exemple de code suivant montre comment mettre à niveau votre instance vers l'édition Cloud SQL Enterprise Plus :

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Facultatif : vous pouvez également activer le cache de données pour votre instance en ajoutant l'option --enable-data-cache.

Remplacez les éléments suivants :

  • PROJECT_ID : ID de projet de l'instance que vous souhaitez mettre à niveau.
  • INSTANCE_ID : nom de l'instance que vous souhaitez mettre à niveau.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez effectuer la mise à niveau. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise Plus, consultez la page Types de machines pour les instances Cloud SQL Enterprise Plus.

REST

La commande suivante met à niveau votre instance vers l'édition Cloud SQL Enterprise et déclenche une opération de redémarrage.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de projet de l'instance que vous souhaitez mettre à niveau.
  • INSTANCE_ID : ID de l'instance que vous souhaitez mettre à niveau.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez effectuer la mise à niveau. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise Plus, consultez la page Types de machines pour les instances Cloud SQL Enterprise Plus.

Facultatif : vous pouvez activer le cache de données en définissant le paramètre dataCacheEnabled sur true.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corps JSON de la requête :

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

La commande suivante met à niveau votre instance vers l'édition Cloud SQL Enterprise et déclenche une opération de redémarrage.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de projet de l'instance que vous souhaitez mettre à niveau.
  • INSTANCE_ID : ID de l'instance que vous souhaitez mettre à niveau.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez effectuer la mise à niveau. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise Plus, consultez la page Types de machines pour les instances Cloud SQL Enterprise Plus.

Facultatif : vous pouvez activer le cache de données en définissant le paramètre dataCacheEnabled sur true.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corps JSON de la requête :

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis

Si votre instance Cloud SQL Enterprise stocke les journaux de transactions pour la récupération PITR sur disque, le processus de mise à niveau vers l'édition Cloud SQL Enterprise Plus change l'emplacement de stockage de ces journaux vers Cloud Storage.

Les conditions suivantes s'appliquent au processus de changement de zone géographique :

  • Le processus prend environ la durée du paramètre de configuration de la récupération PITR transactionLogRetentionDays pour passer à Cloud Storage.
  • Lors du passage à Cloud Storage, nous vous recommandons de ne pas modifier le paramètre de configuration PITR de transactionLogRetentionDays. Même si vous augmentez transactionLogRetentionDays, les journaux WAL ne seront pas conservés sur le disque plus longtemps que la durée par défaut de sept jours pour une instance de l'édition Cloud SQL Enterprise.

Paramètres par défaut de stockage des journaux et de sauvegarde pour l'édition Cloud SQL Enterprise Plus

Une fois la mise à niveau vers l'édition Cloud SQL Enterprise Plus terminée, la durée de conservation des journaux de transactions par défaut pour toutes les instances mises à niveau est augmentée à 14 jours. Pour cette augmentation, et toute autre augmentation que vous configurez pour la durée de conservation des journaux de transactions, il faut attendre que la nouvelle valeur soit augmentée pour atteindre la période de conservation complète de la récupération PITR. Par exemple, si l'ancienne valeur des jours de conservation des journaux de transactions est de 7 et que la nouvelle valeur est augmentée à 14, la période de récupération PITR pour les sept premiers jours suivant la mise à niveau n'est que de sept jours. À partir du huitième jours, la période de récupération PITR passe à huit jours, puis le neuvième jour à neuf jours, jusqu'à ce que la période de conservation soit finalement passée à 14 jours le 14e jour.

De plus, le nombre de sauvegardes automatiques par défaut est passé de 8 à 15.

Si vous passez à l'édition Cloud SQL Enterprise Plus après avoir effectué une mise à niveau de version majeure, vous ne pourrez pas effectuer de récupération à un moment précis antérieur à la mise à niveau de la version majeure. Cette limitation s'applique même si votre période de conservation couvre cette période. Vous pouvez restaurer votre instance à un moment précis après le lancement de la mise à niveau de la version majeure.

Passer à l'édition Cloud SQL Enterprise

Console

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Cliquez sur Modifier.
  4. Dans la section Choisir une édition Cloud SQL, cliquez sur Passer à l'édition Enterprise.
  5. Dans le panneau Passer à l'édition Enterprise, saisissez l'ID de votre instance, puis cliquez sur Changer d'édition.

Vous pouvez également passer à l'édition Cloud SQL Enterprise en cliquant sur Passer à l'édition Enterprise dans la section Configuration de la page Présentation de l'instance.

gcloud

L'exemple de code suivant montre comment passer votre instance à l'édition Cloud SQL Enterprise :

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID
 Remplacez les éléments suivants :
  • PROJECT_ID : ID de projet de l'instance.
  • INSTANCE_ID : nom de l'instance.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez basculer. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise, consultez la page Types de machines pour les instances Cloud SQL Enterprise.

REST

La commande suivante bascule votre instance vers l'édition Cloud SQL Enterprise et déclenche une opération de redémarrage.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de projet de l'instance.
  • INSTANCE_ID : ID de l'instance.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez basculer. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise, consultez la page Types de machines pour les instances Cloud SQL Enterprise.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corps JSON de la requête :

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

La commande suivante bascule votre instance vers l'édition Cloud SQL Enterprise et déclenche une opération de redémarrage.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de projet de l'instance.
  • INSTANCE_ID : ID de l'instance.
  • MACHINE_TYPE : type de machine de l'instance vers laquelle vous souhaitez basculer. Pour en savoir plus sur les types de machines pour l'édition Cloud SQL Enterprise, consultez la page Types de machines pour les instances Cloud SQL Enterprise.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corps JSON de la requête :

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Paramètres par défaut de l'édition Cloud SQL Enterprise pour la sauvegarde et le stockage des journaux

Le passage à l'édition Cloud SQL Enterprise ne modifie pas l'emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis. Si votre instance Cloud SQL Enterprise Plus stocke ses journaux de transactions pour la récupération à un moment précis dans Cloud Storage, les journaux restent dans Cloud Storage. Toutefois, au lieu de stocker par défaut 14 jours de journaux de transactions pour la récupération PITR, la valeur par défaut est remplacée par 7 jours. La configuration de sauvegarde n'est pas modifiée.

Étapes suivantes