Esta página se ha traducido con Cloud Translation API.

Usar la recuperación a un momento dado (PITR)

MySQL | PostgreSQL | SQL Server

En esta página se describe cómo usar la recuperación a un momento dado (PITR) para restaurar tu instancia principal de Cloud SQL.

Para obtener más información sobre la PITR, consulta el artículo Recuperación a un momento dado (PITR).

Si creas una instancia de la edición Enterprise Plus de Cloud SQL, PITR se habilita de forma predeterminada, independientemente del método que utilices para crearla. Si quieres inhabilitar la función, debes hacerlo manualmente.

Si creas una instancia de la edición Enterprise de Cloud SQL en la Google Cloud consola, la recuperación a un momento dado estará habilitada de forma predeterminada. De lo contrario, si creas la instancia con la interfaz de línea de comandos de gcloud, Terraform o la API Cloud SQL Admin, la restauración a un momento dado estará inhabilitada de forma predeterminada. En este caso, si quieres habilitar la función, debes hacerlo manualmente.

Almacenamiento de registros para PITR

Cloud SQL usa el archivado de registros de escritura anticipada (WAL) para la recuperación a un momento dado.

El 9 de enero del 2023, lanzamos el almacenamiento de registros de escritura anticipada para PITR en Cloud Storage. Desde ese lanzamiento, se aplican las siguientes condiciones:

Todas las instancias de la edición Enterprise Plus de Cloud SQL almacenan sus registros write-ahead en Cloud Storage. Solo las instancias de la edición Cloud SQL Enterprise Plus que actualices desde la edición Cloud SQL Enterprise y que tengan habilitada la recuperación a un momento dado antes del 9 de enero del 2023 seguirán almacenando sus registros en el disco.
Las instancias de la edición Enterprise de Cloud SQL creadas con PITR habilitado antes del 9 de enero del 2023 siguen almacenando sus registros en el disco.
Si actualizas a la edición Enterprise Plus de Cloud SQL una instancia de la edición Enterprise de Cloud SQL después del 15 de agosto del 2024 que almacena registros de transacciones para la recuperación a un momento dado (PITR) en el disco, el proceso de actualización cambiará la ubicación de almacenamiento de los registros de transacciones utilizados para la PITR a Cloud Storage. Para obtener más información, consulta el artículo Actualizar una instancia a la edición Enterprise Plus de Cloud SQL mediante una actualización in situ.
Todas las instancias de la edición Enterprise de Cloud SQL que crees con PITR habilitado después del 9 de enero del 2023 almacenan registros en Cloud Storage.

En las instancias que almacenan los registros de escritura anticipada solo en el disco, puedes cambiar la ubicación de almacenamiento de los registros de transacciones utilizados para la recuperación a un momento dado del disco a Cloud Storage mediante la CLI de gcloud o la API Admin de Cloud SQL sin incurrir en ningún tiempo de inactividad. Para obtener más información, consulta Cambiar el almacenamiento de los registros de transacciones a Cloud Storage.

Periodo de conservación de los registros

Para ver si una instancia almacena los registros usados para PITR en Cloud Storage, consulta Comprobar la ubicación de almacenamiento de los registros de transacciones usados para PITR.

Después de usar un cliente de PostgreSQL, como psql o pgAdmin, para conectarte a una base de datos de la instancia, ejecuta el siguiente comando: show archive_command. Si se archivan registros write-ahead en Cloud Storage, verás el mensaje -async_archive -remote_storage.

El resto de las instancias que tengan habilitada la restauración a un momento dado seguirán teniendo sus registros almacenados en el disco.

Si los registros se almacenan en Cloud Storage, Cloud SQL los sube cada cinco minutos o menos. Por lo tanto, si una instancia de Cloud SQL está disponible, se puede recuperar hasta el momento más reciente. Sin embargo, si la instancia no está disponible, el objetivo de punto de recuperación suele ser de cinco minutos o menos. Usa la CLI de gcloud o la API Admin para comprobar la hora más reciente a la que puedes restaurar la instancia y realizar la recuperación a esa hora.

