Crie e faça a gestão de pools de leitura

Esta página descreve como criar e gerir pools de leitura para as suas cargas de trabalho de leitura grandes.

Antes de começar

  1. Os conjuntos de leitura contêm cópias de uma instância principal. Se ainda não o fez, crie uma instância principal da edição Cloud SQL Enterprise Plus. Embora os conjuntos de leitura suportem a conetividade de IP público, para efeitos deste guia, crie uma instância principal com conetividade de IP privado (PSA). Para mais informações sobre instâncias principais e replicação, consulte o artigo Acerca da replicação no Cloud SQL.
  2. Depois de criar a instância principal, escolha uma palavra-passe para o utilizador root e execute o seguinte comando para definir a palavra-passe na instância principal. Guarde esta palavra-passe para usar mais tarde quando se ligar ao conjunto de leitura.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Faça as seguintes substituições:

    • PROJECT: o nome do projeto onde quer que a instância principal e o conjunto de leitura residam.
    • PRIMARY_INSTANCE_NAME: o nome da instância principal.

Crie um conjunto de leitura

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte gcloud sql instances createcomando para criar um pool de leitura com vários nós do pool de leitura:

      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

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome que quer usar para o conjunto de leitura.
  • TIER: o tipo de máquina que quer usar para cada nó do conjunto de leitura, como db-perf-optimized-N-4.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.
  • PRIMARY_INSTANCE_NAME: o nome da instância principal associada ao conjunto de leitura, como my-primary-instance.

Terraform

Para criar um conjunto de leitura, use um recurso do Terraform. Em seguida, defina o atributo instance_type como "READ_POOL_INSTANCE" e o atributo node_count como o número de nós que quer usar.

O exemplo seguinte inclui recursos para a instância principal e o conjunto de leitura. 


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

Aplique as alterações

Para aplicar a configuração do Terraform num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

  1. Inicie o Cloud Shell.

  2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

    Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

  1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

    Copie o exemplo de código para o ficheiro main.tf criado recentemente.

    Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

  3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
  4. Guarde as alterações.
  5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório. 
    terraform init

    Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade: 

    terraform init -upgrade

Aplique as alterações

  1. Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas: 
    terraform plan

    Faça as correções necessárias à configuração.

  2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

    Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

  3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Eliminar as alterações

Para eliminar as alterações, faça o seguinte:

  1. Para desativar a proteção contra eliminação, no ficheiro de configuração do Terraform, defina o argumento deletion_protection como false. 
    deletion_protection =  "false"
  2. Aplique a configuração do Terraform atualizada executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

  1. Remova os recursos aplicados anteriormente com a sua configuração do Terraform executando o seguinte comando e introduzindo yes no comando:

    terraform destroy

REST v1

Use o método insert do recurso instances para criar um conjunto de leitura com vários nós do conjunto de leitura. A propriedade databaseVersion tem de ser igual à principal.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde quer que a instância principal e o conjunto de leitura residam.
  • REGION: a região do conjunto de leitura, como us-east1. A região tem de ser a mesma que a instância principal.
  • TIER: o tipo de máquina que quer usar para cada nó do conjunto de leitura no conjunto de leitura, como db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: o nome da instância principal.
  • READ_POOL_NAME: o nome que quer usar para o conjunto de leitura, como my-read-pool.
  • DATABASE_VERSION: a versão da base de dados que quer usar. Por exemplo, POSTGRES_16.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.
  • FULL_NETWORK_NAME: o caminho de rede completo onde quer que o conjunto de leitura resida, como projects/vpc-host-project/global/networks/my-network-name.

Método HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método insert do recurso instances para criar um conjunto de leitura com vários nós do conjunto de leitura. A propriedade databaseVersion tem de ser igual à principal.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde quer que a instância principal e o conjunto de leitura residam.
  • REGION: a região do conjunto de leitura, como us-east1. A região tem de ser a mesma que a instância principal.
  • TIER: o tipo de máquina que quer usar para cada nó do conjunto de leitura no conjunto de leitura, como db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: o nome da instância principal.
  • READ_POOL_NAME: o nome que quer usar para o conjunto de leitura, como my-read-pool.
  • DATABASE_VERSION: a versão da base de dados que quer usar. Por exemplo, POSTGRES_16.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.
  • FULL_NETWORK_NAME: o caminho de rede completo onde quer que o conjunto de leitura resida, como projects/vpc-host-project/global/networks/my-network-name.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Converta uma réplica de leitura num conjunto de leitura

