Crear y gestionar grupos de lectura

En esta página se describe cómo crear y gestionar grupos de lectura para tus grandes cargas de trabajo de lectura.

Antes de empezar

  1. Los grupos de lectura contienen copias de una instancia principal. Si aún no lo has hecho, crea una instancia principal de la edición Enterprise Plus de Cloud SQL. Aunque los grupos de lectura admiten la conectividad de IP pública, en esta guía vamos a crear una instancia principal con conectividad de IP privada (PSA). Para obtener más información sobre las instancias principales y la replicación, consulta el artículo Acerca de la replicación en Cloud SQL.
  2. Una vez creada la instancia principal, elige una contraseña para el usuario raíz y ejecuta el siguiente comando para definirla en la instancia principal. Guarda esta contraseña para usarla más adelante al conectarte al grupo de lectura.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Haz las siguientes sustituciones:

    • PROJECT: el nombre del proyecto en el que quieres que se encuentren la instancia principal y el grupo de lectura.
    • PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.

Crear un grupo de lectura

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances create para crear un grupo de lectura con varios nodos de grupo de lectura:

      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

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre que quieras usar para el grupo de lectura.
  • TIER: el tipo de máquina que quieras usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.
  • PRIMARY_INSTANCE_NAME: el nombre de la instancia principal asociada al grupo de lectura, como my-primary-instance.

Terraform

Para crear un grupo de lectura, usa un recurso de Terraform. A continuación, asigna el valor "READ_POOL_INSTANCE" al atributo instance_type y el número de nodos que quieras usar al atributo node_count.

En el siguiente ejemplo se incluyen recursos para la instancia principal y el grupo de lectura. 


resource "google_sql_database_instance" "primary" {
  name             = "mysql-primary"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

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

    backup_configuration {
      enabled            = true
      binary_log_enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "mysql-replica"
  database_version = "MYSQL_8_4"
  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
    }
  }
}

Aplica los cambios

Para aplicar la configuración de Terraform en un proyecto, sigue los pasos que se indican en las siguientes secciones. Google Cloud

Preparar Cloud Shell

  1. Abre Cloud Shell.

  2. Define el Google Cloud proyecto Google Cloud predeterminado en el que quieras aplicar tus configuraciones de Terraform.

    Solo tiene que ejecutar este comando una vez por proyecto y puede hacerlo en cualquier directorio.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Las variables de entorno se anulan si defines valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

  1. En Cloud Shell, crea un directorio y un archivo nuevo en ese directorio. El nombre del archivo debe tener la extensión .tf. Por ejemplo, main.tf. En este tutorial, nos referiremos al archivo como main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Si estás siguiendo un tutorial, puedes copiar el código de ejemplo de cada sección o paso.

    Copia el código de ejemplo en el archivo main.tf que acabas de crear.

    También puedes copiar el código de GitHub. Se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

  3. Revisa y modifica los parámetros de ejemplo para aplicarlos a tu entorno.
  4. Guarda los cambios.
  5. Inicializa Terraform. Solo tienes que hacerlo una vez por directorio. 
    terraform init

    Si quieres usar la versión más reciente del proveedor de Google, incluye la opción -upgrade: 

    terraform init -upgrade

Aplica los cambios

  1. Revisa la configuración y comprueba que los recursos que va a crear o actualizar Terraform se ajustan a tus expectativas: 
    terraform plan

    Haga las correcciones necesarias en la configuración.

  2. Aplica la configuración de Terraform ejecutando el siguiente comando e introduciendo yes en la petición: 
    terraform apply

    Espera hasta que Terraform muestre el mensaje "Apply complete!".

  3. Abre tu Google Cloud proyecto para ver los resultados. En la Google Cloud consola, ve a tus recursos en la interfaz de usuario para asegurarte de que Terraform los ha creado o actualizado.

Eliminar los cambios

Para eliminar los cambios, sigue estos pasos:

  1. Para inhabilitar la protección contra la eliminación, en el archivo de configuración de Terraform, asigna el valor false al argumento deletion_protection. 
    deletion_protection =  "false"
  2. Aplica la configuración de Terraform actualizada ejecutando el siguiente comando e introduciendo yes en la petición: 
    terraform apply

  1. Para quitar los recursos que se hayan aplicado anteriormente con tu configuración de Terraform, ejecuta el siguiente comando e introduce yes en la petición:

    terraform destroy

REST v1

