Crear réplicas de lectura

Consola

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

   Ir a Instancias de Cloud SQL

2. Busca la instancia de la que quieras crear una réplica y, a continuación, abre el menú more actions situado junto al anuncio.
3. Selecciona Crear réplica de lectura.

   Si no ves esa opción, significa que la instancia es una réplica y no puedes crear una réplica de una réplica.

4. En la sección Personalizar tu instancia, actualiza la configuración de tu réplica. Para empezar, haz clic en Mostrar opciones de configuración para ver los grupos de ajustes. A continuación, despliega los grupos que quieras para revisar y personalizar los ajustes. A la derecha se muestra un resumen de todas las opciones que selecciones. Personalizar estos ajustes es opcional. Se asignan valores predeterminados en todos los casos en los que no se realizan personalizaciones.

   Para obtener más información sobre cada ajuste, consulta la página Acerca de los ajustes de instancias.

5. Haz clic en Crear réplica.

   Cloud SQL crea una copia de seguridad, si es necesario, y crea la réplica. Se te redirige a la página de la instancia principal.

gcloud

Crea la réplica:

gcloud sql instances create REPLICA_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME
  

Si es necesario, puedes especificar otro tamaño de nivel con el parámetro --tier.

Puedes especificar otra región con el parámetro --region.

Si la instancia principal solo tiene una dirección IP interna, añade el parámetro --no-assign-ip al comando.

Puede añadir más parámetros para otros ajustes de la instancia. Para obtener más información, consulta gcloud sql instances create.

Debes crear la réplica en la misma red de VPC que la instancia principal. También puedes especificar un allocated-ip-range-name en esa red de VPC. Si no se especifica ningún intervalo, la réplica se crea en un intervalo aleatorio.

Terraform

Para crear una réplica de lectura, usa un recurso de Terraform.

