Tutorial: Migración en línea desde una máquina virtual de Azure o un servidor PostgreSQL local a Azure Database for PostgreSQL con la versión preliminar del servicio de migración

Este artículo le guía por el uso de Azure Portal para migrar la base de datos de PostgreSQL desde una máquina virtual de Azure o un servidor PostgreSQL local a una instancia de Azure Database for PostgreSQL. Azure Portal permite realizar varias tareas, incluida la migración de bases de datos. Siguiendo los pasos descritos en este tutorial, puede transferir sin problemas la base de datos a Azure y aprovechar sus eficaces características y escalabilidad.

Configuración de la tarea de migración

El servicio de migración incluye una experiencia sencilla basada en asistentes en Azure Portal. A continuación, se indica cómo empezar:

1. Abra el explorador web y vaya al portal. Escriba sus credenciales para iniciar sesión. La vista predeterminada es el panel del servicio.

2. Vaya al destino de Azure Database for PostgreSQL con servidor flexible.

3. En la pestaña Información general del servidor flexible, en el menú de la izquierda, desplácese hacia abajo hasta Migración y selecciónelo.

   

4. Seleccione el botón Crear para migrar desde una máquina virtual (VM) de Azure o un servidor PostgreSQL local al servidor flexible. Si esta es la primera vez que usa el servicio de migración, aparecerá una cuadrícula vacía con un mensaje para comenzar la primera migración.

   

   Si ya ha creado migraciones al destino de servidor flexible, la cuadrícula contiene información sobre las migraciones intentadas.

5. Seleccione el botón Crear. A continuación, pasará por una serie de pestañas basadas en el asistente para crear una migración a este destino de servidor flexible desde el servidor de origen de PostgreSQL.

Configurar

La primera pestaña es la pestaña de configuración, donde el usuario inicia las migraciones proporcionando detalles de migración, como el nombre de la migración y el tipo de origen.

• Nombre de la migración es el identificador único de cada migración a este destino de servidor flexible. Este campo solo acepta caracteres alfanuméricos; no acepta caracteres especiales, excepto un guion (-). El nombre no puede empezar por un guion y debe ser único en un servidor de destino. Dos migraciones al mismo destino de servidor flexible no pueden tener el mismo nombre.

• Tipo de servidor de origen: en función del origen de PostgreSQL, puede seleccionar Máquina virtual de Azure o local.

• Opción de migración: le permite realizar validaciones antes de desencadenar una migración. Puede elegir cualquiera de las siguientes opciones:

  • Validar: comprueba la preparación del servidor y de la base de datos para la migración al destino.
  • Migrar: omite las validaciones e inicia las migraciones.
  • Validar y migrar: realiza la validación antes de desencadenar una migración. La migración se desencadena solo si no hay errores de validación.

Siempre es recomendable elegir la opción Validar o Validar y migrar para realizar validaciones previas a la migración antes de ejecutar la migración. Para obtener más información sobre la validación previa a la migración, consulte esta documentación.

El modo de migración le permite elegir el modo para la migración. Sin conexión es la opción predeterminada.

Seleccione el botón Siguiente: Conectar al origen.

Servidor en tiempo de ejecución

Migration Runtime Server es una característica especializada dentro del servicio de migración en Azure Database for PostgreSQL, diseñada para actuar como servidor intermediario durante la migración. Se trata de una instancia independiente de Azure Database for PostgreSQL: Servidor flexible que no es el servidor de destino, sino que se usa para facilitar la migración de bases de datos desde un entorno de origen al que solo se puede acceder a través de una red privada.

Para obtener más información sobre el servidor en tiempo de ejecución, visite Servidor en tiempo de ejecución.

Conectar a origen

La pestaña Conectar al origen le pide que proporcione detalles relacionados con el origen seleccionado en la pestaña Configuración, que es el origen de las bases de datos.

• Nombre del servidor: proporcione el nombre de host o la dirección IP de la instancia de PostgreSQL de origen
• Puerto: número de puerto del servidor de origen
• Id. de inicio de sesión del administrador del servidor: nombre de usuario del servidor PostgreSQL de origen
• Contraseña: contraseña del servidor PostgreSQL de origen
• Modo SSL: se prefieren y se requieren valores admitidos. Cuando la SSL en el servidor PostgreSQL de origen esté desactivado, use SSLMODE=prefer. Si la SSL en el servidor de origen está activada, use SSLMODE=require. Los valores de la SSL se pueden determinar en el archivo postgresql.conf.
• Prueba de conexión: realiza la prueba de conectividad entre el destino y el origen. Una vez que la conexión se ha realizado correctamente, los usuarios pueden continuar con el paso siguiente. De lo contrario, tendremos que identificar los problemas de conexión en red entre el destino y el origen, así como comprobar el nombre de usuario o la contraseña del origen. La prueba de conexión tarda unos minutos en establecer una conexión entre el destino y el origen