Los registros de escritura anticipada que se usan con la recuperación a un momento dado se eliminan automáticamente junto con su copia de seguridad automática asociada, lo que suele ocurrir cuando se alcanza el valor definido en transactionLogRetentionDays. Es el número de días de registros de transacciones que Cloud SQL conserva para la recuperación a un momento dado. En la edición Cloud SQL Enterprise Plus, puedes definir un valor entre 1 y 35, y en la edición Cloud SQL Enterprise, puedes definir un valor entre 1 y 7.

Si restauras una copia de seguridad en una instancia de Cloud SQL antes de habilitar PITR, perderás los registros de escritura previa que permiten que PITR funcione.

En las instancias con claves de cifrado gestionadas por el cliente (CMEK), los registros de escritura anticipada se cifran con la versión más reciente de la CMEK. Para realizar una restauración, deben estar disponibles todas las versiones de la clave que hayan sido las más recientes durante el número de días que hayas configurado en el parámetro retained-transaction-log-days.

En las instancias que tienen registros write-ahead almacenados en Cloud Storage, los registros se almacenan en la misma región que la instancia principal. Este almacenamiento de registros (hasta 35 días en la edición Cloud SQL Enterprise Plus y siete días en la edición Cloud SQL Enterprise, que es la duración máxima de la recuperación a un momento dado) no genera ningún coste adicional por instancia.

Registros y uso del disco

Si tu instancia tiene habilitado PITR y el tamaño de los registros de escritura anticipada en el disco está causando un problema en tu instancia, haz lo siguiente:

Puedes cambiar la ubicación de almacenamiento de los registros utilizados para PITR del disco a Cloud Storage sin tiempo de inactividad mediante la CLI de gcloud o la API de administración de Cloud SQL.
Puedes actualizar tu instancia a la edición Enterprise Plus de Cloud SQL.
Puedes aumentar el tamaño del almacenamiento de la instancia, pero el aumento del tamaño del registro de escritura anticipada en el uso del disco puede ser temporal.
Le recomendamos que habilite el aumento automático del almacenamiento para evitar problemas inesperados con el almacenamiento. Esta recomendación solo se aplica si tu instancia tiene habilitada la recuperación a un momento dado y tus registros se almacenan en el disco.
Puedes desactivar PITR si quieres eliminar registros y recuperar espacio de almacenamiento. Disminuir los registros write-ahead usados no reduce el tamaño del disco aprovisionado para la instancia.
Los registros se purgan una vez al día, no de forma continua. Si se establece la retención de registros en dos días, se conservarán al menos dos días de registros y, como máximo, tres. Te recomendamos que definas el número de copias de seguridad como uno más que los días de conservación de registros.

Por ejemplo, si especifica 7 como valor del parámetro transactionLogRetentionDays, en el parámetro backupRetentionSettings, defina el número de retainedBackups en 8.

Habilitar PITR

Cuando creas una instancia en la consola Google Cloud , las opciones Copias de seguridad automatizadas y Habilitar recuperación a un momento dado se habilitan automáticamente.

El siguiente procedimiento habilita PITR en una instancia principal ya creada.

Consola

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

Ir a Instancias de Cloud SQL
Abre el menú de más acciones de la instancia en la que quieras habilitar PITR y haz clic en Editar.
En Personalizar tu instancia, amplía la sección Protección de datos.
Selecciona la casilla Habilitar recuperación a un momento dado.
En el campo Días de registros, introduce el número de días que quieres conservar los registros (de 1 a 35 en la edición Enterprise Plus de Cloud SQL o de 1 a 7 en la edición Enterprise de Cloud SQL).
Haz clic en Guardar.

gcloud

Muestra la vista general de la instancia:

gcloud sql instances describe INSTANCE_NAME

