Crea un trabajo de migración a una instancia de destino nueva

MySQL   |  PostgreSQL   |  PostgreSQL a AlloyDB

La creación de un trabajo de migración incluye lo siguiente:

• Definir la configuración del trabajo de migración
• Especifica la información sobre el perfil de conexión que creaste para tu base de datos de origen (perfil de conexión fuente).
• Definir la configuración para la instancia de base de datos de Cloud SQL de destino y crear la instancia
• Configurar la conectividad entre las instancias de base de datos de origen y de destino.
• Probar el trabajo de migración para asegurarte de que la información de conexión que proporcionaste para el trabajo sea válida

Nota: Para la conectividad de IP privada, cuando migres a una instancia de Cloud SQL creada con Database Migration Service, solo podrás usar el método de acceso a servicios privados (intercambio de tráfico entre VPC). Si deseas usar Private Service Connect con tu clúster de destino, primero crea la instancia de destino directamente en Cloud SQL y, luego, sigue los pasos que se indican en la página Migra a una instancia existente.

Para crear un trabajo de migración a una instancia de destino nueva, haz lo siguiente:

Console

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.

   Ir a Trabajos de migración

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

   Se abrirá la página del asistente de configuración del trabajo de migración. Este asistente contiene varios paneles que te guían por cada paso de la configuración.

   Puedes pausar la creación de un trabajo de migración en cualquier momento haciendo clic en Guardar y salir. Todos los datos que ingreses hasta ese punto se guardarán en un borrador de trabajo de migración. Puedes terminar el borrador del trabajo de migración más tarde.

3. En la página Primeros pasos, ingresa la siguiente información:
   1. Nombre del trabajo de migración

      Es un nombre legible para tu trabajo de migración. Este valor se muestra en la consola de Google Cloud .

   2. ID del trabajo de migración

      Es un identificador legible por máquina para tu trabajo de migración. Usas este valor para trabajar con trabajos de migración a través de los comandos de la CLI de Google Cloud o la API de Database Migration Service.

   3. En la lista Motor de base de datos de origen, selecciona MySQL.

      El campo Motor de base de datos de destino se completa automáticamente y no se puede cambiar.

   4. Selecciona la región en la que guardarás el trabajo de migración.

      Database Migration Service es un producto completamente regional, lo que significa que todas las entidades relacionadas con tu migración (perfiles de conexión de origen y destino, trabajos de migración y bases de datos de destino) deben guardarse en una sola región. Selecciona la región según la ubicación de los servicios que necesitan tus datos, como instancias de Compute Engine o apps de App Engine, y otros servicios. Después de elegir la región de destino, no se podrá cambiar esta selección.

      Importante: Si planeas usar la edición Enterprise Plus de Cloud SQL para MySQL, asegúrate de que tu región sea compatible con esa edición. Consulta la compatibilidad con regiones de la edición Enterprise Plus de Cloud SQL para MySQL.
4. Haz clic en Guardar y continuar.

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

En la página Define a source, realiza los siguientes pasos:

1. En el menú desplegable Perfil de conexión de origen, selecciona el perfil de conexión de tu base de datos de origen.
2. En la sección Personaliza la configuración de volcado completo, haz clic en Editar configuración.
3. En el panel Editar la configuración de volcado completo, en el menú desplegable Método de volcado completo, selecciona una de las siguientes opciones:
   • Basada en archivos físicos: Selecciona esta opción si deseas usar la utilidad Percona XtraBackup para proporcionar tu propio archivo de copia de seguridad. Este enfoque requiere pasos de preparación adicionales. Para obtener la guía completa sobre el uso de archivos de copia de seguridad físicos generados por Percona XtraBackup, consulta Migra tus bases de datos con un archivo físico de Percona XtraBackup.
   • Basada en la lógica: Selecciona esta opción si deseas usar un archivo de copia de seguridad lógica creado por la utilidad mysqlshell. Database Migration Service puede generar automáticamente este archivo de copia de seguridad por ti, o bien puedes proporcionar tu propia copia.
