Se usó la API de Cloud Translation para traducir esta página.

Crea y administra grupos de lectura
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

MySQL | PostgreSQL | SQL Server

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

Antes de comenzar

Los grupos de lectura contienen copias de una instancia principal. Si aún no lo hiciste, crea una instancia principal de la edición de Cloud SQL Enterprise Plus. Si bien los grupos de lectura admiten conectividad de IP pública, para los fines de esta guía, crea una instancia principal con conectividad de IP privada (PSA). Para obtener más información sobre las instancias principales y la replicación, consulta Acerca de la replicación en Cloud SQL.
Después de crear la instancia principal, elige una contraseña para el usuario raíz y ejecuta el siguiente comando para establecerla en la instancia principal. Guarda esta contraseña para usarla más adelante cuando te conectes al grupo de lectura.

    gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

Asegúrate de usar la versión 516.0.0 o posterior de gcloud.

Realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que deseas que residan la instancia principal y el grupo de lectura.
PRIMARY_INSTANCE_NAME: Es el nombre de la instancia principal.

Crea un grupo de lectura

gcloud

Para obtener información sobre cómo instalar y comenzar a usar la CLI de gcloud, consulta Instala la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta Usa Cloud Shell.

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

      gcloud beta 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

Realiza los siguientes reemplazos:

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

REST v1

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que deseas que residan la instancia principal y el grupo de lectura.
REGION: Es la región del grupo de lectura, como us-east1. La región debe ser la misma que la de la instancia principal.
TIER: Es el tipo de máquina que deseas usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
PRIMARY_INSTANCE_NAME: Es el nombre de la instancia principal.
READ_POOL_NAME: Es el nombre que deseas usar para el grupo de lectura, como my-read-pool.
DATABASE_VERSION: La versión de la base de datos que deseas usar. Por ejemplo, MYSQL_8_0_37
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 20.
FULL_NETWORK_NAME: Es la ruta de acceso de red completa en la que deseas que resida 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_READ_POOL",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que deseas que residan la instancia principal y el grupo de lectura.
REGION: Es la región del grupo de lectura, como us-east1. La región debe ser la misma que la de la instancia principal.
TIER: Es el tipo de máquina que deseas usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
PRIMARY_INSTANCE_NAME: Es el nombre de la instancia principal.
READ_POOL_NAME: Es el nombre que deseas usar para el grupo de lectura, como my-read-pool.
DATABASE_VERSION: La versión de la base de datos que deseas usar. Por ejemplo, MYSQL_8_0_37
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 20.
FULL_NETWORK_NAME: Es la ruta de acceso de red completa en la que deseas que resida 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_READ_POOL",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

Cómo convertir una réplica de lectura en un grupo de lectura

Para convertir una réplica de lectura existente de la edición de Cloud SQL Enterprise Plus en un grupo de lectura, especifica la cantidad de nodos en el grupo. Durante este proceso de conversión, la IP de la réplica se convertirá en la IP del grupo de lectura (el extremo de lectura), de modo que los clientes existentes puedan conectarse al grupo sin volver a configurarlo.

Los nodos del grupo de lectura creados recientemente tendrán el mismo tipo de máquina y configuración que la réplica de lectura original. Cambiar este tipo de máquina o configuración requiere una operación independiente. Esta operación solo se admite para réplicas de lectura zonales. Para convertir una réplica de lectura con alta disponibilidad (HA) en un grupo de lectura, primero debes convertirla en una réplica de lectura zonal.

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

gcloud

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

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

Realiza los siguientes reemplazos:

READ_REPLICA_NAME: Es el nombre de la réplica de lectura que deseas convertir.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 20.

REST v1

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

READ_REPLICA_NAME: Es el nombre de la réplica de lectura que deseas convertir, como my-read-replica.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

READ_REPLICA_NAME: Es el nombre de la réplica de lectura que deseas convertir, como my-read-replica.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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

gcloud

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

      gcloud beta sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE

Realiza los siguientes reemplazos:

READ_POOL_NAME: Es el nombre del grupo de lectura que deseas convertir.

REST v1

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

READ_POOL_NAME: Es 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"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

READ_POOL_NAME: Es 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"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

Cómo ver la información del grupo de lectura

gcloud

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

      gcloud beta sql instances describe READ_POOL_NAME

