Mise à niveau sur place

Cette page explique comment effectuer des mises à niveau et des rétrogradations sur place de vos instances Cloud SQL.

Apporter des modifications sur place à une instance Cloud SQL

Vous pouvez utiliser des modifications sur place pour mettre à niveau ou rétrograder l'édition de votre instance Cloud SQL, son type de machine, son type de stockage ou 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.

Tenir compte des modifications potentielles du stockage liées au type de machine

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 types de machines plus anciens.

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 certaine 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 la section Modifications du stockage.

Tenir compte des modifications apportées au stockage des journaux de transactions PITR

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 WAL PITR de votre instance, consultez la sectionVé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 la section Modifications de l'emplacement de stockage des journaux WAL pour la récupération PITR.

Modifier l'édition d'une instance sur place

Cette section explique comment modifier l'édition de votre instance Cloud SQL sur place vers ou depuis l'édition Cloud SQL Enterprise Plus. L'édition Cloud SQL Enterprise Plus offre certains avantages et améliorations de performances que l'édition Cloud SQL Enterprise n'offre pas. Pour en savoir plus sur les éditions Cloud SQL, consultez la page Présentation des éditions Cloud SQL.

La mise à niveau vers l'édition Cloud SQL Enterprise Plus prend quelques minutes et entraîne un temps d'arrêt quasi nul. Le retour à l'édition Cloud SQL Enterprise entraînera une indisponibilité plus longue. Aucun des deux 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 rétrograder une instance Cloud SQL Enterprise Plus vers l'édition Cloud SQL Enterprise.

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

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

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

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

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

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

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "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 de la machine

Lorsque vous modifiez des éditions, vous devez également modifier le type de machine. Pour en savoir plus sur les séries de machines compatibles avec Cloud SQL, consultez la section 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 à cœur dédié à usage général, 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 zone Personnaliser votre instance. Dans le menu déroulant, vous pouvez sélectionner un autre type de machine. Vous pouvez également choisir un nombre différent de processeurs virtuels et activer ou désactiver le cache de données, le cas échéant.

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 du 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é d' un disque SSD vers un stockage Google Cloud Hyperdisk Balanced. Cette mise à niveau nécessite généralement un temps d'arrêt minimal.

Le stockage Google Cloud Hyperdisk Balanced peut être personnalisé 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 les valeurs par défaut des IOPS et du débit, ainsi que les limites 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 la section Choisir une option de stockage.

Modifications de l'emplacement des journaux WAL pour la récupération PITR

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 à la modification de l'emplacement :

• Le processus prend environ la durée du transactionLogRetentionDays paramètre de configuration PITR pour passer à Cloud Storage.
• Lors du passage à Cloud Storage, nous vous recommandons de ne pas modifier le paramètre de configuration PITR 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.