4. Edita el resto de la configuración de volcado. Realiza una de las siguientes acciones:
   • Si usas el archivo de copia de seguridad físico, en Proporciona tu carpeta, haz clic en Explorar y, luego, selecciona la carpeta en la que subiste el archivo de volcado completo. Asegúrate de seleccionar la carpeta exclusiva que contiene el archivo de copia de seguridad completo, y no el bucket de almacenamiento.

   • Si usas un archivo de copia de seguridad lógica, configura el paralelismo del volcado de datos o las marcas de volcado.

     Expande esta sección para ver los pasos completos del archivo de copia de seguridad lógica

     En la sección Elige cómo generar el archivo de volcado, usa una de las siguientes opciones:

     1. Generación automática del volcado inicial (recomendado)

        Se recomienda esta opción porque Database Migration Service siempre genera un archivo de volcado inicial de la base de datos después de que se crea y se inicia el trabajo de migración.

        Database Migration Service usa este archivo para reproducir las definiciones de objetos originales y los datos de la tabla de tu base de datos de origen, de modo que esta información se pueda migrar a una instancia de base de datos de Cloud SQL de destino.

        Si usas el volcado generado automáticamente, selecciona el tipo de operación que Database Migration Service debe realizar en la sección Configurar operación de volcado de datos:

        • Paralelismo de volcado de datos: Usa una opción de paralelismo de alto rendimiento, disponible cuando migras a las versiones 5.7 u 8 de MySQL.
          Si decides usar el paralelismo de carga, asegúrate de proporcionar los privilegios necesarios en la base de datos de origen para tu situación (como LOCK_TABLES). Para obtener más información sobre los permisos necesarios para las bases de datos de origen, consulta Configura la base de datos de origen.

          La velocidad del paralelismo de datos se relaciona con la cantidad de carga inducida en tu base de datos de origen:

          • Óptimo (recomendado): Rendimiento equilibrado con una carga óptima en la base de datos de origen.
          • Máximo: Proporciona las velocidades de volcado más altas, pero podría aumentar la carga en la base de datos de origen.
          • Mínimo: Toma la menor cantidad de recursos de procesamiento en la base de datos de origen, pero puede tener una capacidad de procesamiento de volcado más lenta.
        • Marcas de volcado: Esta opción es exclusiva de Paralelismo de volcado de datos. Usa este parámetro de configuración para establecer directamente marcas para la utilidad mysqldump que se usa para crear el archivo de volcado.

          Para agregar una marca, haz lo siguiente:

          1. Haz clic en AGREGAR MARCA.

          2. Selecciona una de las siguientes marcas:

             • add-locks: Esta marca rodea cada tabla que se incluye en el archivo de volcado con instrucciones LOCK TABLES y UNLOCK TABLES. Esto genera inserciones más rápidas cuando el archivo de volcado se carga en la instancia de destino.
             • ignore-error: Usa esta marca para ingresar una lista de números de error separados por comas. Estos números representan los errores que la utilidad mysqldump ignorará.
             • max-allowed-packet: Usa esta marca para establecer el tamaño máximo del búfer para la comunicación entre el cliente de MySQL y la base de datos de origen de MySQL. El tamaño predeterminado del búfer es de 24 MB y el tamaño máximo es de 1 GB.
               Si usas columnas BLOB grandes o cadenas largas en las tablas de la base de datos de origen, debes aumentar el tamaño del búfer para esta marca.
             Para obtener más información sobre estas marcas, consulta la documentación sobre la utilidad mysqldump en el Manual de referencia de MySQL 8.0.
          3. Haz clic en LISTO.
          4. Repite estos pasos para cada marca que desees agregar.

          Para quitar una marca, haz clic en el ícono de papelera a la derecha de la fila que contiene la marca.

     2. Proporcionar tu propia

        No se recomienda esta opción porque, de forma predeterminada, Database Migration Service realiza una volcado inicial como parte de la ejecución del trabajo de migración.

        Si quieres usar tu propio archivo de volcado, selecciona Proporciona tu propio archivo, haz clic en BROWSE, selecciona tu archivo (o toda la carpeta de Cloud Storage si usas varios archivos) y, luego, haz clic en SELECT.

        Asegúrate de que el volcado se haya generado en las últimas 24 horas y cumpla con los requisitos de volcado.

