Cette page explique comment créer et gérer des pools de lecture pour vos charges de travail de lecture volumineuses.
Avant de commencer
Les pools de lecture contiennent des copies d'une instance principale. Si ce n'est pas déjà 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.
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.
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 beta sql instances create suivante pour créer un pool de lecture avec plusieurs nœuds de pool de lecture :
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.
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 ci-dessous, 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 :MYSQL_8_0_37
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
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 ci-dessous, 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 :MYSQL_8_0_37
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
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 répliqué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 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 beta 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 :
Convertir un pool de 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 beta 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 :
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 beta sql instances describe suivante pour décrire le pool de lecture :
gcloudbetasqlinstancesdescribeREAD_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 :
Les étapes suivantes permettent de faire évoluer un pool de lecture en modifiant le nombre de nœuds 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 beta sql instances patch suivante pour mettre à l'échelle le pool de lecture :
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 beta sql instances patch suivante pour faire évoluer verticalement le pool de lecture, par exemple en modifiant le type de machine :
TIER : type de machine que vous souhaitez appliquer à chaque nœud du pool de lecture, tel que db-perf-optimized-N-8.
REST v1
Utilisez la méthode patch pour modifier la configuration des nœuds du pool de 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 ci-dessous, 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.
Utilisez la méthode patch pour modifier la configuration des nœuds du pool de 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 ci-dessous, 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.
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.js Cloud SQL : v1.7.0
Connecteur Java Cloud SQL : v1.24.0
Console
Pour vous connecter à un pool de lecture, procédez comme suit :
Dans la console Google Cloud , accédez à 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.
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 :
gcloudsqlinstancesdeleteREAD_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 ci-dessous, 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/09 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/09 (UTC)."],[],[]]