Después de que la prueba de conexión se realice correctamente, seleccione Siguiente: Seleccionar el destino de la migración

Selección del destino de migración

En la pestaña Seleccionar el destino de la migración se muestran los metadatos del servidor flexible, como el nombre de la suscripción, el grupo de recursos, el nombre del servidor, la ubicación y la versión de PostgreSQL.

• Nombre de usuario del administrador: nombre de usuario del administrador del servidor PostgreSQL de destino
• Contraseña: contraseña del servidor PostgreSQL de destino
• FQDN/IP personalizado (opcional): el campo FQDN/IP personalizado es opcional y se puede usar cuando el destino está detrás de un servidor DNS personalizado o tiene espacios de nombres DNS personalizados, lo que hace que solo sea accesible a través de FQDN o direcciones IP específicas. Por ejemplo, esto podría incluir entradas como flexibleserver.example.com, 198.1.0.2 o un FQDN de PostgreSQL, como flexibleserver.postgres.database.azure.com, si el servidor DNS personalizado contiene la zona DNS postgres.database.azure.com o reenvía las consultas de esta zona a 168.63.129.16, donde el FQDN se resuelve en la zona DNS pública o privada de Azure.
• Prueba de conexión: realiza la prueba de conectividad entre el destino y el origen. Una vez que la conexión se ha realizado correctamente, los usuarios pueden continuar con el paso siguiente. De lo contrario, tendremos que identificar los problemas de conexión en red entre el destino y el origen, así como comprobar el nombre de usuario o la contraseña del destino. La conexión de prueba tarda unos minutos en establecer una conexión entre el destino y el origen.

Después de que la prueba de conexión se realice correctamente, seleccione Siguiente: Seleccionar las bases de datos de la migración.

Selección de bases de datos para la migración

En esta pestaña, una lista de bases de datos de usuario está dentro del servidor de origen seleccionado en la pestaña configuración. Puede seleccionar y migrar hasta ocho bases de datos en un único intento de migración. Si hay más de ocho bases de datos de usuario, el proceso de migración se repite entre los servidores de origen y de destino para el siguiente conjunto de bases de datos.

Una vez seleccionadas las bases de datos, seleccione Siguiente: Resumen

Resumen

En la pestaña Resumen se detalla toda la información del origen y el destino para crear la validación o la migración. Revise los detalles y seleccione el botón Inicio.

Supervisión de la migración

Después de seleccionar el botón Iniciar, aparece una notificación en unos segundos para indicar que la validación o la creación de la migración se han realizado correctamente. Se le redirigirá automáticamente a la hoja de Migración del servidor flexible, que tiene una nueva entrada para la validación o migración recién creada.

La cuadrícula que muestra las migraciones tiene estas columnas: Nombre, Estado, Modo de migración, Tipo de migración, Servidor de origen, Tipo de servidor de origen, Bases de datos, **Duración y Hora de inicio. Las entradas se muestran en el orden descendente de la hora de inicio con la entrada más reciente en la parte superior. Puede usar el botón Actualizar para actualizar el estado de la validación o migración. Seleccione el nombre de la migración en la cuadrícula para ver los detalles asociados.

Cuando se crea la validación o migración, pasa al estado InProgress y al subestado PerformingPreRequisiteSteps. El flujo de trabajo tarda entre 2 y 3 minutos en configurar la infraestructura de migración y las conexiones de red.

Detalles de la migración

En la pestaña Configuración, hemos seleccionado la opción de migración como Migrar y validar. En este escenario, las validaciones se realizan primero antes de que se inicie la migración. Una vez completado el subestado PerformingPreRequisiteSteps, el flujo de trabajo pasa al subestado de Validación en curso.

• Si la validación tiene errores, la migración pasa a un estado Error.
• Si la validación se completa sin ningún error, se inicia la migración y el flujo de trabajo pasará al subestado Migración de datos.

Los resultados de la validación se muestran en la pestaña Validación y la migración se supervisa en la pestaña Migración.

Algunos estados de migración posibles:

Estados de migración

Subestados de la migración

Subestados de validación

Transición

Si hay migrar y validar y migrar, completar la migración en línea requiere otro paso: el usuario debe realizar una acción de transición. Una vez completada la copia o clonación de los datos base, la migración se mueve al estado de WaitingForUserAction y al sustrato de WaitingForCutoverTrigger. En este estado, el usuario puede desencadenar la transición desde el portal seleccionando la migración.

