Creare e gestire i pool di lettura

Questa pagina descrive come creare e gestire i pool di lettura per i carichi di lavoro di lettura di grandi dimensioni.

Prima di iniziare

  1. I pool di lettura contengono copie di un'istanza principale. Se non l'hai ancora fatto, crea un'istanza principale di 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à con IP privato (PSA). Per ulteriori informazioni sulle istanze principali e sulla replica, consulta Informazioni sulla replica in Cloud SQL.
  2. Dopo aver creato l'istanza primaria, scegli una password per l'utente root ed esegui il seguente comando per impostare la password sull'istanza primaria. Salva questa password per utilizzarla in un secondo momento quando ti connetti al pool di lettura.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Effettua le seguenti sostituzioni:

    • PROJECT: il nome del progetto in cui vuoi che si trovino l'istanza primaria e il pool di lettura.
    • PRIMARY_INSTANCE_NAME: il nome dell'istanza primaria.

Crea un pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances create per creare un pool di lettura con più nodi del pool di lettura:

      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

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del 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 qualsiasi da 1 a 20.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza primaria associata al pool di lettura, ad esempio my-primary-instance.

Terraform

Per creare un pool di lettura, utilizza una risorsa Terraform. Poi, imposta l'attributo instance_type su "READ_POOL_INSTANCE" e l'attributo node_count sul numero di nodi che vuoi utilizzare.

L'esempio seguente include le risorse per l'istanza principale e il pool di lettura. 


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

Applica le modifiche

Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere la propria directory (chiamata anche modulo radice).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file viene denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel main.tf appena creato.

    (Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory. 
    terraform init

    (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

    Attendi che Terraform visualizzi il messaggio "Apply complete!".

  3. Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dall'eliminazione, nel file di configurazione Terraform imposta l'argomento deletion_protection su false. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:

    terraform destroy

REST v1

Utilizza il metodo insert della risorsa delle istanze 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 si trovino l'istanza primaria e il pool di lettura.
  • REGION: la regione del 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, ad esempio db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza primaria.
  • 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, POSTGRES_16.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo insert della risorsa delle istanze 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 si trovino l'istanza primaria e il pool di lettura.
  • REGION: la regione del 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, ad esempio db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza primaria.
  • 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, POSTGRES_16.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Converti una replica di lettura in un pool di lettura

Puoi convertire una replica di lettura di Cloud SQL Enterprise Plus esistente 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à in un pool di lettura, devi prima convertirla in una replica di lettura zonale.

Per ulteriori informazioni, vedi Modificare la configurazione del pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances patch per convertire una replica di lettura da utilizzare con un pool di lettura:

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

Effettua le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Terraform

Per convertire una replica di lettura in un pool di lettura, utilizza una risorsa Terraform. Il manifest è simile a quello utilizzato in Crea una replica di lettura. quindi completa i passaggi seguenti.

  • Modifica l'attributo instance_type da "READ_REPLICA_INSTANCE" a "READ_POOL_INSTANCE" e l'attributo node_count al numero di nodi che vuoi utilizzare.
  • Se l'hai impostato in precedenza, cancella l'attributo settings.availability_type.

REST v1

Utilizza il metodo patch della risorsa instances per convertire una replica di lettura in un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire, ad esempio my-read-replica.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch della risorsa instances per convertire una replica di lettura in un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire, ad esempio my-read-replica.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Converti un pool di lettura in una replica di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances patch per convertire una replica di lettura da utilizzare con un pool di lettura:

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

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi convertire.

Terraform

Per convertire un pool di lettura in una replica di lettura, utilizza una risorsa Terraform. Il manifest è simile a quello utilizzato in Crea un pool di lettura. Poi, modifica l'attributo instance_type da "READ_POOL_INSTANCE" a "READ_REPLICA_INSTANCE", cancella l'attributo node_count e imposta l'attributo settings.availability_type su ZONAL.

REST v1

Utilizza il metodo patch della risorsa instances per convertire un pool di lettura in una replica di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch della risorsa instances per convertire un pool di lettura in una replica di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare le informazioni sul pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances describe per descrivere il pool di lettura:

      gcloud sql instances describe READ_POOL_NAME

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi descrivere.

Una risposta di esempio con l'indirizzo IP e le informazioni sul nodo potrebbe essere simile alla seguente:

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

Utilizza il metodo get per visualizzare i dettagli del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo get per visualizzare i dettagli del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  [...],
  "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"
    }
  ]
}

