Creare e gestire i pool di lettura

Questa pagina descrive come creare e gestire i pool di lettura per i workload 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 Cloud SQL Enterprise Plus. thought Sebbene i pool di lettura supportino le connessioni che utilizzano l'IP pubblico, l'accesso privato ai servizi e Private Service Connect, ai fini di questa guida, crea un'istanza principale con connettività IP privata che utilizza l'accesso privato ai servizi.

    Per saperne di più sulle istanze principali e sulla replica, consulta Informazioni sulla replica in Cloud SQL.

  2. Tieni presente che puoi creare un massimo di 7 repliche di lettura per istanza principale. Questo valore può includere qualsiasi numero combinato di repliche di lettura e conteggio dei nodi del pool di lettura in un'istanza del pool di lettura. Ad esempio, un'istanza principale potrebbe avere due repliche di lettura e un pool di lettura separato di cinque repliche di lettura (nodi del pool di lettura).
  3. Quando crei una nuova istanza Cloud SQL, devi impostare una password per l'account utente predefinito prima di poterti connettere all'istanza. Per Cloud SQL per SQL Server, l'utente predefinito è sqlserver.

    Utilizza il comando gcloud sql users set-password come segue per impostare la password per l'utente predefinito:

      gcloud sql users set-password sqlserver \
  --instance=INSTANCE_NAME \
  --prompt-for-password

    Sostituisci INSTANCE_NAME con il nome dell'istanza prima di eseguire il comando.

    Salva questa password per utilizzarla in un secondo momento quando ti connetti al pool di lettura.

Crea un pool di lettura

gcloud

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

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

      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 --no-assign-ip

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 compreso tra 1 e 7.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza principale 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_compute_network" "peering_network" {
  name                    = "private-network"
  auto_create_subnetworks = "false"
}

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

resource "google_service_networking_connection" "default" {
  network                 = google_compute_network.peering_network.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_address.name]
}

resource "google_sql_database_instance" "primary" {
  name             = "sqlserver-primary"
  database_version = "SQLSERVER_2022_ENTERPRISE"
  region           = "europe-west4"
  root_password    = "INSERT-PASSWORD-HERE"

  depends_on = [google_service_networking_connection.default]

  instance_type = "CLOUD_SQL_INSTANCE"

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

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled    = false
      private_network = google_compute_network.peering_network.id
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "sqlserver-replica"
  database_version = "SQLSERVER_2022_ENTERPRISE"
  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    = false
      private_network = google_compute_network.peering_network.id
    }
  }
}

Applica le modifiche

Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi descritti 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 Terraform deve avere la propria directory (chiamata anche modulo principale).

  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 è 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 file main.tf appena creato.

    Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

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

    Facoltativamente, per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Esamina 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 Terraform eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

    Attendi finché Terraform non visualizza il messaggio "Apply complete!".

  3. Apri il tuo progetto Google Cloud 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 da 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 Terraform eseguendo il comando seguente e inserendo yes al prompt:

    terraform destroy

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 la stessa della proprietà principale.

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

  • PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza principale 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 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.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero compreso tra 1 e 7.
  • 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 instances per creare un pool di lettura con più nodi del pool di lettura. La proprietà databaseVersion deve essere la stessa della proprietà principale.

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

  • PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza principale 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 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.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero compreso tra 1 e 7.
  • 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 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 a livello di zona. Cloud SQL per SQL Server non supporta l'alta affidabilità sulle repliche di lettura.

Per saperne di più, consulta Modifica la configurazione del pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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 compreso tra 1 e 7.

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 impostandolo sul 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 delle istanze per convertire una replica di lettura in un pool di lettura.

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

  • 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 compreso tra 1 e 7.

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 sostituzioni seguenti:

  • 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 compreso tra 1 e 7.

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:

Scalabilità automatica del pool di lettura

Puoi configurare il pool di lettura in modo che venga ridimensionato automaticamente per adattarsi alle mutevoli esigenze del workload della tua applicazione. Per saperne di più, consulta Scalabilità automatica del pool di lettura.

Converti un pool di lettura in una replica di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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:

Visualizza le informazioni sul pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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"
    }
  ]
}

Aggiungi o rimuovi nodi del pool di lettura

I passaggi seguenti consentono di fare lo scale in o lo scale out di un pool di lettura modificando il numero di nodi del pool di lettura nel pool di lettura. Si applicano alcune limitazioni alle operazioni. Per saperne di più, consulta Limitazioni dei pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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 compreso tra 1 e 7.

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 fare lo scale in o lo scale out di un pool di lettura modificando il numero di nodi del pool di lettura nel pool di lettura.

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

  • 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 compreso tra 1 e 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 fare lo scale in o lo scale out di un pool di lettura modificando il numero di nodi del pool di lettura nel pool di lettura.

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

  • 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 compreso tra 1 e 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 la configurazione del pool di lettura

I passaggi seguenti mostrano come modificare la configurazione del pool di lettura. Per informazioni più dettagliate, consulta Informazioni sulle impostazioni delle istanze e Modifica le istanze.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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. Poi, 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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:

Connettiti a un pool di lettura

Esistono molti modi per connettersi a un pool di lettura. I passaggi seguenti mostrano un modo, ovvero la connessione a un pool di lettura con un indirizzo IP privato creando una VM nella stessa rete VPC che funga 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 di solito richiedono di ottenere prima l'indirizzo IP o il nome della connessione dell'istanza, come descritto in Visualizza 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 Cloud SQL Auth Proxy 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:

  • Cloud SQL Auth Proxy: v2.15.2
  • Connettore Python Cloud SQL: v1.18.0
  • Connettore Go di Cloud SQL: v1.16.0
  • Connettore Node 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

    Viene visualizzata 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 e il client del 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 saperne di più, consulta Connettiti a un'istanza Cloud SQL con IP privato.

Elimina un pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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