Usa el método insert del recurso instances para crear un grupo de lectura con varios nodos de grupo de lectura. La propiedad databaseVersion debe ser la misma que la principal.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que quieres que se encuentren la instancia principal y el grupo de lectura.
  • REGION: la región del grupo de lectura, como us-east1. La región debe ser la misma que la de la instancia principal.
  • TIER: el tipo de máquina que quieras usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
  • READ_POOL_NAME: el nombre que quieras usar para el grupo de lectura, como my-read-pool.
  • DATABASE_VERSION: la versión de la base de datos que quieras usar. Por ejemplo, MYSQL_8_0_37.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.
  • FULL_NETWORK_NAME: la ruta de red completa en la que quieres que se encuentre el grupo de lectura, como projects/vpc-host-project/global/networks/my-network-name.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

{
  "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 tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método insert del recurso instances para crear un grupo de lectura con varios nodos de grupo de lectura. La propiedad databaseVersion debe ser la misma que la principal.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que quieres que se encuentren la instancia principal y el grupo de lectura.
  • REGION: la región del grupo de lectura, como us-east1. La región debe ser la misma que la de la instancia principal.
  • TIER: el tipo de máquina que quieras usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
  • READ_POOL_NAME: el nombre que quieras usar para el grupo de lectura, como my-read-pool.
  • DATABASE_VERSION: la versión de la base de datos que quieras usar. Por ejemplo, MYSQL_8_0_37.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.
  • FULL_NETWORK_NAME: la ruta de red completa en la que quieres que se encuentre el grupo de lectura, como projects/vpc-host-project/global/networks/my-network-name.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

{
  "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 tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Convertir una réplica de lectura en un grupo de lectura

Puedes convertir una réplica de lectura de la edición Enterprise Plus de Cloud SQL en un grupo de lectura especificando el número de nodos del grupo. Durante este proceso de conversión, la IP de la réplica se convertirá en la IP del grupo de lectura (el endpoint de lectura), por lo que los clientes actuales podrán conectarse al grupo sin necesidad de reconfigurarlo.

Los nodos del grupo de lectura recién creado tendrán el mismo tipo de máquina y la misma configuración que la réplica de lectura original. Para cambiar este tipo de máquina o configuración, debes realizar otra operación. Esta operación solo se admite en réplicas de lectura zonales. Para convertir una réplica de lectura de alta disponibilidad en un grupo de lectura, primero debes convertirla en una réplica de lectura zonal.

Para obtener más información, consulta Editar la configuración del grupo de lectura.

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances patch para convertir una réplica de lectura para usarla con un grupo de lectura:

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

Haz las siguientes sustituciones:

  • READ_REPLICA_NAME: el nombre de la réplica de lectura que quieras convertir.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Terraform

Para convertir una réplica de lectura en un grupo de lectura, usa un recurso de Terraform. El manifiesto es similar al que has usado en Crear una réplica de lectura. A continuación, completa estos pasos:

  • Cambia el atributo instance_type de "READ_REPLICA_INSTANCE" a "READ_POOL_INSTANCE" y el atributo node_count por el número de nodos que quieras usar.
  • Si ya lo ha definido, borre el atributo settings.availability_type.

REST v1

Usa el método patch del recurso instances para convertir una réplica de lectura en un grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • READ_REPLICA_NAME: el nombre de la réplica de lectura que quieras convertir, como my-read-replica.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método patch del recurso instances para convertir una réplica de lectura en un grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • READ_REPLICA_NAME: el nombre de la réplica de lectura que quieras convertir, como my-read-replica.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Convertir un grupo de lectura en una réplica de lectura

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances patch para convertir una réplica de lectura para usarla con un grupo de lectura:

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

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura que quieras convertir.

Terraform

Para convertir un grupo de lectura en una réplica de lectura, usa un recurso de Terraform. El manifiesto es similar al que has usado en Crear un grupo de lectura. A continuación, cambia el atributo instance_type de "READ_POOL_INSTANCE" a "READ_REPLICA_INSTANCE", borra el atributo node_count y asigna el valor ZONAL al atributo settings.availability_type.

REST v1

Usa el método patch del recurso de instancias para convertir un grupo de lectura en una réplica de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método patch del recurso de instancias para convertir un grupo de lectura en una réplica de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Ver información de un grupo de lectura

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances describe para describir el grupo de lectura:

      gcloud sql instances describe READ_POOL_NAME

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura que quieres describir.

Una respuesta de ejemplo con la dirección IP y la información del nodo podría ser similar a la siguiente:

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

Usa el método get para ver los detalles del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método get para ver los detalles del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

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

Añadir o quitar nodos de grupo de lectura

En los pasos siguientes se explica cómo aumentar o reducir la escala de un grupo de lectura modificando el número de nodos del grupo de lectura. Se aplican algunas limitaciones de funcionamiento. Para obtener más información, consulta Limitaciones de los grupos de lectura.

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances patch para escalar el grupo de lectura:

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

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Terraform

Para cambiar el número de nodos del grupo de lectura, actualiza un recurso de Terraform. El manifiesto es similar al que has usado en Crear un grupo de lectura. A continuación, cambia el atributo node_count por el número de nodos que quieras usar.

REST v1

Usa el método patch para aumentar o reducir la escala de un grupo de lectura modificando el número de nodos del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

{
  "nodeCount": NODE_COUNT
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método patch para aumentar o reducir la escala de un grupo de lectura modificando el número de nodos del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • NODE_COUNT: el número de nodos de grupo de lectura que quieres que haya en el grupo de lectura. Elige cualquier número entre 1 y 20.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

{
  "nodeCount": NODE_COUNT
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Editar la configuración del grupo de lectura

Sigue estos pasos para editar la configuración del grupo de lectura. Para obtener más información, consulta Acerca de la configuración de instancias y Editar instancias.

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances patch para escalar verticalmente el grupo de lectura. Por ejemplo, puedes modificar el tipo de máquina:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura.
  • TIER: el tipo de máquina que quieras aplicar a cada nodo del grupo de lectura, como db-perf-optimized-N-8.

Terraform

Para editar la configuración del grupo de lectura, actualiza un recurso de Terraform. El manifiesto es similar al que has usado en Crear un grupo de lectura. A continuación, actualice los atributos que quiera cambiar en el campo settings. Por ejemplo, cambie el atributo settings.tier a otro tipo de máquina.

REST v1

Usa el método patch para modificar la configuración del nodo del grupo de lectura. Los ajustes se aplican de forma uniforme a todos los nodos del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • TIER: el tipo de máquina que quieras usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Usa el método patch para modificar la configuración del nodo del grupo de lectura. Los ajustes se aplican de forma uniforme a todos los nodos del grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • TIER: el tipo de máquina que quieras usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Conectarse a un grupo de lectura

Hay muchas formas de conectarse a un grupo de lectura. En los pasos siguientes se muestra una forma de hacerlo: conectarse a un pool de lectura con una dirección IP privada creando una VM en la misma red de VPC para que actúe como origen de la conexión.

Para obtener más información sobre otras formas de configurar la conectividad a una instancia de Cloud SQL, consulta Acerca de las conexiones de Cloud SQL. Normalmente, para usar los métodos de conexión, primero debes obtener la dirección IP o el nombre de conexión de la instancia, tal como se describe en Ver información del grupo de lectura. Los grupos de lectura admiten la mayoría de los métodos de conexión disponibles para otras instancias de Cloud SQL, con algunas limitaciones.

Si te conectas mediante el proxy de autenticación de Cloud SQL o los conectores de Cloud SQL, asegúrate de actualizar a la versión más reciente. Para admitir el grupo de lectura, se requieren las siguientes versiones mínimas:

  • Proxy de autenticación de Cloud SQL: v2.15.2
  • Conector Python de Cloud SQL: v1.18.0
  • Conector Go de Cloud SQL: v1.16.0
  • Conector de nodo de Cloud SQL: v1.7.0
  • Conector Java de Cloud SQL: v1.24.0

Consola

Para conectarte a un grupo de lectura, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

    Se te dirigirá a la página Descripción general de la instancia. Haz clic en el nuevo grupo de lectura para ver los detalles, incluida su dirección IP privada. En la sección Conectar a esta instancia, copia y guarda el Nombre de conexión de la instancia. El connection name tiene el formato projectID:region:instanceID. Lo usarás más adelante cuando inicies el proxy de autenticación de Cloud SQL.connection name
  2. Crea una VM de Compute Engine.
  3. Abre dos conexiones SSH a la VM de Compute Engine. Se usan en los pasos posteriores para ejecutar el proxy de autenticación de Cloud SQL y el cliente de la base de datos.
  4. Instala el cliente.
  5. Instala el proxy de autenticación de Cloud SQL.
  6. Inicia el proxy de autenticación de Cloud SQL.
  7. Conéctate a tu instancia de Cloud SQL.

Para obtener más información, consulta el artículo Conectarse a una instancia de Cloud SQL con IP privada.

Eliminar un grupo de lectura

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

Usa el siguiente comando gcloud sql instances delete para eliminar un pool de lectura:

      gcloud sql instances delete READ_POOL_NAME

Haz las siguientes sustituciones:

  • READ_POOL_NAME: el nombre del grupo de lectura que quieres eliminar.

REST v1

Utiliza el método delete para eliminar un grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Utiliza el método delete para eliminar un grupo de lectura.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: el nombre del proyecto en el que reside el grupo de lectura.
  • READ_POOL_NAME: el nombre del grupo de lectura, como my-read-pool.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Siguientes pasos