5. Haz clic en Guardar y continuar.

Configura y crea la instancia de Cloud SQL de destino

1. En la página Define a destination, en el menú desplegable Type of destination instance, selecciona New instance. Define todos los parámetros de configuración pertinentes:
   1. En el campo ID de instancia de destino, proporciona un identificador para la instancia de Cloud SQL o usa el identificador generado automáticamente.

      No incluyas información sensible o de identificación personal en el identificador. No es necesario incluir el ID del proyecto en el nombre de la instancia. Esto se hace de manera automática cuando corresponde (por ejemplo, en los archivos de registro).

   2. En el campo Contraseña, proporciona una contraseña alfanumérica para la instancia de Cloud SQL de destino. Esta es la contraseña de la cuenta de administrador root en la instancia.

      Puedes ingresar la contraseña de forma manual o hacer clic en Generar para que Database Migration Service cree una automáticamente.

   3. En el menú desplegable Versión de la base de datos, elige la versión de la base de datos para la instancia de destino.

      Haz clic en Mostrar versiones secundarias para ver todas las versiones secundarias. Obtén más información sobre la compatibilidad con la migración entre versiones.

   4. Selecciona la edición de Cloud SQL para MySQL para tu instancia de destino. Hay dos opciones disponibles: Cloud SQL para MySQL Enterprise y Cloud SQL para MySQL Enterprise Plus.

      Las ediciones de Cloud SQL para MySQL incluyen diferentes conjuntos de funciones, tipos de máquinas disponibles y precios. Asegúrate de consultar la documentación de Cloud SQL para elegir la edición adecuada para tus necesidades. Para obtener más información, consulta Introducción a las ediciones de Cloud SQL para MySQL.

   5. En el menú Región, se muestra la misma región que seleccionaste en la página Comenzar.

      Si estás configurando tu instancia para alta disponibilidad, selecciona Varias zonas (con alta disponibilidad). Puedes seleccionar la zona principal y la secundaria. Se aplican las siguientes condiciones cuando se usa la zona secundaria durante la creación de la instancia:

      • Las zonas están predeterminadas como Cualquiera para la zona principal y Cualquiera (diferente de la principal) para la zona secundaria.
      • Si se especifican las zonas principal y secundaria, deben ser zonas diferentes.
   6. En la sección Conexiones, elige si deseas agregar una dirección IP pública o privada para la instancia de destino. Puedes configurar tu instancia para que tenga ambos tipos de direcciones IP, pero se requiere al menos un tipo para la migración. Selecciona una de las siguientes opciones:
      • Si deseas migrar con el intercambio de tráfico de VPC o un túnel SSH inverso, selecciona IP privada.

        • Para habilitar la conectividad de IP privada, asegúrate de cumplir con todos los requisitos de redes adicionales.

          Expande esta sección para ver todos los requisitos de IP privada.

          • La API de Service Networking está habilitada. Puedes habilitar la API de Service Networking con la consola de Google Cloud .
          • Tienes el permiso de IAM servicenetworking.services.addPeering.
          • Configuraste el acceso privado a servicios para tu proyecto, para lo cual debes tener el rol de IAM compute.networkAdmin.
          • Debe haber al menos una red de VPC no heredada en tu proyecto o una red de VPC compartida.
          • Si usas una red de VPC compartida, también debes hacer lo siguiente:
            • Habilita la API de Herramientas de redes de servicios para el proyecto host.
            • Agrega tu usuario al proyecto host.
            • Otorga a tu usuario el rol de IAM compute.networkAdmin en el proyecto host.
        • Selecciona la red de VPC asociada con la que se realizará el intercambio de tráfico. Si planeas conectarte a la fuente de migración con el intercambio de tráfico entre VPC, elige la VPC en la que reside la instancia.
        • Si nunca se configuró una red de servicio administrado para la VPC seleccionada, puedes seleccionar un rango de IP y hacer clic en Conectar o usar un rango de IP seleccionado automáticamente y hacer clic en Asignar y conectar.
      • Si deseas migrar a través de Internet con una lista de IP permitidas, selecciona IP pública.
        

        De manera opcional, en IP pública, haz clic en el campo Redes autorizadas y autoriza una red o un proxy para que se conecten a la instancia de Cloud SQL. Las redes solo se autorizan con las direcciones que proporcionas. Consulta Configura una IP pública en la documentación de Cloud SQL.

      Configurarás la conectividad del trabajo de migración en un paso posterior. Para obtener más información sobre los métodos de redes disponibles, consulta Cómo configurar la conectividad.

