Crear un trabajo de migración a una instancia de destino existente

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Descripción general

El Servicio de migración de bases de datos utiliza trabajos de migración para migrar datos desde la instancia de la base de datos de origen a la instancia de la base de datos de destino.

La creación de un trabajo de migración para una instancia de destino existente incluye:

• Definir la configuración para el trabajo de migración
• Seleccionar el perfil de conexión de la base de datos de origen
• Seleccionar la instancia de base de datos de destino existente
• Degradar la instancia existente para convertirla en una réplica de lectura
• Configurar la conectividad entre las instancias de la base de datos de origen y de destino
• Probar el trabajo de migración para garantizar que la información de conexión que proporcionó para el trabajo sea válida

Existen ciertas limitaciones que debe considerar cuando desee migrar a una instancia de destino creada fuera del Servicio de migración de bases de datos. Por ejemplo, su instancia de destino de Cloud SQL debe estar vacía o contener solo datos de configuración del sistema. Para obtener más información, consulte Limitaciones conocidas .

El asistente del Servicio de migración de bases de datos le ayuda a crear un trabajo de migración. Este asistente consta de los siguientes paneles: Introducción , Definir un origen , Crear un destino , Definir el método de conectividad , Configurar bases de datos de migración y Probar y crear un trabajo de migración . En las siguientes secciones de esta página se proporciona información sobre cómo completar cada panel.

Cree un trabajo de migración utilizando el Google Cloud consola

Definir la configuración para el trabajo de migración

1. Ir a los trabajos de Migración en el Google Cloud consola.

2. Haga clic en Crear trabajo de migración en la parte superior de la página.

3. Proporcione un nombre para el trabajo de migración. Elija un nombre descriptivo que le ayude a identificar el trabajo de migración. No incluya información confidencial o de identificación personal en el nombre del trabajo.

4. Conserve el ID del trabajo de migración generado automáticamente.

5. Seleccione el motor de base de datos de origen.

6. Seleccione el motor de base de datos de destino.

7. Seleccione la región de destino para su migración. Esta región debe ser la misma que donde se encuentra su base de datos de destino. Después de elegir la región de destino, esta selección no se puede cambiar.

8. Especifique el tipo de trabajo de migración: único (solo instantánea) o continuo (instantánea + cambios en curso).

9. En la sección Antes de continuar, revise los requisitos previos , haga clic en Abrir para ver las instrucciones generadas automáticamente que pueden guiarlo en la preparación de su base de datos de origen para la migración. Es mejor completar estos requisitos previos en este paso, pero puede completarlos en cualquier momento antes de probar o comenzar el trabajo de migración. Para obtener más información, consulte Configurar su fuente .

10. Haga clic en Guardar y continuar .

Especificar información sobre el perfil de conexión de origen

1. Si ha creado un perfil de conexión, selecciónelo de la lista de perfiles de conexión existentes.

   Si no ha creado un perfil de conexión, cree uno haciendo clic en Crear un perfil de conexión en la parte inferior de la lista desplegable y luego realice los mismos pasos que en Crear un perfil de conexión de origen .

2. En la sección Personalizar configuraciones de volcado de datos , haga clic en Mostrar configuraciones de volcado de datos .

   La velocidad del paralelismo del volcado de datos está relacionada con la cantidad de carga en su base de datos de origen. Puede utilizar las siguientes configuraciones:

   • Óptimo (recomendado) : rendimiento equilibrado con carga óptima en la base de datos de origen.
   • Máximo : proporciona las velocidades de volcado más altas, pero puede provocar una mayor carga en la base de datos de origen.
   • Mínimo : toma la menor cantidad de recursos informáticos en la base de datos de origen, pero puede tener un rendimiento de volcado más lento.

   Si desea utilizar la configuración ajustada de paralelismo de volcado de datos, asegúrese de aumentar los parámetros max_replication_slots , max_wal_senders y max_worker_processes en su base de datos de origen. Puede verificar su configuración ejecutando la prueba del trabajo de migración al final de la creación del trabajo de migración.

3. Haga clic en Guardar y continuar .

Seleccione la instancia de destino

