Actualiza una instancia a la edición Cloud SQL Enterprise Plus mediante listas de IP permitidas


En esta página, se muestra cómo usar el método de conectividad de red de lista de entidades permitidas de Database Migration Service para actualizar una instancia de Cloud SQL Enterprise a la edición Cloud SQL Enterprise Plus. Database Migration Service crea una nueva instancia de Cloud SQL y migra datos a esa instancia.

Descripción general

Cloud SQL Enterprise Plus es ideal para aplicaciones que requieren rendimiento máximo de escritura. Para obtener más información sobre estas mejoras, consulta la sección sobre mejoras de rendimiento.

Para habilitar estas mejoras en las instancias existentes de la edición de Cloud SQL Enterprise, debes actualizarlas a la edición de Cloud SQL Enterprise Plus mediante Database Migration Service.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  6. Habilita la API de Database Migration Service.

    Habilitación de la API

  7. Asegúrate de tener asignada el rol de administrador de Database Migration a tu cuenta de usuario.

    Ir a IAM

Requisitos

Database Migration Service ofrece varias opciones de bases de datos de origen y métodos de conectividad de red. Las diferentes fuentes funcionan mejor con algunos métodos de conectividad que con otras. En esta página, suponemos que usas una instancia de edición de Cloud SQL Enterprise en un entorno en el que puedes configurar tu red para agregar una regla de firewall entrante. Debido a que no podemos conocer los detalles específicos de tu entorno, no podemos proporcionar pasos detallados cuando se trata de tu configuración de red.

Configura tu instancia de origen

Para configurar tu instancia de origen de Cloud SQL Enterprise, completa los siguientes pasos:

  1. Si no tienes la base de datos postgres para tu instancia de origen, crea una. Para obtener más información, consulta Crea una base de datos en la instancia de Cloud SQL.
  2. Instala el paquete pglogical en las bases de datos de tu instancia de origen. Asegúrate de que el paquete esté incluido en la variable shared_preload_libraries. Para obtener más información, consulta Configura tus bases de datos de origen.
  3. Habilita la replicación lógica y la decodificación para las bases de datos de tu instancia de origen. Si deseas obtener más información, consulta Habilita la replicación y decodificación lógicas para tus bases de datos de origen.

Configura tus bases de datos de origen

Además de las bases de datos template0 y template1, Database Migration Service migra todas las demás bases de datos en tu instancia de origen de Cloud SQL Enterprise.

En cada base de datos de tu instancia de origen que no se mencionó antes, completa los siguientes pasos:

  1. Para instalar la extensión pglogical en la base de datos, ejecuta el comando CREATE EXTENSION IF NOT EXISTS pglogical.

  2. Para cualquier tabla que no tenga claves primarias, migra las declaraciones UPDATE y DELETE de forma manual.

  3. Para establecer estos privilegios en cada una de las bases de datos migradas, crea un usuario o establece los privilegios de un usuario existente. Debes usar este usuario para conectarte a la instancia de origen y configurarlo como el usuario en la página Perfiles de conexión. Este usuario debe tener ciertos privilegios en cada una de las bases de datos migradas, así como en la base de datos postgres predeterminada.

    Para configurar estos privilegios, conéctate a la instancia y ejecuta los siguientes comandos:

    1. GRANT USAGE on SCHEMA SCHEMA to USER en todos los esquemas (aparte del esquema de información y los esquemas que comienzan con pg_) de cada base de datos que desees migrar.
    2. GRANT USAGE on SCHEMA pglogical to PUBLIC; en cada base de datos que deseas migrar.
    3. GRANT SELECT on ALL TABLES in SCHEMA pglogical to USER en todas las bases de datos para obtener información de replicación de las bases de datos de origen.
    4. GRANT SELECT on ALL TABLES in SCHEMA SCHEMA to USER en todos los esquemas (aparte del esquema de información y los esquemas que comienzan con pg_) de cada base de datos que desees migrar.
    5. GRANT SELECT on ALL SEQUENCES in SCHEMA SCHEMA to USER en todos los esquemas (aparte del esquema de información y los esquemas que comienzan con pg_) de cada base de datos que desees migrar.
    6. ALTER USER USER with REPLICATION role

Habilita la replicación lógica y la decodificación para tus bases de datos de origen