2. Selecciona el tipo de máquina para la instancia de Cloud SQL. El tamaño del disco debe ser igual o mayor que el tamaño de la base de datos de origen. Obtén más información sobre los tipos de máquinas de MySQL.
   Nota: Las máquinas disponibles en la selección de Tipo de máquina dependen de la edición de Cloud SQL que uses.
3. Para la edición Enterprise Plus de Cloud SQL para MySQL: Selecciona la casilla de verificación Habilitar caché de datos si deseas usar la función de caché de datos en tu base de datos de destino.

   La caché de datos es una función opcional disponible para las instancias de la edición Enterprise Plus de Cloud SQL para MySQL que agrega una unidad de estado sólido local de alta velocidad a tu base de datos de destino. Esta función puede generar costos adicionales en tu instancia de Cloud SQL. Para obtener más información sobre la caché de datos, consulta Descripción general de la caché de datos en la documentación de Cloud SQL.

4. Especifica el tipo de almacenamiento para la instancia de Cloud SQL. Puedes elegir entre una unidad de estado sólido (SSD) o una unidad de disco duro (HDD).
5. Especifica la capacidad de almacenamiento (en GB) para la instancia de Cloud SQL.

   Asegúrate de que la instancia tenga suficiente capacidad de almacenamiento para controlar los datos de tu base de datos de origen. Puedes aumentar esta capacidad en cualquier momento, pero no puedes disminuirla.

6. (Opcional) Configura las opciones de encriptación de datos o las etiquetas de recursos para tu instancia de destino.

   Expande esta sección para ver los pasos opcionales.

   Haz clic en Mostrar configuraciones opcionales y, luego, haz lo siguiente:

   1. Especifica si deseas administrar la encriptación de los datos que se migran del origen al destino. De forma predeterminada, tus datos se encriptan con una clave administrada por Google Cloud. Si quieres administrar la encriptación, puedes usar una clave de encriptación administrada por el cliente (CMEK). Para ello, deberás hacer lo siguiente:

      1. Selecciona la casilla de verificación Usar una clave de encriptación administrada por el cliente (CMEK).
      2. En el menú Selecciona una clave administrada por el cliente, selecciona tu CMEK.

      Si no ves tu clave, haz clic en Enter key resource name para proporcionar el nombre del recurso de la clave que quieres usar. Ejemplo de nombre del recurso de la clave: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

      Como parte de la creación del trabajo de migración, Database Migration Service verifica que la CMEK exista y que Database Migration Service tenga permisos para usar la clave.

      Si Database Migration Service no tiene estos permisos, aparecerá información que especifica que la cuenta de servicio de Database Migration Service no puede usar la CMEK. Haz clic en Otorgar para otorgarle a Database Migration Service permisos para usar la clave.

      Para obtener más información sobre cómo crear una CMEK, consulta Usa claves de encriptación administradas por el cliente (CMEK).

   2. Agrega las marcas necesarias que se aplicarán al servidor de la base de datos. Si es posible, asegúrate de que las marcas de base de datos en la instancia de Cloud SQL de destino creada sean las mismas que las de la base de datos de origen. Obtén más información sobre las marcas de bases de datos compatibles con MySQL.
   3. Agrega las etiquetas específicas de la instancia de Cloud SQL.

      Las etiquetas ayudan a organizar tus instancias. Por ejemplo, puedes organizar las etiquetas por centro de costos o entorno. Además, las etiquetas se incluyen en tu factura para que puedas ver la distribución de los costos en distintas etiquetas.