Si ves enabled: false en la sección backupConfiguration, habilita las copias de seguridad programadas:
```
gcloud sql instances patch INSTANCE_NAME \
--backup-start-time=HH:MM
```
Especifica el parámetro backup-start-time con el formato de 24 horas en la zona horaria UTC±00.
Habilita PITR:
```
gcloud sql instances patch INSTANCE_NAME \
--enable-point-in-time-recovery
```
Si habilitas PITR en una instancia principal, también puedes configurar el número de días durante los que quieres conservar los registros de transacciones añadiendo el siguiente parámetro:
```
--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS
```
Confirma tu cambio:
```
gcloud sql instances describe INSTANCE_NAME
```
En la sección backupConfiguration, verás pointInTimeRecoveryEnabled: true si el cambio se ha realizado correctamente.

Terraform

Para habilitar PITR, usa un recurso de Terraform.

resource "google_sql_database_instance" "postgres_instance_pitr" {
  name             = ""
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
      transaction_log_retention_days = "3"
    }
  }
  # 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
}

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

Abre Cloud Shell.
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).

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
```
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.
Revisa y modifica los parámetros de ejemplo para aplicarlos a tu entorno.
Guarda los cambios.
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

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.
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!".
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:

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"
```
Aplica la configuración de Terraform actualizada ejecutando el siguiente comando e introduciendo yes en la petición:
```
terraform apply
```

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

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

PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia
INSTANCE_NAME: el nombre de la instancia principal o de réplica de lectura que estás configurando para la alta disponibilidad
START_TIME: la hora (en horas y minutos)

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

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

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "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:

PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia
INSTANCE_NAME: el nombre de la instancia principal o de réplica de lectura que estás configurando para la alta disponibilidad
START_TIME: la hora (en horas y minutos)

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

Para enviar tu solicitud, despliega 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_ID/instances/INSTANCE_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_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

Respuesta

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

Realizar PITR en una instancia no disponible

Consola

Puede que quieras recuperar una instancia que no esté disponible en otra zona por los siguientes motivos:

No se puede acceder a la zona en la que está configurada la instancia. Esta instancia tiene el estado FAILED.
Se está realizando el mantenimiento de la instancia. Esta instancia tiene el estado MAINTENANCE.

Para recuperar una instancia no disponible, sigue estos pasos:

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

Ir a Instancias de Cloud SQL
Busca la fila de la instancia que quieras clonar.
En la columna Acciones, haz clic en el menú Más acciones.
Haz clic en Crear clon.
En la página Crear una clonación, haz lo siguiente:
1. En el campo ID de instancia, actualice el ID de instancia si es necesario.
2. Haz clic en Clonar desde un momento anterior.
3. En el campo Punto en el tiempo, selecciona la fecha y la hora a partir de las que quieras clonar los datos. De esta forma, se recupera el estado de la instancia a partir de ese momento.
4. Haz clic en Crear clon.

Mientras se inicializa el clon, se te redirige a la página de la lista de instancias.

gcloud

Puede que quieras recuperar una instancia que no esté disponible en otra zona porque no se puede acceder a la zona en la que está configurada la instancia.

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--point-in-time DATE_AND_TIME_STAMP \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

El usuario o la cuenta de servicio que ejecute el comando gcloud sql instances clone debe tener el permiso cloudsql.instances.clone. Para obtener más información sobre los permisos necesarios para ejecutar comandos de gcloud CLI, consulta Permisos de Cloud SQL.

REST v1

Puede que quieras recuperar una instancia que no esté disponible en otra zona porque no se puede acceder a la zona en la que está configurada.

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