Habilita la replicación lógica y la decodificación para las bases de datos de tu instancia de edición de Cloud SQL Enterprise de origen mediante la configuración de las marcas cloudsql.logical_decoding y cloudsql.enable_pglogical en On. Para obtener más información sobre las marcas, consulta Configura marcas de base de datos.

Para habilitar ambas marcas, completa los siguientes pasos:

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

    Ir a Instancias de Cloud SQL

  2. Haz clic en tu instancia de origen.
  3. Haga clic en Editar.
  4. En la sección Personaliza tu instancia, si aparece el menú Mostrar opciones de configuración, haz clic en él.
  5. Expande la sección Marcas.

  6. Para configurar las marcas cloudsql.logical_decoding y cloudsql.enable_pglogical, completa los siguientes pasos:

    1. Haz clic en Agregar una marca de base de datos.
    2. En el menú desplegable, elige la marca cloudsql.logical_decoding.
    3. Establece el valor de esta marca en On.
    4. Haz clic en Listo.
    5. Repite estos pasos para la marca cloudsql.enable_pglogical.
  7. Haz clic en Guardar.

  8. En el cuadro de diálogo Los cambios requieren reinicio, haz clic en Guardar y reiniciar. Cloud SQL reinicia la instancia de origen para que se apliquen los cambios de configuración que realizaste en las marcas.

  9. En el panel Configuración, confirma los cambios en la sección Marcas de base de datos.

Crear perfiles de conexión

Un perfil de conexión contiene información sobre la base de datos de origen de Cloud SQL Enterprise. Database Migration Service usa la información del perfil de conexión para migrar datos de tu base de datos de origen a la instancia de destino de Cloud SQL Enterprise Plus.

Para crear un perfil de conexión, completa los siguientes pasos:

  1. En la consola de Google Cloud, ve a la página Perfiles de conexión en Database Migration Service.

    Ir a Perfiles de conexión

  2. Haga clic en Crear perfil.

  3. En la lista desplegable Motor de base de datos, selecciona Cloud SQL for PostgreSQL.

  4. En el campo Nombre del perfil de conexión, ingresa un nombre para el perfil de conexión de la base de datos de origen, como My Connection Profile.

  5. Selecciona la región en la que deseas guardar el perfil de conexión.

  6. En la lista desplegable Instancia de Cloud SQL, selecciona el nombre de tu instancia de edición de Cloud SQL Enterprise.

  7. Para autenticarte en la instancia de origen, ingresa un nombre de usuario y una contraseña. Luego, haga clic en Continuar.

  8. Si deseas encriptar tus datos, habilita la encriptación SSL/TLS para la conexión entre las bases de datos de origen y de destino. De lo contrario, conserva el valor predeterminado de Ninguno.

  9. Haz clic en Continuar.

  10. En el menú desplegable Prueba de conectividad, selecciona IP pública.

  11. Verifica que la fuente se haya configurado de forma correcta y que Database Migration Service pueda comunicarse con la fuente:

    1. Haz clic en Ejecutar prueba.

    2. Verifica que veas el estado Your connection profile test was successful!.

    Si la prueba falla, puedes abordar el problema en la parte adecuada del flujo y volver a realizar la prueba.

  12. Haz clic en Crear.

Crea trabajos de migración

Database Migration Service usa trabajos de migración para migrar datos de tu instancia de base de datos de origen de Cloud SQL Enterprise a la instancia de destino de Cloud SQL Enterprise Plus.

Crear un trabajo de migración incluye los siguientes pasos:

  • Definir la configuración del trabajo.
  • Selecciona el perfil de conexión que creaste para tu base de datos de origen de Cloud SQL Enterprise. Este es tu perfil de conexión de origen.
  • Definir la configuración para la instancia de edición de Cloud SQL Enterprise Plus de destino.
  • Configura la conectividad entre las instancias de la base de datos de origen y de destino.
  • Prueba el trabajo de migración para asegurarte de que la información de conexión que proporcionaste para el trabajo sea válida.