7. Haz clic en Crear destino y continuar. Database Migration Service ahora está creando tu instancia de destino de Cloud SQL. Este proceso puede tardar varios minutos.
   Punto clave:

   • Database Migration Service crea una instancia de Cloud SQL por la que se te cobrará según la configuración especificada. Si se sale del flujo de creación del trabajo de migración antes de que se complete, usa el botón Cancelar para limpiar la instancia de Cloud SQL. Si se cierra el navegador o la pestaña, se hace clic en Guardar y salir o se abandona la pantalla, no se limpiará la instancia de Cloud SQL y se deberá borrar manualmente desde la página Instancias de Cloud SQL.
   • Después de crear la instancia de destino, ya no se podrán editar los parámetros de configuración de la instancia de Cloud SQL en la consola de Database Migration Service. Aún puedes acceder a la instancia directamente en la consola de Cloud SQL para modificarla.

Configura la conectividad entre las instancias de base de datos de origen y de destino

En el menú desplegable Método de conectividad, selecciona 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 fuente. Los métodos de conectividad de red actuales incluyen la lista de IP permitidas, el túnel SSH inverso y el intercambio de tráfico entre VPC.

Si quieres usar…	Luego…
El método de conectividad de red de la lista de IP permitidas	Debes especificar la dirección IP saliente de tu instancia de destino. Si la instancia de Cloud SQL que creaste es una instancia de alta disponibilidad, incluye las direcciones IP salientes de la instancia principal y la secundaria.
El método de conectividad de red de túnel SSH inverso	Debes seleccionar 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 ejecutará los pasos para configurar el túnel entre las bases de datos de origen y destino. Deberás ejecutar la secuencia de comandos en Google Cloud CLI. Ejecuta los comandos desde una máquina que tenga conectividad con la base de datos de origen y con Google Cloud.
El método de conectividad de red de intercambio de tráfico entre VPCs	Debes seleccionar la red de VPC en la que reside la base de datos de origen. La instancia de Cloud SQL se actualizará para conectarse a esta red.

Después de seleccionar y configurar la conectividad de red, haz clic en Configurar y continuar.

Prueba, crea y ejecuta el trabajo de migración

En este último paso, revisa el resumen de la configuración del trabajo de migración, la fuente, el destino y el método de conectividad. Luego, prueba la validez de la configuración del trabajo de migración. Si se detecta algún problema, puedes modificar la configuración del trabajo de migración. No todos los parámetros de configuración se pueden editar.

1. En la página Prueba y crea el trabajo de migración, haz clic en Probar trabajo.

   Si la prueba falla, puedes abordar el problema en la parte adecuada del flujo y volver a realizar la prueba. Para obtener información sobre la solución de problemas de una prueba fallida del trabajo de migración, consulta Diagnostica problemas de MySQL.