Aggiungere o rimuovere nodi del pool di lettura

I seguenti passaggi scalano un pool di lettura modificando il numero di nodi del pool di lettura nel pool di lettura. Si applicano alcune limitazioni operative. Per ulteriori informazioni, vedi Limitazioni del pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances patch per scalare il pool di lettura:

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

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Terraform

Per modificare il numero di nodi del pool di lettura, aggiorna una risorsa Terraform esistente. Il manifest è simile a quello utilizzato in Crea un pool di lettura. Poi, modifica l'attributo node_count con il numero di nodi che vuoi utilizzare.

REST v1

Utilizza il metodo patch per scalare un pool di lettura aumentando o diminuendo il numero di nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch per scalare un pool di lettura aumentando o diminuendo il numero di nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Modifica della configurazione del pool di lettura

I passaggi riportati di seguito mostrano come modificare la configurazione del pool di lettura. Per informazioni più dettagliate, vedi Informazioni sulle impostazioni delle istanze e Modificare le istanze.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances patch per scalare verticalmente il pool di lettura, ad esempio modificando il tipo di macchina:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura.
  • TIER: il tipo di macchina che vuoi applicare a ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-8.

Terraform

Per modificare la configurazione del pool di lettura, aggiorna una risorsa Terraform esistente. Il manifest è simile a quello utilizzato in Crea un pool di lettura. Quindi, aggiorna gli attributi che vuoi modificare nel campo settings. Ad esempio, modifica l'attributo settings.tier in un tipo di macchina diverso.

REST v1

Utilizza il metodo patch per modificare la configurazione dei nodi 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 si trova il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch per modificare la configurazione dei nodi 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 si trova il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Connettersi a un pool di lettura

Esistono molti modi per connettersi a un pool di lettura. I seguenti passaggi mostrano un modo, ovvero la connessione a un pool di lettura con un indirizzo IP privato creando una VM nella stessa rete VPC che funge da origine della connessione.

Per saperne di più 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 ti connetti utilizzando il proxy di autenticazione Cloud SQL o i connettori Cloud SQL, assicurati di eseguire l'aggiornamento all'ultima versione. Per il supporto del pool di lettura, le versioni minime richieste includono quanto segue:

  • Proxy di autenticazione Cloud SQL: v2.15.2
  • Connettore Python Cloud SQL: v1.18.0
  • Connettore Cloud SQL Go: v1.16.0
  • Connettore del nodo Cloud SQL: v1.7.0
  • Connettore Java Cloud SQL: v1.24.0

Console

Per connetterti a un pool di lettura, completa i seguenti passaggi:

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

    Si aprirà la pagina Panoramica dell'istanza. Fai clic sul nuovo pool di lettura per visualizzare i dettagli, incluso l'indirizzo IP privato. Nella sezione Connetti a questa istanza, copia e salva il Nome connessione dell'istanza. connection name è nel formato projectID:region:instanceID. Utilizzerai questo connection name in un secondo momento quando avvierai il proxy di autenticazione Cloud SQL.
  2. Crea una VM di Compute Engine.
  3. Apri due connessioni SSH nella VM di Compute Engine. Questi vengono utilizzati nei passaggi successivi per eseguire il proxy di autenticazione Cloud SQL ed eseguire il client di database.
  4. Installa il client.
  5. Installa il proxy di autenticazione Cloud SQL.
  6. Avvia il proxy di autenticazione Cloud SQL.
  7. Connettiti all'istanza Cloud SQL.

Per ulteriori informazioni, consulta Connettiti a un'istanza Cloud SQL con IP privato.

Eliminare un pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances delete per eliminare un pool di lettura:

      gcloud sql instances delete READ_POOL_NAME

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi 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 si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

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 si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Passaggi successivi