Define la configuración del trabajo de migración

  1. En la consola de Google Cloud, ve a la página Trabajos de migración en Database Migration Service.

    Ir a Trabajos de migración

  2. Haz clic en Crear trabajo de migración.

  3. En el campo Nombre del trabajo de migración, ingresa un nombre para el trabajo de migración, como My Migration Job.

  4. En la lista desplegable Motor de la base de datos de origen, selecciona Cloud SQL para PostgreSQL.

  5. En la lista desplegable Motor de base de datos de destino, selecciona Cloud SQL para PostgreSQL.

  6. Selecciona la región de destino en la que se creará la instancia de edición de Cloud SQL Enterprise Plus.

  7. En la lista desplegable Tipo de trabajo de migración, selecciona Continuo porque deseas que los cambios en curso en tu base de datos de origen de Cloud SQL Enterprise se migren a la instancia de la edición de destino de Cloud SQL Enterprise.

  8. Revisa los requisitos previos necesarios que se generan de forma automática para reflejar cómo se debe preparar el entorno para un trabajo de migración. Estos requisitos previos pueden incluir cómo configurar la base de datos de origen de la edición de Cloud SQL Enterprise y cómo conectarla a la instancia de destino de la edición de Cloud SQL Enterprise Plus.

    Se recomienda completar estos requisitos previos en este paso, pero puedes completarlos en cualquier momento antes de probar o iniciar tu trabajo de migración.

  9. Haz clic en Guardar y continuar.

Especifica la información sobre el perfil de conexión de origen

  1. En la lista desplegable Seleccionar perfil de conexión de origen, selecciona el perfil de conexión que creaste.

  2. Haz clic en Guardar y continuar.

Define la configuración de la instancia de edición de Cloud SQL Enterprise Plus de destino

  1. En el campo Contraseña, ingresa una contraseña alfanumérica para la instancia de edición de Cloud SQL Enterprise Plus de destino. Esta es la contraseña de la cuenta de administrador postgres en la instancia.

  2. En la lista desplegable Versión de la base de datos, selecciona la instancia de destino de la lista de versiones compatibles de Cloud SQL para el motor de base de datos especificado.

  3. Selecciona Enterprise Plus.

  4. En la sección Elige la región y la zona, selecciona la zona de Google Cloud deseada para la instancia nueva de la edición de Cloud SQL Enterprise Plus (o deja como Cualquiera).

  5. Selecciona la casilla de verificación IP pública.

  6. Selecciona la forma de máquina para la instancia de edición de Cloud SQL Enterprise Plus. El tamaño del disco debe ser igual o mayor que el tamaño de la base de datos de origen.

  7. Define el tipo de almacenamiento y la capacidad de almacenamiento para la instancia de Cloud SQL.

  8. Para crear la instancia nueva, haz clic en Crear y continuar.

  9. En el diálogo que aparece, haz clic en Crear destino y continuar. La creación de la instancia puede tomar varios minutos en completarse.

Configura la conectividad

  1. En la lista desplegable Método de conectividad, selecciona lista de IP permitidas.
  2. Para usar las direcciones IP salientes de tu instancia de edición de Cloud SQL Enterprise Plus de destino para establecer una conexión con la instancia de origen de la edición de Cloud SQL Enterprise, completa los siguientes pasos:

    1. En la región Direcciones IP salientes de destino, haz clic en Copiar todo.
    2. Abre una pestaña separada en tu navegador.
    3. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

      Ir a Instancias de Cloud SQL

    4. Haz clic en tu instancia de origen.
    5. Haga clic en Editar.
    6. En la sección Personaliza tu instancia, si aparece el menú Mostrar opciones de configuración, haz clic en él.
    7. Haz clic en la sección Conexiones.
    8. Haz clic en Agregar una red.
    9. En el campo Nombre, proporciona un nombre para la red que representa la primera dirección IP que copiaste, como My First Network. Esta red se usa para establecer una conexión entre las instancias de bases de datos de origen de Cloud SQL Enterprise Plus y de destino.
    10. En el campo Red, ingresa la primera dirección IP que copiaste, seguida de /32. Esto limita la red para aceptar conexiones solo desde esta dirección IP.
    11. Haz clic en Listo.
    12. Repite estos pasos para cada dirección IP que copiaste.
    13. Haz clic en Guardar. Cloud SQL reinicia la instancia de origen de Cloud SQL Enterprise para que se apliquen los cambios de configuración que realizaste.

  3. En la pestaña que contiene el trabajo de migración, haz clic en Guardar y continuar.