2. Cuando finalice la prueba del trabajo de migración, haz clic en Crear y comenzar trabajo para crear el trabajo de migración y comenzarlo de inmediato, o bien haz clic en Crear trabajo para crear el trabajo de migración sin comenzarlo de inmediato.

   Si el trabajo no se inicia en el momento en que se crea, se puede iniciar desde la página Trabajos de migración haciendo clic en INICIAR. Independientemente de cuándo comience el trabajo de migración, se le cobrará a tu organización por la existencia de la instancia de destino.

   La migración está en curso. Cuando inicies el trabajo de migración, Database Migration Service comenzará el volcado completo y bloqueará brevemente la base de datos de origen. Si tu fuente está en Amazon RDS o Amazon Aurora, Database Migration Service también requiere un breve tiempo de inactividad de escritura (aproximadamente menos de un minuto) al inicio de la migración. Para obtener más información, consulta Limitaciones conocidas.

   Precaución: Si usaste Terraform para aprovisionar tu base de datos de destino, es posible que experimentes una desviación de la configuración durante la ejecución del trabajo de migración. No intentes volver a aplicar la configuración de Terraform antes de que se complete la migración. Para obtener más información, consulta Desviación de la configuración de Terraform.
3. Continúa con Revisar el trabajo de migración.

gcloud