1. En el menú Tipo de instancia de destino , seleccione Instancia existente .
2. En la sección Seleccionar instancia de destino , seleccione su instancia de destino.
3. Revise la información en la sección Detalles de la instancia y haga clic en Seleccionar y continuar .
4. Para migrar a una base de datos de destino existente, el Servicio de migración de bases de datos degrada la instancia de destino y la convierte en una réplica. Para indicar que la degradación se puede realizar de forma segura, en la ventana de confirmación, ingrese el identificador de instancia de destino.
5. Haga clic en Confirmar y continuar .

Configurar la conectividad entre las instancias de la base de datos de origen y de destino.

1. En el menú Método de conectividad , seleccione un método de conectividad de red. Este método define cómo la instancia de Cloud SQL recién creada se conectará a la base de datos de origen. Los métodos de conectividad de red actuales incluyen lista de direcciones IP permitidas, túnel SSH inverso y emparejamiento de VPC .

   • Si selecciona el método de conectividad de red de lista de IP permitidas, deberá especificar la dirección IP saliente de su instancia de destino. Si la instancia de Cloud SQL que creó es una instancia de alta disponibilidad, incluya las direcciones IP salientes tanto para la instancia principal como para la secundaria.

   • Si selecciona el método de conectividad de red del túnel SSH inverso, seleccione la instancia de VM de Compute Engine que alojará el túnel.

     Después de especificar la instancia, Google proporcionará una secuencia de comandos que realiza los pasos para configurar el túnel entre las bases de datos de origen y de destino. Deberá ejecutar el script en la CLI de Google Cloud .

     Ejecute los comandos desde una máquina que tenga conectividad tanto con la base de datos de origen como con Google Cloud.

   • Si selecciona el método de conectividad de red de intercambio de tráfico de VPC, seleccione la red de VPC donde reside la base de datos de origen. La instancia de Cloud SQL se actualizará para conectarse a esta red.
   • Obtenga más información sobre cómo configurar la conectividad .

2. Después de seleccionar el método de conectividad de red y proporcionar cualquier información adicional para el método, haga clic en CONFIGURAR Y CONTINUAR .

Configurar bases de datos de migración

Puede seleccionar las bases de datos que desea migrar.

1. En la lista Bases de datos para migrar , seleccione una de las siguientes opciones:
   • Todas las bases de datos : selecciona todas las bases de datos que existen en la fuente.
   • Bases de datos específicas : le permite seleccionar bases de datos específicas de todas las bases de datos que existen en la fuente.

2. Si desea migrar bases de datos específicas, puede filtrar la lista que aparece y seleccionar las bases de datos que desea que el Servicio de migración de bases de datos migre a su destino.

   Si la lista no aparece y se muestra un error de descubrimiento de la base de datos, haga clic en Recargar . Si falla el descubrimiento de la base de datos, el trabajo migra todas las bases de datos. Puede continuar creando un trabajo de migración y corregir errores de conectividad más adelante.

3. Haga clic en Guardar y continuar .

Probar y crear el trabajo de migración

En este último paso, revise el resumen de la configuración del trabajo de migración, el origen, el destino y el método de conectividad, y luego pruebe la validez de la configuración del trabajo de migración. Si encuentra algún problema, puede modificar la configuración del trabajo de migración. No todas las configuraciones son editables.

1. Haga clic en PROBAR TRABAJO para verificar que:

   • La base de datos de origen se ha configurado correctamente, según los requisitos previos.
   • Las instancias de origen y destino pueden comunicarse entre sí.
   • Se realizan todas las actualizaciones de las direcciones IP públicas o privadas necesarias en el destino.
   • El trabajo de migración es válido y las versiones de origen y destino son compatibles.

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

   El trabajo de migración se puede crear incluso si la prueba falla, pero una vez iniciado el trabajo, puede fallar en algún momento durante la ejecución.

2. Haga clic en CREAR E INICIAR TRABAJO para crear el trabajo de migración e iniciarlo inmediatamente, o haga clic en CREAR TRABAJO para crear el trabajo de migración sin iniciarlo inmediatamente.

   Precaución: Si utilizó Terraform para aprovisionar su base de datos de destino, es posible que experimente cambios en la configuración durante la ejecución del trabajo de migración. No intente volver a aplicar la configuración de Terraform antes de que se complete la migración. Para obtener más información, consulte Desviación de la configuración de Terraform .

   Si el trabajo no se inicia en el momento de su creación, se puede iniciar desde la página de trabajos de migración haciendo clic en INICIAR .

   Independientemente de cuándo comience el trabajo de migración, a su organización se le cobra por la existencia de la instancia de destino.

   Cuando inicia el trabajo de migración, el Servicio de migración de bases de datos comienza el volcado completo y bloquea brevemente la base de datos de origen. Si su origen está en Amazon RDS o Amazon Aurora, el servicio de migración de bases de datos requiere además un breve tiempo de inactividad de escritura (aproximadamente menos de un minuto) al inicio de la migración. Para obtener más información, consulte Consideraciones sobre el paralelismo del volcado de datos .