Pode converter uma réplica de leitura da edição Cloud SQL Enterprise Plus existente num conjunto de leitura especificando o número de nós no conjunto. Durante este processo de conversão, o IP da réplica torna-se o IP do conjunto de leitura (o ponto final de leitura), pelo que os clientes existentes podem estabelecer ligação ao conjunto sem reconfiguração.

Os nós do conjunto de leitura recém-criados têm o mesmo tipo de máquina e configuração que a réplica de leitura original. A alteração deste tipo de máquina ou configuração requer uma operação separada. Esta operação só é suportada para réplicas de leitura zonais. Para converter uma réplica de leitura de alta disponibilidade (HA) num conjunto de leitura, primeiro tem de a converter numa réplica de leitura zonal.

Para mais informações, consulte o artigo Edite a configuração do conjunto de leitura.

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances patch para converter uma réplica de leitura para utilização com um conjunto de leitura:

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

Faça as seguintes substituições:

  • READ_REPLICA_NAME: o nome da réplica de leitura que quer converter.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Terraform

Para converter uma réplica de leitura num conjunto de leitura, use um recurso do Terraform. O manifesto é semelhante ao que usou em Crie uma réplica de leitura. Em seguida, conclua os seguintes passos:

  • Altere o atributo instance_type de "READ_REPLICA_INSTANCE" para "READ_POOL_INSTANCE" e o atributo node_count para o número de nós que quer usar.
  • Se o tiver definido anteriormente, limpe o atributo settings.availability_type.

REST v1

Use o método patch do recurso instances para converter uma réplica de leitura num conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • READ_REPLICA_NAME: o nome da réplica de leitura que quer converter, como my-read-replica.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método patch do recurso instances para converter uma réplica de leitura num conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • READ_REPLICA_NAME: o nome da réplica de leitura que quer converter, como my-read-replica.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Converta um pool de leitura numa réplica de leitura

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances patch para converter uma réplica de leitura para utilização com um conjunto de leitura:

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

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitores que quer converter.

Terraform

Para converter um conjunto de leitura num réplica de leitura, use um recurso do Terraform. O manifesto é semelhante ao que usou em Crie um conjunto de leitura. Em seguida, altere o atributo instance_type de "READ_POOL_INSTANCE" para "READ_REPLICA_INSTANCE", limpe o atributo node_count e defina o atributo settings.availability_type como ZONAL.

REST v1

Use o método patch do recurso instances para converter um conjunto de leitura numa réplica de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método patch do recurso instances para converter um conjunto de leitura numa réplica de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Veja informações do conjunto de leitura

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances describe para descrever o conjunto de leitura:

      gcloud sql instances describe READ_POOL_NAME

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome da piscina de leitura que quer descrever.

Uma resposta de exemplo com o endereço IP e as informações do nó pode ser semelhante à seguinte:

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

Use o método get para ver os detalhes do conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método get para ver os detalhes do conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

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

Adicione ou remova nós do conjunto de leitura

Os passos seguintes aumentam ou diminuem a escala de um conjunto de leitura modificando o número de nós do conjunto de leitura no conjunto de leitura. Aplicam-se algumas limitações de funcionamento. Para mais informações, consulte Limitações do conjunto de leitura.

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances patch para dimensionar o conjunto de leitura:

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

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitura.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Terraform

Para alterar o número de nós do conjunto de leitura, atualize um recurso do Terraform existente. O manifesto é semelhante ao que usou em Crie um conjunto de leitura. Em seguida, altere o atributo node_count para o número de nós que quer usar.

REST v1

Use o método patch para aumentar ou diminuir a escala de um conjunto de leitura modificando o número de nós do conjunto de leitura no conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "nodeCount": NODE_COUNT
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método patch para aumentar ou diminuir a escala de um conjunto de leitura modificando o número de nós do conjunto de leitura no conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • NODE_COUNT: o número de nós do conjunto de leitura que quer no conjunto de leitura. Escolha qualquer número de 1 a 20.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "nodeCount": NODE_COUNT
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Edite a configuração do conjunto de leitura