1. Crea el perfil de conexión de destino.
   Cuando migras a una nueva instancia de destino con Google Cloud CLI, creas la instancia de destino y el perfil de conexión en una sola acción.
   Ejecuta el siguiente comando (haz clic en el vínculo para expandirlo):

   gcloud database-migration connection-profiles create cloudsql

   En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un tiempo en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

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

   • CONNECTION_PROFILE_ID con un identificador legible por máquina para tu perfil de conexión.
   • DATABASE_VERSION con la versión de MySQL que deseas usar en la instancia de destino. Las versiones de la base de datos se especifican como cadenas que incluyen tanto la versión principal como la secundaria. Por ejemplo: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

     Para ver todas las versiones posibles de MySQL, consulta la referencia de la marca --database-version.

   • (Opcional) EDITION De forma predeterminada, las instancias nuevas que creas con Google Cloud CLI usan la edición de Cloud SQL para MySQL Enterprise Plus. Si planeas usar la edición Cloud SQL para MySQL Enterprise Plus, asegúrate de que tu región sea compatible con esa edición. Consulta la compatibilidad con regiones de la edición Enterprise Plus de Cloud SQL para MySQL.

     Puedes cambiar la edición con la marca --edition y uno de los siguientes valores:

     • enterprise-plus para la edición Enterprise Plus de Cloud SQL para MySQL
     • enterprise para la edición Enterprise de Cloud SQL para MySQL
   • TIER por el nombre del tipo de máquina de Cloud SQL que deseas usar Los tipos de máquinas se especifican como cadenas que siguen la convención de Cloud SQL, por ejemplo, db-n1-standard-1, db-perf-optimized-N-2. Para obtener una lista completa de los tipos de máquinas disponibles y sus identificadores para usar con Google Cloud CLI, consulta Tipos de máquinas en la documentación de Cloud SQL para MySQL.

     Las instancias creadas con Google Cloud CLI usan de forma predeterminada la edición Enterprise Plus de Cloud SQL para MySQL, que tiene diferentes tipos de máquinas disponibles. Si deseas usar un tipo de máquina que solo está disponible en la edición Enterprise de Cloud SQL para MySQL, usa la marca opcional --edition=enterprise para especificar la edición.

   • REGION con el identificador de la región en la que deseas guardar el perfil de conexión.

     De forma predeterminada, las instancias nuevas que creas con Google Cloud CLI usan la edición Cloud SQL para MySQL Enterprise Plus. Si planeas usar la edición Enterprise Plus de Cloud SQL para MySQL, asegúrate de que tu región sea compatible con esa edición. Consulta la compatibilidad con regiones de la edición Enterprise Plus de Cloud SQL para MySQL. Puedes cambiar la edición con la marca opcional --edition.

   • (Opcional) CONNECTION_PROFILE_NAME con un nombre legible para tu perfil de conexión. Este valor se muestra en la consola de Google Cloud .
   • Configuración de redes

     De forma predeterminada, las instancias nuevas que creas con Google Cloud CLI tienen asignada una dirección IP pública y están configuradas para usar la conectividad de IP pública. Puedes usar otros métodos de conectividad. Para obtener más información, consulta Configura la conectividad.

     No es necesario que uses marcas adicionales si quieres usar la conectividad de IP pública. Si deseas usar la conectividad de IP privada con el intercambio de tráfico entre redes de VPC o un túnel de SSH inverso, asegúrate de cumplir con los siguientes requisitos de red adicionales para habilitar la conectividad de IP privada y, luego, incluye marcas adicionales en tu comando.

     Expande esta sección para ver todos los requisitos de IP privada.

     • La API de Service Networking está habilitada. Puedes habilitar la API de Service Networking con la consola de Google Cloud .
     • Tienes el permiso de IAM servicenetworking.services.addPeering.
     • Configuraste el acceso privado a servicios para tu proyecto, para lo cual debes tener el rol de IAM compute.networkAdmin.
     • Debe haber al menos una red de VPC no heredada en tu proyecto o una red de VPC compartida.
     • Si usas una red de VPC compartida, también debes hacer lo siguiente:
       • Habilita la API de Herramientas de redes de servicios para el proyecto host.
       • Agrega tu usuario al proyecto host.
       • Otorga a tu usuario el rol de IAM compute.networkAdmin en el proyecto host.

     Incluye las siguientes marcas adicionales si deseas usar la conectividad de IP privada (con el peering de redes de VPC o con un túnel de SSH inverso en una VM de Compute Engine):

     • --no-enable-ip-v4: (Opcional) Para no asignar una dirección IP pública a tu instancia de destino. Puedes tener una dirección IP pública y una privada asignadas a tu instancia de destino, pero es posible que no desees una dirección IP pública si usas la conectividad de IP privada.
     • --private-network: Para asignar una dirección IP privada a tu instancia de destino, especifica el nombre de la nube privada virtual en la que deseas que se asigne una dirección IP privada.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   gcloud database-migration connection-profiles \
   create mysql CONNECTION_PROFILE_ID \
     --no-async \
     --region=REGION \
     --database-version=DATABASE_VERSION \
     --tier=TIER \
     --display-name=CONNECTION_PROFILE_NAME

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   gcloud database-migration connection-profiles `
   create mysql CONNECTION_PROFILE_ID `
     --no-async `
     --region=REGION `
     --database-version=DATABASE_VERSION `
     --tier=TIER `
     --display-name=CONNECTION_PROFILE_NAME

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

   gcloud database-migration connection-profiles ^
   create mysql CONNECTION_PROFILE_ID ^
     --no-async ^
     --region=REGION ^
     --database-version=DATABASE_VERSION ^
     --tier=TIER ^
     --display-name=CONNECTION_PROFILE_NAME

   Deberías recibir una respuesta similar a la que figura a continuación:

   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]
   

2. Crea el trabajo de migración.
   Si usas el intercambio de tráfico de VPC o la conectividad de túnel inverso de SSH, asegúrate de agregar las marcas requeridas, como --peer-vpc o --vm, --vm-ip, --vm-port, --vpc. Para obtener más información, consulta Configura la conectividad y Ejemplos de Google Cloud CLI.
   Ejecuta el siguiente comando (haz clic en el vínculo para expandirlo):

   gcloud database-migration migration-jobs create

   En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un tiempo en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

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

   • MIGRATION_JOB_ID con un identificador legible por máquina para tu trabajo de migración. Usas este valor para trabajar con trabajos de migración a través de los comandos de la CLI de Google Cloud o la API de Database Migration Service.
   • REGION con el identificador de la región en la que deseas guardar el trabajo de migración.
   • MIGRATION_JOB_NAME con un nombre legible para tu trabajo de migración. Este valor se muestra en Database Migration Service en la consola de Google Cloud .
   • 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.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   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=MIGRATION_JOB_TYPE

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   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=MIGRATION_JOB_TYPE

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

   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=MIGRATION_JOB_TYPE

   Deberías recibir una respuesta similar a la que figura a continuación:

   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]