PROJECT_ID: el ID del proyecto.
SOURCE_INSTANCE_NAME: el nombre de la instancia de la fuente.
TARGET_INSTANCE_NAME: el nombre de la instancia de destino (clonada).
DATE_AND_TIME_STAMP: marca de fecha y hora de la instancia de origen en la zona horaria UTC y en el formato RFC 3339 (por ejemplo,
2012-11-15T16:19:00.094Z).
ZONE_NAME: opcional. Nombre de la zona principal de la instancia de destino. Se usa para especificar una zona principal diferente para la instancia de Cloud SQL que quieras clonar. En el caso de una instancia regional, esta zona sustituye a la zona principal, pero la zona secundaria sigue siendo la misma que la de la instancia.
SECONDARY_ZONE_NAME: opcional. Nombre de la zona secundaria de la instancia de destino. Se usa para especificar una zona secundaria diferente para la instancia regional de Cloud SQL que quieras clonar.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Para enviar tu solicitud, despliega 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/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

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/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

El usuario o la cuenta de servicio que use el método de la API instances.clone debe tener el permiso cloudsql.instances.clone. Para obtener más información sobre los permisos necesarios para usar los métodos de la API, consulta Permisos de Cloud SQL.

REST v1beta4

Puede que quieras recuperar una instancia que no esté disponible en otra zona porque no se puede acceder a la zona en la que está configurada.

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

PROJECT_ID: el ID del proyecto.
SOURCE_INSTANCE_NAME: el nombre de la instancia de la fuente.
TARGET_INSTANCE_NAME: el nombre de la instancia de destino (clonada).
DATE_AND_TIME_STAMP: marca de fecha y hora de la instancia de origen en la zona horaria UTC y en el formato RFC 3339 (por ejemplo,
2012-11-15T16:19:00.094Z).
ZONE_NAME: opcional. Nombre de la zona principal de la instancia de destino. Se usa para especificar una zona principal diferente para la instancia de Cloud SQL que quieras clonar. En el caso de una instancia regional, esta zona sustituye a la zona principal, pero la zona secundaria sigue siendo la misma que la de la instancia.
SECONDARY_ZONE_NAME: opcional. Nombre de la zona secundaria de la instancia de destino. Se usa para especificar una zona secundaria diferente para la instancia regional de Cloud SQL que quieras clonar.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

Cuerpo JSON de la solicitud:

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Para enviar tu solicitud, despliega 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_ID/instances/SOURCE_INSTANCE_NAME/clone"

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

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

Si intentas crear un clon de PITR en un momento posterior a la última hora recuperable, se mostrará el siguiente mensaje de error:

The timestamp for point-in-time recovery is after the latest recovery time of
Timestamp of latest recovery time. Clone the instance with a time
that's earlier than this recovery time.

Obtener el tiempo de recuperación más reciente

En una instancia disponible, puedes realizar PITR hasta la hora más reciente. Si la instancia no está disponible y los registros de la instancia se almacenan en Cloud Storage, puedes obtener la hora de recuperación más reciente y realizar la restauración a un momento dado hasta esa hora. En ambos casos, puede restaurar la instancia en otra zona principal o secundaria proporcionando valores para las zonas preferidas.

gcloud

Obtén la hora más reciente a la que puedes recuperar una instancia de Cloud SQL que no está disponible.

Sustituye INSTANCE_NAME por el nombre de la instancia que estás consultando.

gcloud sql instances get-latest-recovery-time INSTANCE_NAME

REST v1

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

PROJECT_ID: el ID del proyecto
INSTANCE_NAME: el nombre de la instancia de la que quieres consultar la hora de recuperación más reciente

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

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

PowerShell (Windows)

Ejecuta el comando siguiente:

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

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

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