3. El trabajo de migración se agrega a la lista de trabajos de migración y se puede ver directamente.

4. Continúe con Revisar el trabajo de migración .

Crear un trabajo de migración mediante la CLI de Google Cloud

Cuando migras a una instancia existente mediante la CLI de Google Cloud, debes crear manualmente el perfil de conexión para la instancia de destino. Esto no es necesario cuando usas el Google Cloud consola, ya que el Servicio de migración de bases de datos se encarga de crear y eliminar el perfil de conexión de destino por usted.

Antes de comenzar

Antes de usar la CLI de gcloud para crear un trabajo de migración a una instancia de base de datos de destino existente, asegúrate de:

• Cree su instancia de base de datos de destino.
• Prepare su instancia de base de datos de origen. Ver:
  • Configura tu fuente
  • Cree el perfil de conexión de origen (se requiere el identificador del perfil de conexión de origen para crear un trabajo de migración).
  • Configurar la conectividad

Crear perfil de conexión de destino

Crea el perfil de conexión de destino para tu instancia de destino existente ejecutando el comando gcloud database-migration connection-profiles create :

Este ejemplo utiliza el indicador opcional --no-async para que todas las operaciones se realicen sincrónicamente. Esto significa que algunos comandos pueden tardar un poco en completarse. Puede omitir el indicador --no-async para ejecutar comandos de forma asincrónica. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

• CONNECTION_PROFILE_ID con un identificador legible por máquina para su perfil de conexión.
• REGION con el identificador de la región donde desea guardar el perfil de conexión.
• DESTINATION_INSTANCE_ID con el identificador de instancia de su instancia de destino.
• (Opcional) CONNECTION_PROFILE_NAME con un nombre legible para su perfil de conexión. Este valor se muestra en el Google Cloud consola.

Ejecute el siguiente comando:

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Debería recibir una respuesta similar a la siguiente:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Crear el trabajo de migración

Este ejemplo utiliza el indicador opcional --no-async para que todas las operaciones se realicen sincrónicamente. Esto significa que algunos comandos pueden tardar un poco en completarse. Puede omitir el indicador --no-async para ejecutar comandos de forma asincrónica. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

• MIGRATION_JOB_ID con un identificador legible por máquina para su trabajo de migración. Utilice este valor para trabajar con trabajos de migración mediante la API o los comandos CLI de Google Cloud del servicio de migración de bases de datos.
• REGION con el identificador de la región donde desea guardar el trabajo de migración.
• MIGRATION_JOB_NAME con un nombre legible por humanos para su trabajo de migración. Este valor se muestra en el Servicio de migración de bases de datos en la Google Cloud consola.
• SOURCE_CONNECTION_PROFILE_ID con un identificador legible por máquina del perfil de conexión de origen.
• DESTINATION_CONNECTION_PROFILE_ID con un identificador legible por máquina del perfil de conexión de destino.

• Opcional: El servicio de migración de bases de datos migra todas las bases de datos en su origen de forma predeterminada. Si desea migrar solo bases de datos específicas, utilice el indicador --databases-filter y especifique sus identificadores como una lista separada por comas.

  Por ejemplo: --databases-filter=my-business-database,my-other-database

  Más adelante, puedes editar los trabajos de migración que creaste con la --database-filter flag usando el comando gcloud database-migration migration-jobs update .

Ejecute el siguiente comando:

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

Debería recibir una respuesta similar a la siguiente:

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Degradar la base de datos de destino

El servicio de migración de bases de datos requiere que la instancia de la base de datos de destino funcione como una réplica de lectura durante el momento de la migración. Antes de comenzar el trabajo de migración, ejecuta el comando gcloud database-migration migration-jobs demote-destination para degradar la instancia de la base de datos de destino.

Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

• MIGRATION_JOB_ID con su identificador de trabajo de migración.

  Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

• REGION con el identificador de la región donde está guardado tu perfil de conexión.

Ejecute el siguiente comando:

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Resultado