Realiza los siguientes reemplazos:

READ_POOL_NAME: Es el nombre del grupo de lectura que deseas describir.

Un ejemplo de respuesta con información de la dirección IP y el nodo puede ser similar al 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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

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

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Agrega o quita nodos del grupo de lectura

En los siguientes pasos, se escala un grupo de lectura hacia adentro o hacia afuera modificando la cantidad de nodos del grupo de lectura. Se aplican algunas limitaciones de operación. Para obtener más información, consulta Limitaciones del grupo de lectura.

gcloud

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

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

Realiza los siguientes reemplazos:

READ_POOL_NAME: Es el nombre del grupo de lectura.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 20.

REST v1

Usa el método patch para escalar un grupo de lectura hacia adentro o hacia afuera modificando la cantidad de nodos del grupo de lectura.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

Usa el método patch para escalar un grupo de lectura hacia adentro o hacia afuera modificando la cantidad de nodos del grupo de lectura.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
NODE_COUNT: Es la cantidad de nodos del grupo de lectura que deseas en el grupo de lectura. Elige cualquier número del 1 al 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAMEINSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

Edita la configuración del grupo de lectura

En los siguientes pasos, se muestra cómo editar la configuración del grupo de lectura. Para obtener información más detallada, consulta Acerca de la configuración de instancias y Edita instancias.

gcloud

Usa el siguiente comando gcloud beta sql instances patch para escalar verticalmente el grupo de lectura, por ejemplo, modificando el tipo de máquina:

      gcloud beta sql instances patch READ_POOL_NAME \
      --tier=TIER

Realiza los siguientes reemplazos:

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

REST v1

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
TIER: Es el tipo de máquina que deseas usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
TIER: Es el tipo de máquina que deseas usar para cada nodo del grupo de lectura, como db-perf-optimized-N-4.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

Cómo conectarse a un grupo de lectura

Existen muchas formas de conectarse a un grupo de lectura. En los siguientes pasos, se muestra una manera de conectarse a un grupo de lectura con una dirección IP privada mediante la creación de una VM en la misma red de VPC que funcione como fuente de 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. Por lo general, los métodos de conexión requieren que primero obtengas la dirección IP o el nombre de conexión de la instancia, como se describe en Cómo ver la 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 con el proxy de Cloud SQL Auth o los conectores de Cloud SQL, asegúrate de actualizar a la versión más reciente. Para admitir el grupo de lectura, las versiones mínimas requeridas incluyen las siguientes:

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

Console

Para conectarte a un grupo de lectura, completa los siguientes pasos:

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

Ir a Instancias de Cloud SQL
Se te redireccionará 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 Conéctate a esta instancia, copia y guarda el Nombre de la conexión de la instancia. connection name tiene el formato projectID:region:instanceID. Usarás este connection name más adelante cuando inicies el proxy de autenticación de Cloud SQL.
Crea una VM de Compute Engine.
Abre dos conexiones SSH a la VM de Compute Engine Se usan en pasos posteriores para ejecutar el proxy de autenticación de Cloud SQL y el cliente de la base de datos.
Instala el cliente.
Instala el proxy de Cloud SQL Auth.
Inicia el proxy de Cloud SQL Auth.
Conéctate a tu instancia de Cloud SQL.

Para obtener más información, consulta Cómo conectarse a una instancia de Cloud SQL con una IP privada.

Borra un grupo de lectura

gcloud

Usa el siguiente comando de gcloud sql instances delete para borrar un grupo de lectura:

      gcloud sql instances delete READ_POOL_NAME

Realiza los siguientes reemplazos:

READ_POOL_NAME: Es el nombre del grupo de lectura que deseas borrar.

REST v1

Usa el método delete para borrar un grupo de lectura.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

Usa el método delete para borrar un grupo de lectura.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT: Es el nombre del proyecto en el que reside el grupo de lectura.
READ_POOL_NAME: Es 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

¿Qué sigue?

Acerca de los grupos de lectura

Crea y administra grupos de lectura Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Crea un grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Cómo convertir una réplica de lectura en un grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

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

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Cómo ver la información del grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Agrega o quita nodos del grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Edita la configuración del grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Cómo conectarse a un grupo de lectura

Console

Borra un grupo de lectura

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

¿Qué sigue?

Crea y administra grupos de lectura
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.