{
  "kind": "sql#getLatestRecoveryTime",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

REST v1beta4

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

PROJECT_ID: el ID del proyecto
INSTANCE_NAME: el nombre de la instancia de la que quieres consultar la hora de recuperación más reciente

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

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

PowerShell (Windows)

Ejecuta el comando siguiente:

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

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

{
  "kind": "sql#getLatestRecoveryTime",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

Realizar una restauración a un momento dado

Consola

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

Ir a Instancias de Cloud SQL
Abre el menú de más acciones de la instancia que quieras recuperar y haz clic en Crear clon.
Opcionalmente, en la página Crear un clon, actualiza el ID del nuevo clon.
Selecciona Clonar desde un momento anterior.
Introduce una hora de PITR.
Haz clic en Crear clon.

gcloud

Crea un clon mediante PITR.

Haz los cambios siguientes:

SOURCE_INSTANCE_NAME: nombre de la instancia desde la que vas a restaurar.
NEW_INSTANCE_NAME: nombre del clon.
TIMESTAMP: zona horaria UTC de la instancia de origen en formato RFC 3339. Por ejemplo, 2012-11-15T16:19:00.094Z.

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time 'TIMESTAMP'

REST v1

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

project-id: el ID del proyecto
target-instance-id: ID de la instancia de destino
source-instance-id: ID de la instancia de origen.
restore-timestamp El momento dado hasta el que se debe restaurar

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

Cuerpo JSON de la solicitud:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

Para enviar tu solicitud, despliega 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/v1/projects/project-id/instances/source-instance-id/clone"

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/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "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:

project-id: el ID del proyecto
target-instance-id: ID de la instancia de destino
source-instance-id: ID de la instancia de origen.
restore-timestamp El momento dado hasta el que se debe restaurar

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

Para enviar tu solicitud, despliega 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-id/instances/source-instance-id/clone"

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

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

Respuesta

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

Realizar una PITR con el almacén de copias de seguridad

Vista previa — Enhanced backups

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Puedes tratar datos personales para esta función tal como se indica en la Adenda sobre Tratamiento de Datos de Cloud, de acuerdo con las obligaciones y restricciones descritas en el contrato en virtud del cual accedes a Google Cloud. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Si tu instancia de Cloud SQL tiene habilitadas las copias de seguridad mejoradas, puedes realizar una recuperación a un momento dado de tu instancia mediante el archivo de copias de seguridad.

Consola

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

Ir a Instancias de Cloud SQL
Abre el menú de más acciones de la instancia que quieras recuperar y haz clic en Crear clon.
Selecciona Clonar desde un momento anterior.
Introduce una hora de PITR.
Haz clic en Crear clon.

gcloud

Para realizar una recuperación a un momento dado en una instancia desde el almacén de copias de seguridad, tendrás que buscar el data-source de la copia de seguridad más cercana a la hora en la que quieras realizar la recuperación. Para encontrar la copia de seguridad, consulta Lista de todas las copias de seguridad del almacén de copias de seguridad de una instancia. Una vez que hayas identificado la copia de seguridad, ejecuta el siguiente comando para realizar la restauración a un momento dado:

gcloud sql instances point-in-time-restore DATA_SOURCE
PITR_TIMESTAMP
--project=TARGET_PROJECT

Haz los cambios siguientes:

DATA_SOURCE: ruta del data-source de la copia de seguridad más cercana a la marca de tiempo de PITR que quieras recuperar.
PITR_TIMESTAMP: marca de tiempo UTC del registro PITR de la instancia de origen a la que quieres restaurar tu instancia, en formato RFC 3339. Por ejemplo, 2012-11-15T16:19:00.094Z.
TARGET_PROJECT: el ID de proyecto de tu instancia de Cloud SQL.

REST v1

REST v1beta4

Desactivar PITR

Consola

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

Ir a Instancias de Cloud SQL
Abre el menú de más acciones de la instancia que quieras desactivar y selecciona Editar.
En Personalizar tu instancia, amplía la sección Protección de datos.
Desmarca Habilitar recuperación a un momento dado.
Haz clic en Guardar.

gcloud

Desactiva la recuperación a un momento dado:

gcloud sql instances patch INSTANCE_NAME \
--no-enable-point-in-time-recovery

Confirma tu cambio:
```
gcloud sql instances describe INSTANCE_NAME
```
En la sección backupConfiguration, verás pointInTimeRecoveryEnabled: false si el cambio se ha realizado correctamente.

REST v1

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

project-id: el ID del proyecto
instance-id: el ID de instancia.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

Para enviar tu solicitud, despliega 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-id/instances/instance-id"

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

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "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:

project-id: el ID del proyecto
instance-id: el ID de instancia.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

Para enviar tu solicitud, despliega 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-id/instances/instance-id"

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

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

Respuesta

{
  "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": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Comprobar la ubicación de almacenamiento de los registros de transacciones usados para PITR

Puedes comprobar dónde almacena tu instancia de Cloud SQL los registros de transacciones que se usan para la recuperación a un momento dado.

gcloud

Para determinar si tu instancia almacena registros de PITR en el disco o en Cloud Storage, usa el siguiente comando:

   gcloud sql instances describe INSTANCE_NAME

Sustituye INSTANCE_NAME por el nombre de la instancia.

Si hay varias instancias en el mismo proyecto, también puedes consultar la ubicación de almacenamiento de los registros de transacciones. Para determinar la ubicación de varias instancias, usa el siguiente comando:

   gcloud sql instances list --show-transactional-log-storage-state

Respuesta de ejemplo:

NAME  DATABASE_VERSION LOCATION         TRANSACTIONAL_LOG_STORAGE_STATE
my_01 POSTGRES_12      us-central-1     DISK
my_02 POSTGRES_12      us-central-1     CLOUD_STORAGE
...

En el resultado del comando, el campo transactionalLogStorageState o la columna TRANSACTIONAL_LOG_STORAGE_STATE proporcionan información sobre dónde se almacenan los registros de transacciones de PITR de la instancia. Los posibles estados de almacenamiento del registro de transacciones son los siguientes:

DISK: la instancia almacena los registros de transacciones que se usan para la recuperación a un momento dado en el disco. Si actualizas una instancia de la edición Enterprise de Cloud SQL a la edición Enterprise Plus, el proceso de actualización cambiará automáticamente la ubicación del almacenamiento de registros a Cloud Storage. Para obtener más información, consulta el artículo Actualizar una instancia a la edición Enterprise Plus de Cloud SQL mediante una actualización in situ. También puedes cambiar la ubicación de almacenamiento con la interfaz de línea de comandos gcloud o la API Cloud SQL Admin sin actualizar la edición de tu instancia y sin que se produzca ningún tiempo de inactividad. Para obtener más información, consulta Cambiar el almacenamiento de los registros de transacciones a Cloud Storage.
SWITCHING_TO_CLOUD_STORAGE: la instancia está cambiando la ubicación de almacenamiento de los registros de transacciones de PITR a Cloud Storage.
SWITCHED_TO_CLOUD_STORAGE: la instancia ha completado el cambio de la ubicación de almacenamiento de los registros de transacciones de PITR del disco a Cloud Storage.
CLOUD_STORAGE: la instancia almacena los registros de transacciones que se usan para PITR en Cloud Storage.

Cambiar el almacenamiento de los registros de transacciones a Cloud Storage

Si tu instancia almacena en disco los registros de transacciones que se usan para la recuperación a un momento dado, puedes cambiar la ubicación de almacenamiento a Cloud Storage sin que se produzca ningún tiempo de inactividad. El proceso general de cambio de la ubicación de almacenamiento tarda aproximadamente lo que dure el periodo de conservación del registro de transacciones (en días) en completarse. En cuanto inicies el cambio, los registros de transacciones empezarán a acumularse en Cloud Storage. Durante la operación, puedes comprobar el estado general del proceso mediante el comando que se indica en Comprobar la ubicación de almacenamiento de los registros de transacciones usados para PITR.

Una vez que se haya completado el proceso general de cambio a Cloud Storage, Cloud SQL usará los registros de transacciones de Cloud Storage para la recuperación a un momento dado.

gcloud

Para cambiar la ubicación de almacenamiento a Cloud Storage, usa el siguiente comando:

   gcloud sql instances patch INSTANCE_NAME \
      --switch-transaction-logs-to-cloud-storage

Sustituye INSTANCE_NAME por el nombre de la instancia. La instancia debe ser una instancia principal y no una instancia de réplica. La respuesta es similar a la siguiente:

The following message is used for the patch API method.
{"name": "INSTANCE_NAME", "project": "PROJECT_NAME", "switchTransactionalLogsToCloudStorageEnabled": "true"}

Patching Cloud SQL instance...done.
Updated
[https://sqladmin.prod.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME].

Si el comando devuelve un error, consulta la sección Solucionar problemas al cambiar a Cloud Storage para ver los posibles pasos siguientes.

REST v1

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

PROJECT_ID: el ID del proyecto.
INSTANCE_ID: el ID de instancia. La instancia debe ser una instancia principal y no una instancia réplica.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

Para enviar tu solicitud, despliega 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_ID/instances/INSTANCE_ID"

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

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Si la solicitud devuelve un error, consulta Solucionar problemas al cambiar a Cloud Storage para ver los posibles pasos siguientes.

REST v1beta4

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

PROJECT_ID: el ID del proyecto.
INSTANCE_ID: el ID de instancia. La instancia debe ser una instancia principal y no una instancia réplica.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

Para enviar tu solicitud, despliega 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_ID/instances/INSTANCE_ID"

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

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Si la solicitud devuelve un error, consulta Solucionar problemas al cambiar a Cloud Storage para ver los posibles pasos siguientes.

Definir la retención de registros de transacciones

Para definir el número de días que se conservarán los registros write-ahead, sigue estos pasos:

Consola

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

Ir a Instancias de Cloud SQL
Abre el menú de más acciones de la instancia en la que quieras activar el registro de transacciones y selecciona Editar.
En Personalizar tu instancia, amplía la sección Protección de datos.
En la sección Habilitar recuperación a un momento dado, despliega Opciones avanzadas.
Introduce el número de días que quieres conservar los registros (entre 1 y 35 para la edición Enterprise Plus de Cloud SQL, o entre 1 y 7 para la edición Enterprise de Cloud SQL).
Haz clic en Guardar.

gcloud

Edita la instancia para definir el número de días que se conservarán los registros write-ahead.

Haz los cambios siguientes:

INSTANCE_NAME: el nombre de la instancia en la que quieras definir el registro de transacciones.
DAYS_TO_RETAIN: número de días que se conservarán los registros de transacciones. En la edición Enterprise Plus de Cloud SQL, el intervalo válido es de entre 1 y 35 días, con un valor predeterminado de 14 días. En la edición Enterprise de Cloud SQL, el intervalo válido es de 1 a 7 días, con un valor predeterminado de 7 días.

Si no especifica ningún valor, Cloud SQL usará el valor predeterminado. Esto solo es válido cuando se habilita la recuperación a un momento dado. Para conservar los registros de transacciones durante más días, se necesita un mayor tamaño de almacenamiento.

  gcloud sql instances patch INSTANCE_NAME 

    --retained-transaction-log-days=DAYS_TO_RETAIN

REST v1

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

PROJECT_ID: el ID del proyecto.
INSTANCE_ID: el ID de instancia.
DAYS_TO_RETAIN: número de días que se conservarán los registros de transacciones. En la edición Enterprise Plus de Cloud SQL, el intervalo válido es de entre 1 y 35 días, con un valor predeterminado de 14 días. En la edición Enterprise de Cloud SQL, el intervalo válido es de 1 a 7 días, con un valor predeterminado de 7 días.

Si no se especifica ningún valor, se usa el valor predeterminado. Esto solo es válido cuando se habilita la recuperación a un momento dado. Para conservar los registros de transacciones durante más días, se necesita más espacio de almacenamiento.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

Para enviar tu solicitud, despliega 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_ID/instances/INSTANCE_ID"

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

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

Respuesta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "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:

PROJECT_ID: el ID del proyecto.
INSTANCE_ID: el ID de instancia.
DAYS_TO_RETAIN: número de días que se conservarán los registros de transacciones. En la edición Enterprise Plus de Cloud SQL, el intervalo válido es de entre 1 y 35 días, con un valor predeterminado de 14 días. En la edición Enterprise de Cloud SQL, el intervalo válido es de 1 a 7 días, con un valor predeterminado de 7 días.

Si no se especifica ningún valor, se usa el valor predeterminado. Esto solo es válido cuando se habilita la recuperación a un momento dado. Para conservar los registros de transacciones durante más días, se necesita más espacio de almacenamiento.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

Para enviar tu solicitud, despliega 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_ID/instances/INSTANCE_ID"

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

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

Respuesta

{
  "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": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Solucionar problemas

Problema Solución de problemas

Problema	Solución de problemas
`argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z` O `Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,`	La marca de tiempo que has proporcionado no es válida.
`HTTP Error 400: Successful backup required for carrying out the operation was not found.` O `Successful backup required for carrying out the operation was not found. or Time where no backups can be found.`	La marca de tiempo que has proporcionado corresponde a un momento en el que no se han podido encontrar copias de seguridad ni coordenadas de binlog.

argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z

Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,

La marca de tiempo que has proporcionado no es válida.

HTTP Error 400: Successful backup required for carrying out the operation was not found.

Successful backup required for carrying out the operation was not found. or Time where no backups can be found.

La marca de tiempo que has proporcionado corresponde a un momento en el que no se han podido encontrar copias de seguridad ni coordenadas de binlog.

Solucionar problemas al cambiar a Cloud Storage

En la siguiente tabla se enumeran los posibles errores que pueden devolverse con el código INVALID REQUEST al cambiar la ubicación de almacenamiento de los registros de transacciones del disco a Cloud Storage.

Problema	Solución de problemas
`Switching the storage location of the transaction logs used for PITR is not supported for instances with database type %s.`	Asegúrate de ejecutar el comando gcloud CLI o de hacer la solicitud de API en una instancia de Cloud SQL para MySQL o Cloud SQL para PostgreSQL. No se puede cambiar la ubicación de almacenamiento de los registros de transacciones mediante la CLI de gcloud o la API Cloud SQL Admin en Cloud SQL para SQL Server.
`PostgreSQL transactional logging is not enabled on this instance.`	PostgreSQL usa el registro de escritura previa como registros de transacciones para la recuperación a un momento dado (PITR). Para admitir PITR, PostgreSQL requiere que habilites el almacenamiento de registros de escritura previa en la instancia. Para obtener más información sobre cómo habilitar el registro anticipado de escritura, consulta Habilitar PITR.
`This instance is already storing transaction logs used for PITR in Cloud Storage`	Para verificar la ubicación de almacenamiento de los registros de transacciones, ejecuta el comando que se indica en Comprobar la ubicación de almacenamiento de los registros de transacciones utilizados para PITR.
`The instance is already switching transaction logs used for PITR from disk to Cloud Storage.`	Espera a que se complete la operación de cambio. Para verificar el estado de la operación y la ubicación de almacenamiento de los registros de transacciones, ejecuta el comando que se indica en Comprobar la ubicación de almacenamiento de los registros de transacciones utilizados para la recuperación a un momento dado.

Siguientes pasos

Configurar las marcas en tu clon

Usar la recuperación a un momento dado (PITR) Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Almacenamiento de registros para PITR

Periodo de conservación de los registros

Registros y uso del disco

Habilitar PITR

Consola

gcloud

Terraform

Aplica los cambios

Preparar Cloud Shell

Preparar el directorio

Aplica los cambios

Eliminar los cambios

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Realizar PITR en una instancia no disponible

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Obtener el tiempo de recuperación más reciente

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Realizar una restauración a un momento dado

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Realizar una PITR con el almacén de copias de seguridad

Consola

gcloud

REST v1

REST v1beta4

Desactivar PITR

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Comprobar la ubicación de almacenamiento de los registros de transacciones usados para PITR

gcloud

Cambiar el almacenamiento de los registros de transacciones a Cloud Storage

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Definir la retención de registros de transacciones

Usar la recuperación a un momento dado (PITR)