Créer et gérer des pools de lecture

Cette page explique comment créer et gérer des pools de lecture pour vos charges de travail de lecture volumineuses.

Avant de commencer

  1. Les pools de lecture contiennent des copies d'une instance principale. Si vous ne l'avez pas encore fait, créez une instance principale Cloud SQL Enterprise Plus. Bien que les pools de lecture soient compatibles avec la connectivité IP publique, créez une instance principale avec connectivité IP privée (PSA) pour les besoins de ce guide. Pour en savoir plus sur les instances principales et la réplication, consultez À propos de la réplication dans Cloud SQL.
  2. Une fois l'instance principale créée, choisissez un mot de passe pour l'utilisateur racine et exécutez la commande suivante pour définir le mot de passe sur l'instance principale. Enregistrez ce mot de passe pour l'utiliser ultérieurement lors de la connexion au pool de lecture.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Effectuez les remplacements suivants :

    • PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture résident.
    • PRIMARY_INSTANCE_NAME : nom de l'instance principale.

Créer un pool de lecture

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances create suivante pour créer un pool de lecture avec plusieurs nœuds de pool de lecture :

      gcloud sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture.
  • TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.
  • PRIMARY_INSTANCE_NAME : nom de l'instance principale associée au pool de lecture, tel que my-primary-instance.

Terraform

Pour créer un pool de lecture, utilisez une ressource Terraform. Définissez ensuite l'attribut instance_type sur "READ_POOL_INSTANCE" et l'attribut node_count sur le nombre de nœuds que vous souhaitez utiliser.

L'exemple suivant inclut des ressources pour l'instance principale et le pool de lecture. 