Os passos seguintes mostram como editar a configuração do conjunto de leitura. Para mais informações detalhadas, consulte os artigos Acerca das definições de instâncias e Edite instâncias.

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances patch para dimensionar verticalmente o conjunto de leitura, por exemplo, modificando o tipo de máquina:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitura.
  • TIER: o tipo de máquina que quer aplicar a cada nó do conjunto de leitura no conjunto de leitura, como db-perf-optimized-N-8.

Terraform

Para editar a configuração do conjunto de leitura, atualize um recurso do Terraform existente. O manifesto é semelhante ao que usou em Crie um conjunto de leitura. Em seguida, atualize os atributos que quer alterar no campo settings. Por exemplo, altere o atributo settings.tier para um tipo de máquina diferente.

REST v1

Use o método patch para modificar a configuração do nó do conjunto de leitura. As definições são aplicadas uniformemente a todos os nós do conjunto de leitura no conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • TIER: o tipo de máquina que quer usar para cada nó do conjunto de leitura no conjunto de leitura, como db-perf-optimized-N-4.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método patch para modificar a configuração do nó do conjunto de leitura. As definições são aplicadas uniformemente a todos os nós do conjunto de leitura no conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • TIER: o tipo de máquina que quer usar para cada nó do conjunto de leitura no conjunto de leitura, como db-perf-optimized-N-4.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Faça a associação a um conjunto de leitura

Existem várias formas de estabelecer ligação a um conjunto de leitura. Os passos seguintes mostram uma forma, nomeadamente, estabelecer ligação a um conjunto de leitura com um endereço IP privado através da criação de uma VM na mesma rede da VPC para servir como origem da ligação.

Para mais informações sobre outras formas de configurar a conetividade a uma instância do Cloud SQL, consulte o artigo Acerca das ligações do Cloud SQL. Normalmente, os métodos de ligação exigem que obtenha primeiro o endereço IP ou o nome de ligação da instância, conforme descrito em Ver informações do conjunto de leitura. Os conjuntos de leitura suportam a maioria dos métodos de ligação disponíveis para outras instâncias do Cloud SQL, com algumas limitações.

Se estiver a estabelecer ligação através do proxy Auth do Cloud SQL ou dos conectores do Cloud SQL, certifique-se de que atualiza para a versão mais recente. Para o suporte de pools de leitura, as versões mínimas necessárias incluem o seguinte:

  • Proxy Auth do Cloud SQL: v2.15.2
  • Cloud SQL Python Connector: v1.18.0
  • Cloud SQL Go Connector: v1.16.0
  • Conetor de nós do Cloud SQL: v1.7.0
  • Cloud SQL Java Connector: v1.24.0

Consola

Para estabelecer ligação a um conjunto de leitura, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

    Acede à página Vista geral da instância. Clique no novo conjunto de leitura para ver os detalhes, incluindo o respetivo endereço IP privado. Na secção Estabeleça ligação a esta instância, copie e guarde o Nome da ligação da instância. O connection name está no formato projectID:region:instanceID. Vai usar este connection name mais tarde quando iniciar o proxy Auth do Cloud SQL.
  2. Crie uma VM do Compute Engine.
  3. Abra duas ligações SSH à VM do Compute Engine. Estes são usados nos passos subsequentes para executar o proxy Auth do Cloud SQL e executar o cliente de base de dados.
  4. Instale o cliente.
  5. Instale o proxy Auth do Cloud SQL.
  6. Inicie o proxy Auth do Cloud SQL.
  7. Estabeleça ligação à sua instância do Cloud SQL.

Para mais informações, consulte o artigo Estabeleça ligação a uma instância do Cloud SQL com IP privado.

Elimine um grupo de leitura

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Use o seguinte comando gcloud sql instances delete para eliminar um conjunto de leitura:

      gcloud sql instances delete READ_POOL_NAME

Faça as seguintes substituições:

  • READ_POOL_NAME: o nome do conjunto de leitura que quer eliminar.

REST v1

Use o método delete para eliminar um conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o método delete para eliminar um conjunto de leitura.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o nome do projeto onde reside o pool de leitura.
  • READ_POOL_NAME: o nome do conjunto de leitura, como my-read-pool.

Método HTTP e URL: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

O que se segue?