Questa pagina descrive come creare e gestire i pool di lettura per i carichi di lavoro di lettura di grandi dimensioni.
Prima di iniziare
I pool di lettura contengono copie di un'istanza principale. Se non l'hai ancora fatto,
crea un'istanza principale Cloud SQL Enterprise Plus.
Sebbene i pool di lettura supportino la connettività con IP pubblico, ai fini di questa guida,
crea un'istanza principale con connettività IP privato (PSA).
Per ulteriori informazioni sulle istanze principali e sulla replica, consulta
Informazioni sulla replica in Cloud SQL.
Dopo aver creato l'istanza principale, scegli una password per l'utente root
ed esegui il seguente comando per impostarla sull'istanza principale.
Salva questa password per utilizzarla in un secondo momento quando ti connetti al pool di lettura.
PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza principale e il pool di lettura.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
Crea un pool di lettura
gcloud
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances create
per creare un pool di lettura con più nodi:
READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura.
TIER: il tipo di macchina che vuoi utilizzare per ogni riga del pool di lettura nel pool di lettura, ad esempio db-perf-optimized-N-4.
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale associata
al pool di lettura, ad esempio my-primary-instance.
REST v1
Utilizza il metodo
insert della risorsa instances per creare un
pool di lettura con più nodi del pool di lettura. La proprietà databaseVersion deve essere uguale a quella principale.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza principale e il pool di lettura.
REGION: la regione per il pool di lettura, ad esempio us-east1.
La regione deve essere la stessa dell'istanza principale.
TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura nel pool di lettura, ad esempio db-perf-optimized-N-4.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura, ad esempio my-read-pool.
DATABASE_VERSION: la versione del database che vuoi utilizzare.
Ad esempio, MYSQL_8_0_37.
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
FULL_NETWORK_NAME: il percorso di rete completo in cui vuoi che risieda il pool di lettura, ad esempio projects/vpc-host-project/global/networks/my-network-name.
Metodo HTTP e URL:
POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances
Utilizza il metodo
insert della risorsa instances per creare un
pool di lettura con più nodi del pool di lettura. La proprietà databaseVersion deve essere uguale a quella principale.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza principale e il pool di lettura.
REGION: la regione per il pool di lettura, ad esempio us-east1.
La regione deve essere la stessa dell'istanza principale.
TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura nel pool di lettura, ad esempio db-perf-optimized-N-4.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura, ad esempio my-read-pool.
DATABASE_VERSION: la versione del database che vuoi utilizzare.
Ad esempio, MYSQL_8_0_37.
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
FULL_NETWORK_NAME: il percorso di rete completo in cui vuoi che risieda il pool di lettura, ad esempio projects/vpc-host-project/global/networks/my-network-name.
Metodo HTTP e URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances
Convertire una replica di lettura in un pool di lettura
Puoi convertire una replica di lettura esistente della versione Cloud SQL Enterprise Plus in un pool di lettura specificando il numero di nodi nel pool. Durante questo processo di conversione, l'IP della replica diventerà l'IP del pool di lettura (l'endpoint di lettura), in modo che i client esistenti possano connettersi al pool senza riconfigurazione.
I nodi del pool di lettura appena creati avranno lo stesso tipo di macchina e la stessa configurazione della replica di lettura originale. La modifica di questo tipo di macchina o di questa configurazione richiede un'operazione separata. Questa
operazione è supportata solo per le repliche di lettura zonali. Per
convertire una replica di lettura ad alta disponibilità (HA) in un pool di lettura, devi prima convertirla in una replica di lettura zonale.
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances patch
per convertire una replica di lettura da utilizzare con un pool di lettura:
Convertire un pool di lettura in una replica di lettura
gcloud
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances patch
per convertire una replica di lettura da utilizzare con un pool di lettura:
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances describe
per descrivere il pool di lettura:
gcloudbetasqlinstancesdescribeREAD_POOL_NAME
Esegui le seguenti sostituzioni:
READ_POOL_NAME: il nome del pool di lettura che vuoi descrivere.
Un esempio di risposta con indirizzo IP e informazioni sul nodo potrebbe essere simile al seguente:
I passaggi che seguono consentono di aumentare o diminuire le dimensioni di un pool di lettura modificando il numero di nodi del pool di lettura al suo interno. Sono previste alcune limitazioni di funzionamento. Per ulteriori informazioni, consulta Limitazioni del pool di lettura.
gcloud
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances patch
per scalare il pool di lettura:
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
REST v1
Utilizza il metodo
patch per eseguire lo scaling di un pool di lettura verso l'alto o verso il basso modificando
il numero di nodi del pool di lettura nel pool di lettura.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui risiede il pool di lettura.
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
Utilizza il metodo
patch per eseguire lo scaling di un pool di lettura verso l'alto o verso il basso modificando
il numero di nodi del pool di lettura nel pool di lettura.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui risiede il pool di lettura.
NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel
pool di lettura. Scegli un numero compreso tra 1 e 20.
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud beta sql instances patch per eseguire lo scaling verticale del pool di lettura, ad esempio modificando il tipo di macchina:
TIER: il tipo di macchina da applicare a ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-8.
REST v1
Utilizza il metodo
patch per modificare la configurazione del nodo del pool di lettura.
Le impostazioni vengono applicate in modo uniforme a tutti i nodi del pool di lettura.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui risiede il pool di lettura.
TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura nel pool di lettura, ad esempio db-perf-optimized-N-4.
READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.
Utilizza il metodo
patch per modificare la configurazione del nodo del pool di lettura.
Le impostazioni vengono applicate in modo uniforme a tutti i nodi del pool di lettura.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui risiede il pool di lettura.
TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura nel pool di lettura, ad esempio db-perf-optimized-N-4.
READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.
Esistono molti modi per connettersi a un pool di lettura. I passaggi che seguono mostrano un modo, ovvero la connessione a un pool di lettura con un indirizzo IP privato creando una VM nella stessa rete VPC da utilizzare come origine della connessione.
Per ulteriori informazioni su altri modi per configurare la connettività a un'istanza Cloud SQL, consulta Informazioni sulle connessioni Cloud SQL.
I metodi di connessione in genere richiedono di ottenere prima l'indirizzo IP o il nome di connessione dell'istanza, come descritto in Visualizzare le informazioni sul pool di lettura.
I pool di lettura supportano la maggior parte dei metodi di connessione disponibili per altre istanze Cloud SQL, con alcune limitazioni.
Se esegui la connessione utilizzando il proxy di autenticazione Cloud SQL o i connettori Cloud SQL, assicurati di eseguire l'aggiornamento alla versione più recente. Per il supporto del pool di lettura, le versioni minime richieste includono quanto segue:
Proxy di autenticazione Cloud SQL: versione 2.15.2
Connettore Python Cloud SQL: v1.18.0
Connettore Go Cloud SQL: v1.16.0
Connettore Node Cloud SQL: v1.7.0
Connettore Java Cloud SQL: versione 1.24.0
Console
Per connetterti a un pool di lettura:
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
Si aprirà la pagina Panoramica dell'istanza.
Fai clic sul nuovo pool di lettura per visualizzarne i dettagli, incluso l'indirizzo IP privato. Nella sezione Connetti a questa istanza, copia e salva il nome della connessione dell'istanza. Il connection name sia nel
formato projectID:region:instanceID. Ti servirà
connection name in un secondo momento per avviare il proxy di autenticazione Cloud SQL.
Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta
Utilizzare Cloud Shell.
Utilizza il seguente comando gcloud sql instances delete per eliminare un pool di lettura:
gcloudsqlinstancesdeleteREAD_POOL_NAME
Esegui le seguenti sostituzioni:
READ_POOL_NAME: il nome del pool di lettura da eliminare.
REST v1
Utilizza il metodo
delete per eliminare un pool di lettura.
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
PROJECT: il nome del progetto in cui risiede il pool di lettura.
READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-04-22 UTC."],[],[]]