resource "google_sql_database_instance" "primary" {
  name             = "postgres-primary"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "postgres-replica"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

Appliquer les modifications

Pour appliquer votre configuration Terraform dans un projet Trusted Cloud , suivez les procédures des sections suivantes.

Préparer Cloud Shell

  1. Lancez Cloud Shell.

  2. Définissez le projet Trusted Cloud par défaut dans lequel vous souhaitez appliquer vos configurations Terraform.

    Vous n'avez besoin d'exécuter cette commande qu'une seule fois par projet et vous pouvez l'exécuter dans n'importe quel répertoire.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Les variables d'environnement sont remplacées si vous définissez des valeurs explicites dans le fichier de configuration Terraform.

Préparer le répertoire

Chaque fichier de configuration Terraform doit avoir son propre répertoire (également appelé module racine).

  1. Dans Cloud Shell, créez un répertoire et un nouveau fichier dans ce répertoire. Le nom du fichier doit comporter l'extension .tf, par exemple main.tf. Dans ce tutoriel, le fichier est appelé main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Si vous suivez un tutoriel, vous pouvez copier l'exemple de code dans chaque section ou étape.

    Copiez l'exemple de code dans le fichier main.tf que vous venez de créer.

    Vous pouvez également copier le code depuis GitHub. Cela est recommandé lorsque l'extrait Terraform fait partie d'une solution de bout en bout.

  3. Examinez et modifiez les exemples de paramètres à appliquer à votre environnement.
  4. Enregistrez les modifications.
  5. Initialisez Terraform. Cette opération n'est à effectuer qu'une seule fois par répertoire. 
    terraform init

    Vous pouvez également utiliser la dernière version du fournisseur Google en incluant l'option -upgrade : 

    terraform init -upgrade

Appliquer les modifications

  1. Examinez la configuration et vérifiez que les ressources que Terraform va créer ou mettre à jour correspondent à vos attentes : 
    terraform plan

    Corrigez les modifications de la configuration si nécessaire.

  2. Appliquez la configuration Terraform en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité : 
    terraform apply

    Attendez que Terraform affiche le message "Apply completed!" (Application terminée).

  3. Ouvrez votre projet Trusted Cloud pour afficher les résultats. Dans la console Trusted Cloud , accédez à vos ressources dans l'interface utilisateur pour vous assurer que Terraform les a créées ou mises à jour.

Supprimer les modifications

Pour supprimer vos modifications, procédez comme suit :

  1. Pour désactiver la protection contre la suppression, définissez l'argument deletion_protection sur false dans le fichier de configuration Terraform. 
    deletion_protection =  "false"
  2. Appliquez la configuration Terraform mise à jour en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité : 
    terraform apply

  1. Supprimez les ressources précédemment appliquées à votre configuration Terraform en exécutant la commande suivante et en saisissant yes à la requête :

    terraform destroy

REST v1

Utilisez la méthode insert de la ressource des instances pour créer un pool de lecture avec plusieurs nœuds de pool de lecture. La propriété databaseVersion doit être identique à celle de l'instance principale.

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

  • PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture résident.
  • REGION : région du pool de lecture, par exemple us-east1. La région doit être identique à celle de l'instance principale.
  • TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME : nom de l'instance principale.
  • READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture, par exemple my-read-pool.
  • DATABASE_VERSION : version de la base de données que vous souhaitez utiliser. Exemple :POSTGRES_16
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.
  • FULL_NETWORK_NAME : chemin d'accès complet au réseau où vous souhaitez que réside le pool de lecture, par exemple projects/vpc-host-project/global/networks/my-network-name.

Méthode HTTP et URL : 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

Corps JSON de la requête :

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

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

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

REST v1beta4

Utilisez la méthode insert de la ressource des instances pour créer un pool de lecture avec plusieurs nœuds de pool de lecture. La propriété databaseVersion doit être identique à celle de l'instance principale.

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

  • PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture résident.
  • REGION : région du pool de lecture, par exemple us-east1. La région doit être identique à celle de l'instance principale.
  • TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME : nom de l'instance principale.
  • READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture, par exemple my-read-pool.
  • DATABASE_VERSION : version de la base de données que vous souhaitez utiliser. Exemple :POSTGRES_16
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.
  • FULL_NETWORK_NAME : chemin d'accès complet au réseau où vous souhaitez que réside le pool de lecture, par exemple projects/vpc-host-project/global/networks/my-network-name.

Méthode HTTP et URL : 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

Corps JSON de la requête :

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

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

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

Convertir une instance répliquée avec accès en lecture en pool avec accès en lecture

Vous pouvez convertir une réplique en lecture Cloud SQL Enterprise Plus existante en pool de lecture en spécifiant le nombre de nœuds dans le pool. Au cours de ce processus de conversion, l'adresse IP de l'instance répliquée deviendra l'adresse IP du pool de lecture (le point de terminaison de lecture). Les clients existants pourront ainsi se connecter au pool sans avoir à le reconfigurer.

Les nœuds du pool de lecture nouvellement créés auront le même type de machine et la même configuration que l'instance répliquée avec accès en lecture d'origine. La modification de ce type ou de cette configuration de machine nécessite une opération distincte. Cette opération n'est possible que pour les instances dupliquées en lecture seule zonales. Pour convertir une instance répliquée avec accès en lecture à haute disponibilité en pool avec accès en lecture, vous devez d'abord la convertir en instance répliquée avec accès en lecture zonale.

Pour en savoir plus, consultez Modifier la configuration du pool de lecture.

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances patch suivante pour convertir une instance répliquée avec accès en lecture afin de l'utiliser avec un pool avec accès en lecture :

      gcloud sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

Effectuez les remplacements suivants :

  • READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Terraform

Pour convertir une instance répliquée avec accès en lecture en un pool avec accès en lecture, utilisez une ressource Terraform. Le fichier manifeste ressemble à celui que vous avez utilisé dans Créer une réplique en lecture seule. Ensuite, procédez comme suit :

  • Modifiez l'attribut instance_type de "READ_REPLICA_INSTANCE" à "READ_POOL_INSTANCE" et l'attribut node_count au nombre de nœuds que vous souhaitez utiliser.
  • Si vous l'avez déjà défini, effacez l'attribut settings.availability_type.

REST v1

Utilisez la méthode patch de la ressource des instances pour convertir une instance répliquée avec accès en lecture en un pool avec accès en lecture.

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

  • READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir, par exemple my-read-replica.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

Corps JSON de la requête :

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

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

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

REST v1beta4

Utilisez la méthode patch de la ressource des instances pour convertir une instance répliquée avec accès en lecture en un pool avec accès en lecture.

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

  • READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir, par exemple my-read-replica.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

Corps JSON de la requête :

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

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

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

Convertir un pool avec accès en lecture en instance répliquée avec accès en lecture

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances patch suivante pour convertir une instance répliquée avec accès en lecture afin de l'utiliser avec un pool avec accès en lecture :

      gcloud sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE --availability-type=ZONAL

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom du pool de lecture que vous souhaitez convertir.

Terraform

Pour convertir un pool avec accès en lecture en instance répliquée avec accès en lecture, utilisez une ressource Terraform. Le fichier manifeste ressemble à celui que vous avez utilisé dans Créer un pool de lecture. Ensuite, remplacez la valeur de l'attribut instance_type de "READ_POOL_INSTANCE" par "READ_REPLICA_INSTANCE", effacez l'attribut node_count et définissez l'attribut settings.availability_type sur ZONAL.

REST v1

Utilisez la méthode patch de la ressource des instances pour convertir un pool avec accès en lecture en instance répliquée avec accès en lecture.

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

  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

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

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

REST v1beta4

Utilisez la méthode patch de la ressource des instances pour convertir un pool avec accès en lecture en instance répliquée avec accès en lecture.

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

  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

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

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

Afficher les informations sur le pool de lecture

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances describe suivante pour décrire le pool de lecture :

      gcloud sql instances describe READ_POOL_NAME

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom du pool de lecture que vous souhaitez décrire.

Un exemple de réponse avec des informations sur l'adresse IP et le nœud peut ressembler à ce qui suit :

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST v1

Utilisez la méthode get pour afficher les détails du pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

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

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

REST v1beta4

Utilisez la méthode get pour afficher les détails du pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

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

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

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

Ajouter ou supprimer des nœuds de pool de lecture

Les étapes suivantes permettent de faire évoluer un pool de lecture en modifiant le nombre de nœuds de pool de lecture dans le pool de lecture. Certaines limites de fonctionnement s'appliquent. Pour en savoir plus, consultez Limites des pools de lecture.

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Exécutez la commande gcloud sql instances patch suivante pour mettre à l'échelle le pool de lecture :

      gcloud sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom du pool de lecture.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Terraform

Pour modifier le nombre de nœuds du pool de lecture, mettez à jour une ressource Terraform existante. Le fichier manifeste ressemble à celui que vous avez utilisé dans Créer un pool de lecture. Modifiez ensuite l'attribut node_count en indiquant le nombre de nœuds que vous souhaitez utiliser.

REST v1

Utilisez la méthode patch pour effectuer un scaling du pool avec accès en lecture en modifiant le nombre de nœuds du pool avec accès en lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "nodeCount": NODE_COUNT
}

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

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

