Mettre à niveau une instance vers l'édition Cloud SQL Enterprise Plus à l'aide de 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 revenir 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 MySQL.

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 avec un temps d'arrêt attendu inférieur à 60 secondes. De plus, ce processus ne nécessite pas que vos applications modifient les points de terminaison auxquels elles se connectent.

Avant de commencer

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

  Si votre instance utilise une version antérieure de MySQL, vous devez la mettre à niveau vers MySQL 8.0.31 ou une version ultérieure. Pour en savoir plus, consultez les pages Mettre à niveau la version majeure de la base de données sur place et Mettre à niveau la version mineure de la base de données.

• Assurez-vous que votre instance utilise un disque dur SSD.

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 binaires 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 binaires 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 binaires 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 mettre à niveau une instance Cloud SQL Enterprise vers l'édition Cloud SQL Enterprise Plus.

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": "[email protected]",
  "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": "[email protected]",
  "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 le disque, le lancement du processus de mise à niveau vers Cloud SQL Enterprise Plus bascule l'emplacement de stockage de ces journaux vers Cloud Storage.

Les conditions suivantes s'appliquent au processus de changement d'emplacement:

• Le processus prend approximativement la durée du paramètre de configuration PITR transactionLogRetentionDays pour effectuer le basculement vers Cloud Storage.
• Si des valeurs sont définies pour l'option expire_logs_days ou binlog_expire_logs_seconds sur votre instance, ces valeurs sont conservées.
• Pendant le passage à Cloud Storage, vous ne pouvez pas modifier les valeurs des options expire_logs_days ou binlog_expire_logs_seconds sur votre instance.
• Lors du passage à Cloud Storage, nous vous recommandons de ne pas modifier le paramètre de configuration de la récupération PITR transactionLogRetentionDays. Même si vous augmentez la valeur transactionLogRetentionDays, les journaux binaires ne sont pas conservés sur le disque plus longtemps que la valeur par défaut de sept jours pour une instance Cloud SQL Enterprise.
• Tant que le changement est en cours, Cloud SQL ne conserve les journaux sur le disque que pour la valeur minimale de l'un des éléments suivants:
  • Paramètre de configuration de la récupération PITR transactionLogRetentionDays avant le changement (sept jours par défaut)
  • Les options expire_logs_days ou binlog_expire_logs_seconds définies manuellement sur votre instance
• Après le changement, Cloud SQL conserve sur le disque la même quantité de journaux binaires qu'avant le changement sauf si vous avez défini les options expire_logs_days ou binlog_expire_logs_seconds sur votre instance. Si vous avez défini ces options, Cloud SQL conserve les journaux binaires sur le disque en fonction de la valeur minimale du paramètre de configuration transactionLogRetentionDays ou de la valeur des options.

Sauvegardes et stockage de journaux par défaut de l'édition Cloud SQL Enterprise Plus

Une fois le basculement vers Cloud Storage terminé pour une instance, Cloud SQL conserve toujours des copies des journaux binaires sur le disque à des fins de réplication. Le stockage des journaux binaires sur le disque peut être utile si vous souhaitez les parcourir avec l'utilitaire mysqlbinlog.

Si vous avez configuré les options expire_logs_days et binlog_expire_logs_seconds sur votre instance avant la mise à niveau, les valeurs configurées restent intactes.

Après le basculement, étant donné que les journaux binaires utilisés pour effectuer la récupération à un moment précis sont désormais stockés dans Cloud Storage, assurez-vous que les valeurs des options reflètent la conservation des journaux de transactions sur le disque attendu. Cloud SQL ne conserve les journaux sur le disque que pour la valeur minimale de l'un des éléments suivants :

• Le paramètre de configuration de la récupération PITR transactionLogRetentionDays avant le basculement (sept jours par défaut)
• Les options expire_logs_days ou binlog_expire_logs_seconds définies manuellement sur votre instance

Si vous souhaitez économiser de l'espace disque, une fois la mise à niveau terminée, définissez la valeur de l'option expire_logs_days ou binlog_expire_logs_seconds sur l'équivalent d'un jour afin de réduire la taille de disque allouée et les coûts de stockage sur disque. Pour en savoir plus sur le stockage des journaux de transactions et la récupération PITR, consultez la section Stockage de journaux pour la récupération à un moment précis.

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 par défaut de sauvegardes automatiques 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

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

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

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

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": "[email protected]",
  "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"
  }
}

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": "[email protected]",
  "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"
}

Sauvegardes et stockage de journaux par défaut de l'édition Cloud SQL Enterprise

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 PITR 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 la sauvegarde n'est pas modifiée.

Étapes suivantes

• Apprenez-en plus sur l'édition Cloud SQL Enterprise Plus.