Mise à niveau sur place

Cette page explique comment mettre à niveau ou rétrograder vos instances Cloud SQL sur place.

Apporter des modifications sur place à une instance Cloud SQL

Vous pouvez utiliser les modifications sur place pour mettre à niveau ou rétrograder l'édition, le type de machine ou le type de stockage de votre instance Cloud SQL, ou pour mettre à niveau sa version de base de données. Apporter des modifications sur place est le moyen le plus simple et le moins sujet aux erreurs de reconfigurer une instance.

Avant de commencer

Assurez-vous que votre instance exécute PostgreSQL 12 ou une 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.

Les différentes éditions sont compatibles avec différents types de machines qui utilisent différentes options de stockage. Les types de machines C4 et C4A hautes performances utilisent le stockage Hyperdisk Balanced plutôt que l'une des options de disque persistant utilisées par les anciens types de machines.

Lorsque vous modifiez l'édition ou le type de machine que vous utilisez, votre type de stockage peut également changer, ce qui peut entraîner une indisponibilité et une modification des coûts de stockage. Lorsque vous passez à Google Cloud Hyperdisk Balanced, vous pouvez spécifier des options de configuration supplémentaires. Pour en savoir plus, consultez Modifications apportées au stockage.

Être informé des modifications apportées au stockage des journaux de transactions pour la récupération à un moment précis

Si vous mettez à niveau une instance Cloud SQL Enterprise qui stocke les journaux WAL utilisés pour la récupération PITR sur disque, sachez que le processus de mise à niveau vers l'édition Cloud SQL Enterprise Plus déplace l'emplacement de stockage de ces journaux du disque vers Cloud Storage. Pour déterminer l'emplacement actuel des journaux write-ahead de récupération à un moment précis pour votre instance, consultez Vérifier l'emplacement de stockage des journaux de transactions utilisés pour la récupération à un moment précis.

Pour obtenir une explication complète de l'impact des mises à niveau sur place sur l'emplacement des journaux WAL, consultez Modifications de l'emplacement de stockage des journaux WAL pour la récupération à un moment précis.

Modifier l'édition d'une instance sur place

Cette section explique comment modifier l'édition de votre instance Cloud SQL sur place pour passer à l'édition Cloud SQL Enterprise Plus ou en revenir. L'édition Cloud SQL Enterprise Plus offre certains avantages et améliorations de performances qui ne sont pas disponibles dans l'édition Cloud SQL Enterprise. Pour en savoir plus sur les éditions Cloud SQL, consultez la présentation des éditions Cloud SQL.

La mise à niveau vers l'édition Cloud SQL Enterprise Plus prend quelques minutes et n'entraîne que très peu de temps d'arrêt. Si vous repassez à l'édition Cloud SQL Enterprise, l'indisponibilité sera plus longue. Aucun de ces processus ne nécessite de modifier les points de terminaison auxquels vos applications se connectent.

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

Console

  1. Dans la console Google Cloud , 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 si votre instance utilise l'édition Cloud SQL Enterprise, ou sur Passer à Enterprise si votre instance utilise l'édition Cloud SQL Enterprise Plus.
  5. Utilisez le panneau qui s'ouvre pour spécifier la configuration de votre instance à l'aide de la nouvelle édition. Consultez [Options lorsque vous effectuez des modifications sur place](#change-options).
  6. Saisissez l'ID de votre instance pour confirmer ces choix, puis cliquez sur Mettre à niveau l'édition ou Changer d'édition, selon que vous souhaitez passer à une édition supérieure ou inférieure.

Vous pouvez également lancer une modification de l'édition sur la page Instances en sélectionnant Modifier dans la colonne Actions de l'instance.

De plus, si votre instance utilise l'édition Cloud SQL Enterprise, vous pouvez lancer une mise à niveau en cliquant sur le lien Mettre à niveau à côté du champ de l'édition dans la section Configuration de la page de l'instance.

gcloud

L'exemple de code [`gcloud sql instance patch`](/sdk/gcloud/reference/sql/instances/patch) 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 le flag --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 Types de machines pour les instances Cloud SQL Enterprise Plus.

REST

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

Avant d'utiliser les données de requête, 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 Plus et déclenche une opération de redémarrage.

Avant d'utiliser les données de requête, 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"
}

Options pour les modifications sur place

La modification de l'édition de votre instance Cloud SQL peut nécessiter la modification de sa série de machines, ce qui affecte à son tour son type de stockage.

Modifications des machines

Lorsque vous changez d'édition, vous devez également modifier le type de machine. Pour en savoir plus sur les séries de machines compatibles avec Cloud SQL, consultez Choisir une série de machines.

Lorsque vous passez de l'édition Cloud SQL Enterprise à l'édition Cloud SQL Enterprise Plus, vous pouvez choisir entre les séries de machines N2, C4A et C4.

Lorsque vous passez de l'édition Cloud SQL Enterprise Plus à l'édition Cloud SQL Enterprise, vous pouvez choisir entre une série de machines à usage général avec cœur dédié et une série de machines N4.

Vous pouvez également modifier le type de machine sans changer d'édition. Après avoir choisi de modifier votre instance, accédez à la sous-section Machine de Configuration de la machine dans la section Personnaliser votre instance. Vous pouvez sélectionner un autre type de machine dans le menu déroulant. Vous pouvez également choisir un autre nombre de vCPU et activer ou désactiver le cache de données si nécessaire.

Pour obtenir des informations plus générales, consultez également la documentation Compute Engine pour les séries de machines N2, C4A, C4 et N4.

Modifications apportées au stockage

Si vous passez d'une série de machines à usage général ou N2 à une série de machines N4, C4A ou C4, votre stockage sera migré de Solid-state drive (SSD) vers le stockage Google Cloud Hyperdisk Balanced. Cette mise à niveau nécessite généralement un temps d'arrêt minimal.

Vous pouvez personnaliser le stockage Google Cloud Hyperdisk Balanced pour votre cas d'utilisation en définissant les éléments suivants :

  • Capacité de stockage
  • IOPS provisionnées
  • Débit provisionné

Google Cloud Hyperdisk Balanced définit des valeurs et des limites par défaut pour les IOPS et le débit en fonction de la configuration de votre instance, qui inclut le type de machine et la capacité de stockage. La capacité de stockage limite la valeur par défaut, et le type de machine définit la valeur maximale pour les IOPS et le débit. Pour en savoir plus, consultez Choisir une option de stockage.

Modifications de l'emplacement des journaux de transaction 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 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

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.