La acción se realiza de forma asincrónica. Como tal, este comando devuelve una entidad Operación que representa una operación de larga duración:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

Para ver si su operación fue exitosa, puede consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado del trabajo de migración.
• Utilice las gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación en sí.

Gestionar trabajos de migración

En este punto, su trabajo de migración está configurado y conectado a su instancia de base de datos de destino. Puede gestionarlo mediante las siguientes operaciones:

1. Opcional: Verifique el trabajo de migración.
   Te recomendamos que primero verifiques tu trabajo de migración ejecutando el comando gcloud database-migration migration-jobs verify .

   Para obtener más información, amplíe la siguiente sección:

   gcloud database-migration migration-jobs verify

   Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

   • MIGRATION_JOB_ID con su identificador de trabajo de migración.

     Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

   • REGION con el identificador de la región donde está guardado tu perfil de conexión.

   Ejecute el siguiente comando:

   Linux, macOS o Cloud Shell

   gcloud database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   gcloud database-migration migration-jobs `
   verify MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   gcloud database-migration migration-jobs ^
   verify MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   La acción se realiza de forma asincrónica. Como tal, este comando devuelve una entidad Operación que representa una operación de larga duración:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: verify
   name: OPERATION_ID
   

   Para ver si su operación fue exitosa, puede consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

   • Usa el comando gcloud database-migration migration-jobs describe con MIGRATION_JOB_ID para ver el estado del trabajo de migración.
   • Usa el comando gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación en sí.

2. Opcional: recupere información sobre las bases de datos seleccionadas para la migración.
   Cuando migra bases de datos específicas, el Servicio de migración de bases de datos necesita recuperar los detalles sobre las bases de datos que seleccionó para el trabajo de migración mediante el indicador --database-filter .

   Antes de comenzar el trabajo de migración, ejecuta el comando gcloud database-migration migration-jobs fetch-source-objects .

   Para obtener más información, amplíe la siguiente sección:

   gcloud database-migration migration-jobs fetch-source-objects

   Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

   • MIGRATION_JOB_ID con su identificador de trabajo de migración.

     Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

   • REGION con el identificador de la región donde está guardado tu perfil de conexión.

   Ejecute el siguiente comando:

   Linux, macOS o Cloud Shell

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   El resultado es similar al siguiente:

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   Para ver si su operación fue exitosa, puede consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

   • Usa el comando gcloud database-migration migration-jobs describe con MIGRATION_JOB_ID para ver el estado del trabajo de migración.
   • Usa el comando gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación en sí.

3. Inicie el trabajo de migración.
   Inicie el trabajo de migración ejecutando el comando gcloud database-migration migration-jobs start .

   Para obtener más información, amplíe la siguiente sección:

   gcloud database-migration migration-jobs start

   Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

   • MIGRATION_JOB_ID con su identificador de trabajo de migración.

     Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

   • REGION con el identificador de la región donde está guardado tu perfil de conexión.

   Ejecute el siguiente comando:

   Linux, macOS o Cloud Shell

   gcloud database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   gcloud database-migration migration-jobs `
   start MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   gcloud database-migration migration-jobs ^
   start MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   La acción se realiza de forma asincrónica. Como tal, este comando devuelve una entidad Operación que representa una operación de larga duración:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   Para ver si su operación fue exitosa, puede consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

   • Usa el comando gcloud database-migration migration-jobs describe con MIGRATION_JOB_ID para ver el estado del trabajo de migración.
   • Usa el comando gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación en sí.

Promover el trabajo migratorio

Una vez que la migración llega a la fase de captura de datos modificados (CDC), puede promover la instancia de la base de datos de destino desde una réplica de lectura a una instancia independiente. Ejecuta el comando gcloud database-migration migration-jobs promote :

Antes de utilizar cualquiera de los datos de comando siguientes, realice los siguientes reemplazos:

• MIGRATION_JOB_ID con su identificador de trabajo de migración.

  Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

• REGION con el identificador de la región donde está guardado tu perfil de conexión.

Ejecute el siguiente comando:

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

Resultado

La acción se realiza de forma asincrónica. Como tal, este comando devuelve una entidad Operación que representa una operación de larga duración:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

• Usa el comando gcloud database-migration migration-jobs describe con MIGRATION_JOB_ID para ver el estado del trabajo de migración.
• Usa el comando gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación en sí.