Prueba, crea y, luego, inicia el trabajo de migración

  1. Revisa la configuración que elegiste para el trabajo de migración.

  2. Verifica que la fuente se haya configurado de forma correcta, que las instancias de edición de Cloud SQL Enterprise y de destino de Cloud SQL Enterprise Plus de origen puedan comunicarse entre sí y que el trabajo de migración sea válido:

    1. Haz clic en Probar trabajo.

    2. Verifica que veas el estado Your migration job test was successful!.

    Si la prueba falla, puedes abordar el problema en la parte adecuada del flujo y volver a realizar la prueba.

  3. Para crear el trabajo de migración y, luego, iniciarlo de inmediato, haz clic en Crear e iniciar trabajo.

  4. En el cuadro de diálogo que aparece, haz clic en Crear e iniciar.

  5. En la página Trabajos de migración, verifica que el trabajo de migración tenga el estado Starting.

  6. Después de unos minutos, confirma que el estado cambie a Running.

Verifica el trabajo de migración

Para confirmar que Database Migration Service usó el trabajo de migración para migrar datos de tu instancia de base de datos de origen de Cloud SQL Enterprise a la de destino de Cloud SQL Enterprise Plus, completa los siguientes pasos:

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

    Ir a Instancias de Cloud SQL

  2. Haz clic en la entrada de réplica de lectura de tu trabajo de migración.

  3. Haz clic en el ícono Activar Cloud Shell que aparece junto al campo Buscar.
  4. En el mensaje, usa el comando gcloud sql connect para conectarte a la instancia de base de datos de edición de destino de Cloud SQL Enterprise Plus.

    gcloud sql connect DESTINATION_INSTANCE_NAME --user=postgres

    Reemplaza DESTINATION_INSTANCE_NAME por el nombre de la instancia de edición de Cloud SQL Enterprise Plus de destino.

  5. Opcional: Si aparece un diálogo Autoriza Cloud Shell, haz clic en Autorizar.
  6. En el mensaje Ingresar contraseña, ingresa la contraseña que proporcionaste en Define la configuración para la instancia de destino de Cloud SQL Enterprise Plus.
  1. En el cuadro de postgres, para enumerar las bases de datos y verificar que veas la instancia de base de datos de origen de Cloud SQL Enterprise, ingresa \list.
  2. En el cuadro de postgres, ingresa \connect SOURCE_DB_NAME para ver las tablas asociadas con esta instancia de base de datos. El nombre del mensaje cambia de postgres a SOURCE_DB_NAME.
  3. Cuando se te solicite SOURCE_DB_NAME, para ver las tablas de esta instancia, ingresa \dt.
  4. Cuando se te solicite SOURCE_DB_NAME, para que este usuario pueda acceder a los datos de las tablas de esta instancia, ingresa GRANT cloudsqlexternalsync to USER;.

    Reemplaza USER por el nombre del usuario que usaste para conectarte a la instancia de base de datos de destino de Cloud SQL Enterprise Plus.

  5. Cuando se te solicite SOURCE_DB_NAME, para ver la información que se replica desde una tabla en tu instancia de base de datos de origen de Cloud SQL Enterprise, ingresa SELECT * from TABLE_NAME;.
  6. Verifica que veas la información correcta en la tabla.

Promociona el trabajo de migración

Si promocionas el trabajo de migración, se reemplazará la instancia de base de datos de origen de Cloud SQL Enterprise por la de destino de Cloud SQL Enterprise Plus como instancia principal.

Para promocionar el trabajo de migración, completa los siguientes pasos:

  1. Regresa a la página Trabajos de migración.

  2. Haz clic en el trabajo de migración que deseas ascender. Aparecerá la página Detalles del trabajo de migración.

  3. Detén todas las operaciones de escritura en la base de datos de origen de Cloud SQL Enterprise.

  4. Verifica que el retraso de replicación sea mínimo.

  5. Haz clic en el trabajo de migración que deseas ascender. Este trabajo tiene el estado Running.

  6. Para promover el trabajo de migración, haz clic en Promover.

  7. En el cuadro de diálogo que aparece, haz clic en Promover.

  8. Verifica que el trabajo de migración tenga el estado Promote in progress. Después de unos minutos, confirma que el estado cambie a Completed.

Tu nueva instancia de base de datos de la edición Cloud SQL Enterprise Plus está lista para usarse.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, usa la consola de Google Cloud para borrar tu trabajo de migración, perfil de conexión, instancia de origen de Cloud SQL Enterprise y el proyecto si no los necesitas.

¿Qué sigue?