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 vous ne l'avez pas déjà fait, créez une instance principale de l'édition Cloud SQL Enterprise Plus.
Bien que les pools de lecture acceptent la connectivité IP publique, pour les besoins de ce guide, créez une instance principale avec une connectivité IP privée (PSA).
Pour en savoir plus sur les instances principales et la réplication, consultez la page À 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 lorsque vous vous connecterez au pool de lecture.
PROJECT: nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture se trouvent.
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 de pool de lecture que vous souhaitez 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, par exemple 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 se trouvent.
REGION: région du pool de lecture, par exemple us-east1.
La région doit être la même que 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 de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.
FULL_NETWORK_NAME: chemin d'accès réseau complet où vous souhaitez que le pool de lecture réside, 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 se trouvent.
REGION: région du pool de lecture, par exemple us-east1.
La région doit être la même que 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 de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1 et 20.
FULL_NETWORK_NAME: chemin d'accès réseau complet où vous souhaitez que le pool de lecture réside, 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 de lecture
Vous pouvez convertir un réplica avec accès en lecture de l'édition Cloud SQL Enterprise Plus existante en pool de lecture en spécifiant le nombre de nœuds du pool. Au cours de ce processus de conversion, l'adresse IP du réplica devient l'adresse IP du pool de lecture (le point de terminaison de lecture), afin que les clients existants puissent 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 de machine ou de cette configuration nécessite une opération distincte. Cette opération n'est possible que pour les instances dupliquées avec accès en lecture zonales. Pour convertir une instance répliquée avec accès en lecture haute disponibilité (HA) 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 à 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 à 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 une adresse IP et des informations sur le nœud peut ressembler à ce qui suit:
Les étapes suivantes permettent de réduire ou d'augmenter la taille d'un pool de lecture en modifiant le nombre de nœuds du pool de lecture. Certaines restrictions d'utilisation s'appliquent. Pour en savoir plus, consultez la section 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.
Utilisez la commande gcloud beta sql instances patch suivante pour faire évoluer 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, par exemple 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 uniformément à 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 se trouve 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, par exemple 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 uniformément à 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 se trouve 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, par exemple my-read-pool.
Il existe de nombreuses façons de se connecter à un pool de lecture. Les étapes suivantes montrent une méthode, à savoir la connexion à 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 la page À propos des connexions Cloud SQL.
Les méthodes de connexion nécessitent généralement d'obtenir d'abord l'adresse IP ou le nom de connexion de l'instance, comme décrit dans la section Afficher les informations sur le 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 certaines limites.
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 du pool de lecture, les versions minimales requises sont les suivantes:
Proxy d'authentification Cloud SQL: version 2.15.2
Connecteur Python Cloud SQL: version 1.18.0
Connecteur Go Cloud SQL: version 1.16.0
Connecteur Cloud SQL Node: version 1.7.0
Connecteur Java Cloud SQL: version 1.24.0
Console
Pour vous connecter à un pool de lecture, procédez comme suit:
Dans la Google Cloud console, 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, 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 ce connection name plus tard lorsque vous démarrerez le 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 se trouve le pool de lecture.
READ_POOL_NAME: nom du pool de lecture, par exemple 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/05/01 (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/05/01 (UTC)."],[],[]]