REST v1beta4

Utilisez la méthode patch pour effectuer un scaling du pool avec accès en lecture en modifiant le nombre de nœuds du pool avec accès en lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • NODE_COUNT : nombre de nœuds du pool de lecture que vous souhaitez inclure dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "nodeCount": NODE_COUNT
}

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

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

Modifier la configuration du pool de lecture

Les étapes suivantes vous expliquent comment modifier la configuration du pool de lecture. Pour en savoir plus, consultez À propos des paramètres d'instance et Modifier des instances.

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances patch suivante pour mettre à l'échelle verticale le pool de lecture, par exemple en modifiant le type de machine :

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom du pool de lecture.
  • TIER : type de machine que vous souhaitez appliquer à chaque nœud du pool de lecture, tel que db-perf-optimized-N-8.

Terraform

Pour modifier la configuration du pool de lecture, mettez à jour une ressource Terraform existante. Le fichier manifeste ressemble à celui que vous avez utilisé dans Créer un pool de lecture. Mettez ensuite à jour les attributs que vous souhaitez modifier dans le champ settings. Par exemple, remplacez l'attribut settings.tier par un autre type de machine.

REST v1

Utilisez la méthode patch pour modifier la configuration des nœuds du pool avec accès en lecture. Les paramètres sont appliqués de manière uniforme à tous les nœuds du pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "settings": {
    "tier": "TIER"
  }
}

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

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