Antes de iniciar la transición, es importante comprobar lo siguiente:

• Las escrituras en el origen se detienen: el valor de Latency es 0 o cerca de 0. La información de Latency se puede obtener de la pantalla de detalles de la migración, como se muestra a continuación:
• El valor latency disminuye a 0 o cerca de 0
• El valor latency indica cuándo el destino se sincronizó por última vez con el origen. La escritura en el origen se puede detener en este momento y se puede iniciar una transición. En caso de que haya tráfico pesado en el origen, se recomienda detener primero las escrituras para que Latency pueda acercarse a 0 y, a continuación, se inicia una transición.

La operación de transición aplica todos los cambios pendientes del origen al destino y completa la migración. Si desencadena una "Transición" incluso con un valor distinto de cero Latency,, la replicación se detiene hasta ese momento dado. Todos los datos del origen hasta el punto de transición se aplican al destino. Si experimenta una latencia de 15 minutos en el punto de transición, todos los datos modificados de los últimos 15 minutos se aplican al destino. El tiempo necesario depende del trabajo pendiente de los cambios realizados en los últimos 15 minutos. Por lo tanto, se recomienda que la latencia llegue a cero o cerca de cero, antes de desencadenar la transición.

• La migración pasa al estado de Succeeded cuando el subestado Migrating Data o la transición (en migración en línea) finaliza correctamente. Si hay un problema en el subestado Migrating Data, la migración pasa a un estado Failed.

Cancelación de la migración

Puede cancelar las validaciones o migraciones en curso. El flujo de trabajo debe estar en el estado inProgress que se va a cancelar. No se puede cancelar una validación o migración que esté en el estado Correcta o Errónea.

La cancelación de una validación detiene cualquier actividad de validación adicional y la validación pasa al estado de Cancelada.

La cancelación de una migración detiene aún más la actividad de migración en el servidor de destino y se mueve a un estado de Cancelada. No quita ni revierte ningún cambio en el servidor de destino. Asegúrese de anular las bases de datos en el servidor de destino implicadas en una migración cancelada.

En este artículo se explora el uso de la CLI de Azure para migrar la base de datos de PostgreSQL desde una máquina virtual de Azure o una instancia de PostgreSQL local a una instancia de Azure Database for PostgreSQL. La CLI de Azure proporciona una interfaz de línea de comandos eficaz y flexible que le permite realizar diversas tareas, incluida la migración de bases de datos. Siguiendo los pasos descritos en este artículo, puede transferir sin problemas la base de datos a Azure y aprovechar sus eficaces características y escalabilidad.

Para más información sobre la CLI de Azure con el servicio de migración, consulte Configuración de la CLI de Azure para el servicio de migración.

Una vez instalada la CLI, abra el símbolo del sistema e inicie sesión en la cuenta de Azure con el comando siguiente.

az login

Configuración de la tarea de migración

Para comenzar la migración, cree un archivo JSON con los detalles de la migración. El archivo JSON contiene la información siguiente:

• Edite los siguientes marcadores de posición << >> en las líneas JSON y almacénelos en el equipo local como <<filename>>.json donde se invoque la CLI. En este tutorial, hemos guardado el archivo en C:\migration-CLI\migration_body.json.

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "OnPremises",
        "sslMode": "Prefer"
    }
}

• Ejecute el comando siguiente para comprobar si hay migraciones en ejecución. El nombre de la migración es único en las migraciones en el destino de servidor flexible de Azure Database for PostgreSQL.

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

• En los pasos anteriores, no hay ninguna migración realizada, por lo que empezamos con la nueva migración ejecutando el siguiente comando.

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode online --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• Ejecute el siguiente comando para iniciar el estado de migración en el paso anterior. Para comprobar el estado de la migración, proporcione el nombre de la migración.

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• El estado del progreso de la migración se muestra en la CLI de Azure.

• También puede ver el estado del servidor flexible de Azure Database for PostgreSQL en Azure Portal.

• Puede cancelar cualquier intento de migración en curso mediante el comando cancel. Este comando detiene el intento de migración concreto y revierte todos los cambios en el servidor de destino. Aquí se muestra el comando de la CLI para eliminar una migración:

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

Transición

• Una vez completada la migración de datos base en migraciones en línea, la tarea de migración se mueve al subestado WaitingForCutoverTrigger. En este estado, el usuario puede desencadenar la transición a través de la CLI mediante el comando siguiente. También se puede desencadenar la transición desde el portal seleccionando el nombre de la migración en la cuadrícula de migración.

• También puede iniciar la transición desde Azure Portal.

  az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --cutover