resource "google_sql_database_instance" "read_replica" {
  name                 = "sqlserver-replica-instance-name"
  master_instance_name = google_sql_database_instance.primary.name
  region               = "europe-west4"
  database_version     = "SQLSERVER_2019_ENTERPRISE"
  root_password        = "INSERT-PASSWORD-HERE"
  replica_configuration {
    failover_target = false
  }

  settings {
    tier              = "db-custom-2-7680"
    availability_type = "ZONAL"
    disk_size         = "100"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

REST v1beta4

Usa el método insert del recurso instances para crear la réplica de lectura. Las propiedades region y databaseVersion deben ser las mismas que las del elemento principal.

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

• project-id: el ID del proyecto
• database-version: cadena de versión de enum (por ejemplo, SQLSERVER_2017_ENTERPRISE)
• primary-instance-name: el nombre de la instancia principal
• primary-instance-region: la región de la instancia principal
• replica-region: la región de la instancia de réplica
• replica-name: nombre de la instancia de réplica
• machine-type: cadena enum del tipo de máquina. Por ejemplo: "db-custom-1-3840".

Puede usar el campo sqlNetworkArchitecture para forzar el uso de la nueva arquitectura de red en la instancia al crearla, aunque el proyecto no se haya actualizado por completo. Para obtener más información sobre la nueva arquitectura de red y sus implicaciones, consulta los artículos Actualizar una instancia a la nueva arquitectura de red y Asignar un intervalo de direcciones IP.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

Cuerpo JSON de la solicitud:

{
  "masterInstanceName": "primary-instance-name",
  "project": "project-id",
  "databaseVersion": "database-version",
  "name": "replica-name",
  "region": "replica-region",
  "settings":
  {
    "tier": "machine-type",
    "settingsVersion": 0,
    
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Para enviar tu solicitud, despliega una de estas opciones:

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-id/instances"

$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-id/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

gcloud

Para crear una réplica de lectura de una instancia, usa el comando gcloud sql instances create:

gcloud sql instances create REPLICA_INSTANCE_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip

Haz las siguientes sustituciones:

• REPLICA_INSTANCE_NAME: el nombre de la instancia de réplica.
• PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
• PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
• REGION_NAME: el nombre de la región de la instancia de réplica.

• ALLOWED_PROJECTS: lista de IDs o números de proyecto permitidos, separados por comas. Si un proyecto no está en esta lista, no puedes usarlo para crear una instancia y habilitar Private Service Connect en él.

  Cloud SQL no copia los proyectos permitidos de la instancia principal en la réplica. Debes crear un punto final de Private Service Connect para cada réplica. Si usas el proxy de autenticación de Cloud SQL o los conectores de lenguaje de Cloud SQL, crea una zona DNS y un registro DNS para las réplicas.

• AVAILABILITY_TYPE: habilita la alta disponibilidad en la instancia. En este parámetro, especifica uno de los siguientes valores:
  • REGIONAL: habilita la alta disponibilidad y se recomienda para las instancias de producción. La instancia se conmuta por error a otra zona de la región seleccionada.
  • ZONAL: no proporcionan ninguna función de conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y quitar la alta disponibilidad de las instancias, consulta los artículos Configurar una instancia para alta disponibilidad y Desactivar la alta disponibilidad de una instancia.

REST v1

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

• PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
• PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
• REPLICA_INSTANCE_NAME: el nombre de la instancia de réplica.
• REGION_NAME: el nombre de la región de la instancia de réplica.
• MACHINE_TYPE: el tipo de máquina de la instancia.
• AVAILABILITY_TYPE: habilita la alta disponibilidad en la instancia. En este parámetro, especifica uno de los siguientes valores:
  • REGIONAL: habilita la alta disponibilidad y se recomienda para las instancias de producción. La instancia se conmuta por error a otra zona de la región seleccionada.
  • ZONAL: no proporcionan ninguna función de conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y quitar la alta disponibilidad de las instancias, consulta los artículos Configurar una instancia para alta disponibilidad y Desactivar la alta disponibilidad de una instancia.

• ALLOWED_PROJECTS: lista de IDs o números de proyecto permitidos, separados por comas. Si un proyecto no está en esta lista, no puedes usarlo para crear una instancia y habilitar Private Service Connect en él.

  Cloud SQL no copia los proyectos permitidos de la instancia principal en la réplica. Debes crear un punto final de Private Service Connect para cada réplica. Si usas el proxy de autenticación de Cloud SQL o los conectores de lenguaje de Cloud SQL, debes crear una zona DNS y un registro DNS para las réplicas.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "SQLSERVER_2019_STANDARD",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

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_ID/instances"

$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_ID/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

• PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
• PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
• REPLICA_INSTANCE_NAME: el nombre de la instancia de réplica.
• REGION_NAME: el nombre de la región de la instancia de réplica.
• MACHINE_TYPE: el tipo de máquina de la instancia.
• AVAILABILITY_TYPE: habilita la alta disponibilidad en la instancia. En este parámetro, especifica uno de los siguientes valores:
  • REGIONAL: habilita la alta disponibilidad y se recomienda para las instancias de producción. La instancia se conmuta por error a otra zona de la región seleccionada.
  • ZONAL: no proporcionan ninguna función de conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y quitar la alta disponibilidad de las instancias, consulta los artículos Configurar una instancia para alta disponibilidad y Desactivar la alta disponibilidad de una instancia.

• ALLOWED_PROJECTS: lista de IDs o números de proyecto permitidos, separados por comas. Si un proyecto no está en esta lista, no puedes usarlo para crear una instancia y habilitar Private Service Connect en él.

  Cloud SQL no copia los proyectos permitidos de la instancia principal en la réplica. Debes crear un punto final de Private Service Connect para cada réplica. Si usas el proxy de autenticación de Cloud SQL o los conectores de lenguaje de Cloud SQL, debes crear una zona DNS y un registro DNS para las réplicas.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "SQLSERVER_2019_STANDARD",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],  
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

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_ID/instances"

$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_ID/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

gcloud

Crea la réplica especificando la instancia principal con la marca --master-instance-name y la marca --cascadable-replica:

gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME \
   --cascadable-replica \
   --region=REGION

Haz los cambios siguientes:

• REPLICA_NAME: el ID único de la réplica que estás creando.
• PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
• REGION: la región en la que quieres crear la nueva réplica. Esta región debe ser diferente de la de la instancia principal.

Debes crear la réplica en la misma red de VPC que la instancia principal. También puedes especificar un nombre de intervalo de IP asignado en esa red de VPC. Si no se especifica ningún intervalo, la réplica se crea en un intervalo aleatorio.

Puede añadir más parámetros para otros ajustes de la instancia. Por ejemplo,

• Puede especificar un tamaño de nivel de máquina diferente con el parámetro --tier.
• Si la instancia principal solo tiene una dirección IP privada, añade el parámetro --no-assign-ip al comando.

Para obtener más información sobre cómo añadir parámetros a la configuración de instancias, consulta gcloud sql instances create.

Una vez creada la réplica en cascada, puedes crear una réplica en cascada.

curl

1. Para crear una réplica en cascada en la instancia principal, edita el siguiente ejemplo de código JSON y guárdalo en un archivo llamado request.json.

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

   • PROJECT_ID: el ID del proyecto.
   • DATABASE_VERSION: cadena enum de la versión de la base de datos. Por ejemplo, SQLSERVER_2017_ENTERPRISE.
   • PRIMARY_INSTANCE_NAME: el nombre de la instancia principal.
   • PRIMARY_INSTANCE_REGION: la región de la instancia principal.
   • REPLICA_REGION: la región de la instancia de réplica.
   • REPLICA_NAME: el nombre de la instancia de réplica.
   • MACHINE_TYPE: cadena enum del tipo de máquina. Por ejemplo, db-custom-2-3840.

   {
     "masterInstanceName": "PRIMARY_INSTANCE_NAME",
     "project": "PROJECT_ID",
     "databaseVersion": "DATABASE_VERSION"
     "name": "REPLICA_NAME",
     "region": "REPLICA_REGION",
     "settings":
       {
         "tier": "MACHINE_TYPE",
         "settingsVersion": 0,
       }
       "replicaConfiguration":
       {
        "cascadableReplica": true
       }
   }

2. En la sección replicaConfiguration, comprueba que el campo cascadadableReplica esté configurado como true.
3. 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_ID/instances"

Una vez creada la réplica en cascada, puedes crear una réplica en cascada.

Terraform

Para crear una réplica en cascada, usa un recurso de Terraform.

En el siguiente ejemplo se crea una instancia principal y una réplica en cascada que puedes asignar como réplica de recuperación tras desastres cuando realices una conmutación como parte de la recuperación tras desastres avanzada.

resource "google_sql_database_instance" "original-primary" {
  name   = "sqlserver-primary-instance-name"
  region = "us-east1"
  # Specify a database version that supports Cloud SQL Enterprise Plus edition.
  database_version = "SQLSERVER_2022_ENTERPRISE"
  instance_type    = "CLOUD_SQL_INSTANCE"
  root_password    = "INSERT-PASSWORD-HERE"
  replica_names    = ["sqlserver-replica-instance-name"]
  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    backup_configuration {
      enabled = "true"
    }
  }
}

resource "google_sql_database_instance" "dr_replica" {
  name = "sqlserver-replica-instance-name"
  # Specify the original primary instance as the master instance.
  master_instance_name = google_sql_database_instance.original-primary.name
  # DR replica must be in a different region than the region of the primary instance.
  region = "us-west2"
  # DR replica must be the same database version as the primary instance.
  database_version = "SQLSERVER_2022_ENTERPRISE"
  instance_type    = "READ_REPLICA_INSTANCE"
  root_password    = "INSERT-PASSWORD-HERE"
  replica_configuration {
    # Make the replica a cascadable replica.
    cascadable_replica = true
  }

  settings {
    # DR replica must be in the same tier as your primary instance and support Enterprise Plus edition.
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
  }
}

Consola

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

   Ir a Instancias de Cloud SQL

2. Haz clic en la pestaña Réplicas de la réplica que actuará como elemento superior de la réplica que quieras crear.
3. Haz clic en Crear réplica.
4. En la página Crear réplica de lectura, actualice el ID de la instancia y cualquier otra opción de configuración, como el nombre, la región y la zona.
5. Haz clic en Crear.

   Cloud SQL crea una réplica. Se te redirigirá a la página de la instancia de la réplica principal.

6. Sigue los pasos del 4 al 6 para cada réplica en cascada que quieras crear.

gcloud

1. Crea la nueva réplica especificando la instancia de réplica en cascada en la marca --master-instance-name:

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=CASCADABLE_REPLICA_NAME \

Sustituye lo siguiente:

• REPLICA_NAME: ID único de la réplica que estás creando.
• CASCADABLE_REPLICA_NAME: el nombre de la réplica en cascada
2. Después de crear la réplica en cascada, verás que los cambios que se hagan en la instancia principal se replican en todas las réplicas de la cadena de réplicas en cascada.

curl

1. Para crear una réplica en cascada en la réplica que se puede poner en cascada, edita el siguiente ejemplo de código JSON y guárdalo en un archivo llamado request.json:

   {
     "masterInstanceName": "CASCADABLE_REPLICA_NAME",
     "project": "PROJECT_ID",
     "name": "REPLICA_NAME",
     "region": "REPLICA_REGION",
     "settings":
       {
         "tier": "MACHINE_TYPE",
       }
   }

2. 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_ID/instances"