REST v1beta4

Utilisez la méthode patch pour modifier la configuration des nœuds du pool avec accès en lecture. Les paramètres sont appliqués de manière uniforme à tous les nœuds du pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corps JSON de la requête :

{
  "settings": {
    "tier": "TIER"
  }
}

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

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

Se connecter à un pool de lecture

Il existe de nombreuses façons de se connecter à un pool de lecture. Les étapes suivantes montrent une façon de procéder, à savoir se connecter à un pool de lecture avec une adresse IP privée en créant une VM dans le même réseau VPC pour servir de source de connexion.

Pour en savoir plus sur les autres façons de configurer la connectivité à une instance Cloud SQL, consultez À propos des connexions Cloud SQL. Les méthodes de connexion vous obligent généralement à obtenir d'abord l'adresse IP ou le nom de connexion de l'instance, comme décrit dans Afficher les informations du pool de lecture. Les pools de lecture sont compatibles avec la plupart des méthodes de connexion disponibles pour les autres instances Cloud SQL, avec quelques limitations.

Si vous vous connectez à l'aide du proxy d'authentification Cloud SQL ou des connecteurs Cloud SQL, assurez-vous de passer à la dernière version. Pour la prise en charge des pools de lecture, les versions minimales requises sont les suivantes :

  • Proxy d'authentification Cloud SQL : v2.15.2
  • Connecteur Python Cloud SQL : v1.18.0
  • Connecteur Go Cloud SQL : v1.16.0
  • Connecteur Node Cloud SQL : v1.7.0
  • Connecteur Java Cloud SQL : v1.24.0

Console

Pour vous connecter à un pool de lecture, procédez comme suit :

  1. Dans la console Trusted Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

    Vous êtes redirigé vers la page de présentation de l'instance. Cliquez sur le nouveau pool de lecture pour afficher les détails le concernant, y compris son adresse IP privée. Dans la section Se connecter à cette instance, copiez et enregistrez le nom de connexion de l'instance. Le connection name est au format projectID:region:instanceID. Vous utiliserez le connection name lors du démarrage du proxy d'authentification Cloud SQL.
  2. Créez une VM Compute Engine.
  3. Ouvrir deux connexions SSH à la VM Compute Engine. Elles seront utilisées dans les étapes suivantes pour exécuter le proxy d'authentification Cloud SQL et le client de base de données.
  4. Installez le client.
  5. Installez le proxy d'authentification Cloud SQL.
  6. Démarrez le proxy d'authentification Cloud SQL.
  7. Connectez-vous à votre instance Cloud SQL.

Pour en savoir plus, consultez Se connecter à une instance Cloud SQL avec une adresse IP privée.

Supprimer un pool de lecture

gcloud

Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI. Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell.

Utilisez la commande gcloud sql instances delete suivante pour supprimer un pool de lecture :

      gcloud sql instances delete READ_POOL_NAME

Effectuez les remplacements suivants :

  • READ_POOL_NAME : nom du pool de lecture que vous souhaitez supprimer.

REST v1

Utilisez la méthode delete pour supprimer un pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

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

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

REST v1beta4

Utilisez la méthode delete pour supprimer un pool de lecture.

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

  • PROJECT : nom du projet dans lequel réside le pool de lecture.
  • READ_POOL_NAME : nom du pool de lecture, tel que my-read-pool.

Méthode HTTP et URL : 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

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

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

Étapes suivantes