Cette page a été traduite par l'API Cloud Translation.

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 SQL Server.

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.

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 SQL Server Enterprise 2019 ou SQL Server Enterprise 2022.

Remarque : Si vous avez défini l'option max server memory (mb), nous vous suggérons de la supprimer après avoir mis à niveau votre instance vers l'édition Cloud SQL Enterprise Plus. De cette façon, Cloud SQL peut gérer automatiquement la valeur de l'option. Toutefois, si vous préférez définir la valeur, vous pouvez ré-évaluer la valeur de l'option après avoir mis à niveau votre instance et l'ajuster en fonction de la taille de la VM.
Assurez-vous que votre projet de réseau a été créé après août 2021 ou qu'il a été entièrement mis à niveau vers la nouvelle architecture réseau.

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

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

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Modifier.
Dans la section Choisir une édition Cloud SQL, cliquez sur Mettre à niveau.
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

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.

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 :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

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.

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 :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

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

Passer à l'édition Cloud SQL Enterprise

Console

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

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Modifier.
Dans la section Choisir une édition Cloud SQL, cliquez sur Passer à l'édition Enterprise.
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 :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

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 :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

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

Générer automatiquement le point de terminaison d'écriture

Un point de terminaison d'écriture est un nom de service de nom de domaine (DNS) mondial qui pointe automatiquement vers l'adresse IP de l'instance Cloud SQL principale actuelle. Ce point de terminaison redirige automatiquement les connexions entrantes vers la nouvelle instance principale en cas d'opération de basculement d'instance dupliquée. Vous pouvez utiliser le point de terminaison d'écriture dans une chaîne de connexion SQL au lieu d'une adresse IP. En utilisant un point de terminaison d'écriture, vous pouvez éviter d'avoir à modifier la connexion de l'application en cas de panne régionale.

Si vous mettez à niveau votre instance disposant d'une adresse IP privée sur la nouvelle architecture réseau vers l'édition Cloud SQL Enterprise Plus et que vous activez l'API DNS pour votre projet Google Cloud, Cloud SQL génère automatiquement le point de terminaison d'écriture. Toutefois, le certificat de serveur associé à l'instance ne comportera pas le point de terminaison d'écriture (nom DNS global). Par conséquent, si vous souhaitez valider le nom DNS, vous devez faire pivoter le certificat. Une fois la rotation de ce certificat terminée, Cloud SQL ajoute le nom DNS au certificat. Vous pouvez utiliser le nom DNS pour valider l'identité du serveur.

Étape suivante

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