Tutorial: migrar de Azure Database for PostgreSQL: servidor único a un servidor flexible con el servicio de migración

SE APLICA A: Azure Database for PostgreSQL con servidor flexible

Mediante Azure Portal, puede migrar una instancia de servidor único a una de servidor flexible de Azure Database for PostgreSQL. En este tutorial, migramos una base de datos de ejemplo de una instancia de servidor único de Azure Database for PostgreSQL a una instancia de servidor flexible de PostgreSQL mediante Azure Portal.

• Configuración de la instancia de servidor flexible de Azure Database for PostgreSQL
• Configuración de la tarea de migración
• Supervisión de la migración
• Cancelación de la migración
• Después de la migración

Portal

Puede realizar la migración mediante Azure Portal.

Offline

Requisitos previos (sin conexión)

Antes de iniciar la migración con el servicio de migración en Azure Database for PostgreSQL, debe cumplir los siguientes requisitos previos, que se aplican a escenarios de migración sin conexión.

Comprobación de la versión de origen

La versión de PostgreSQL de origen debe ser >= 9.5. Si la versión de PostgreSQL de origen es menor que 9.5, actualice la versión de PostgreSQL de origen a 9.5 o una superior antes de realizar la migración.

Configuración de destino

• El servidor flexible de Azure Database for PostgreSQL debe implementarse y configurarse correctamente en Azure antes de comenzar el proceso de migración.

• La SKU elegida para Azure Database for PostgreSQL debe corresponderse con las especificaciones de la base de datos de origen a fin de garantizar la compatibilidad y el rendimiento adecuado.

• Para obtener instrucciones detalladas sobre cómo crear una instancia de Azure Database for PostgreSQL, consulte el vínculo siguiente: Inicio rápido: Creación de un servidor.

Configuración de red

La configuración de red es fundamental para que el servicio de migración funcione correctamente. Asegúrese de que el servidor PostgreSQL de origen puede comunicarse con el servidor de Azure Database for PostgreSQL de destino. Las siguientes configuraciones de red son esenciales para una migración correcta.

Para obtener información sobre la configuración de red, visite Guía de red para el servicio de migración.

Habilitación de extensiones

Para asegurarse de que la migración se realiza correctamente usando el servicio de migración en Azure Database for PostgreSQL, es posible que tenga que comprobar las extensiones de la instancia de PostgreSQL de origen. Las extensiones proporcionan funcionalidad y características adicionales que podrían ser necesarias para la aplicación. Asegúrese de comprobar las extensiones en la instancia de PostgreSQL de origen antes de iniciar el proceso de migración.

Habilite las extensiones admitidas identificadas en la instancia de PostgreSQL de origen en la instancia de destino de Azure Database for PostgreSQL: servidor flexible.

Para obtener más información, consulte Extensiones de Azure Database for PostgreSQL.

Nota:

Cuando se producen cambios en el parámetro shared_preload_libraries, es necesario reiniciar.

Comprobación de los parámetros del servidor

Estos parámetros no se migran automáticamente al entorno de destino y deben configurarse manualmente.

• Haga coincidir los valores de parámetros del servidor de la base de datos de PostgreSQL de origen con Azure Database for PostgreSQL accediendo a la sección Parámetros de servidor de Azure Portal y actualizando manualmente los valores en consecuencia.

• Guarde los cambios del parámetro y, si es necesario, reinicie el servidor flexible de Azure Database for PostgreSQL para aplicar la nueva configuración.

Importante

Cambie el parámetro de servidor password_encryption en el servidor flexible de SCRAM-SHA-256 a MD5 antes de iniciar la migración. Esto es esencial para que las credenciales existentes en un solo servidor funcionen en el servidor flexible.

Deshabilitación de la alta disponibilidad (fiabilidad) y las réplicas de lectura en el destino

• Deshabilitar la alta disponibilidad (fiabilidad) y las réplicas de lectura en el entorno de destino es esencial. Estas características deben habilitarse solo una vez completada la migración.

• Al seguir estas instrucciones, puede ayudar a garantizar un proceso de migración sin las variables agregadas introducidas por la alta disponibilidad y las réplicas de lectura. Una vez que se completa la migración y la base de datos es estable, puede continuar con la habilitación de estas características para mejorar la disponibilidad y escalabilidad del entorno de base de datos en Azure.

Configuración de la instancia de servidor flexible de Azure Database for PostgreSQL

• Cree el servidor flexible de destino. Para ver los pasos guiados, consulte el inicio rápido Creación de una instancia de servidor flexible de Azure Database for PostgreSQL con el portal.

• Agregue a la lista de permitidos las extensiones cuyas bibliotecas deben cargarse al iniciar el servidor. Es esencial que la extensión esté en la lista de permitidos antes de iniciar una migración.

• Compruebe si la distribución de datos entre las tablas de una base de datos es asimétrica con la mayoría de los datos presentes en una sola (o pocas) tablas. Si está sesgada, la velocidad de migración podría ser más lenta de lo esperado. En este caso, la velocidad de migración se puede aumentar mediante la migración en paralelo de la tabla grande.

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. Para iniciar sesión, escriba sus credenciales. 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 la opción Migración y selecciónela.

   

4. Seleccione el botón Crear para iniciar una migración de un servidor único a un 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 del servidor flexible, la cuadrícula contiene información sobre las migraciones que se intentaron para este destino desde el servidor único.

5. Puede pasar por una serie de pestañas basadas en el asistente para crear una migración a este destino de Servidor flexible desde diferentes orígenes posibles. De forma predeterminada, Tipo de servidor de origen se establece en Servidor único de Azure Database for PostgreSQL, que es el que nos interesa en este escenario.

Como alternativa, puede iniciar el proceso de migración desde el servidor único de Azure Database for PostgreSQL.

1. Abra el explorador web y vaya al portal. Para iniciar sesión, debe escribir sus credenciales. La vista predeterminada es el panel del servicio.

2. Al seleccionar el servidor único, puede observar un banner relacionado con la migración en la pestaña Información general. Seleccione Migrar ahora para empezar.

   

3. Se le remite a una página con dos opciones. Si ya ha creado un Servidor flexible y quiere usarlo como destino, elija Seleccionar existente y seleccione los detalles correspondientes de Suscripción, Grupo de recursos y Nombre del servidor. Una vez realizadas las selecciones, seleccione Ir al asistente para la migración y siga las instrucciones de la sección Configuración.

   

4. Si elige crear un Servidor flexible, seleccione Crear nuevo y seleccione Ir al Asistente para crear. Esta acción le guía por el proceso de creación del servidor flexible e implementa el servidor flexible.

   

Después de implementar el servidor flexible, siga los pasos del 3 al 5 en Configuración de la tarea de migración.

Configurar

La primera pestaña es Configuración. En caso de que se lo haya perdido, agregar a la lista de permitidos las extensiones necesarias, tal como se describe en Configuración del servidor flexible de Azure Database for PostgreSQL, antes de iniciar una migración.

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 y no acepta caracteres especiales excepto el subrayado (_) y el guión (-). El nombre debe comenzar con un carácter alfanumérico. El nombre también debe ser único para un servidor de destino, ya que ninguna migración al mismo destino del Servidor flexible puede tener el mismo nombre.

El valor de Tipo de servidor de origen indica el origen. En este caso, es un servidor único de Azure Database for PostgreSQL

La 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 la migración.
• 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ónValidar o Validar y migrar para realizar validaciones previas a la migración antes de ejecutar la migración.

Modo de migración permite elegir entre una migración en línea y sin conexión, en este caso debe establecerse en Sin conexión.

Seleccione el botón Siguiente: Seleccionar servidor en tiempo de ejecución.

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.

Seleccione el botón Siguiente: Conectar al origen.

Conectar a origen

La sección Origen le pide que proporcione detalles relacionados con el servidor único que es el origen de las bases de datos.

Después de realizar las selecciones Suscripción y Grupo de recursos, la lista desplegable de nombres de servidor muestra los servidores únicos en ese grupo de recursos entre regiones. Seleccione el origen des de el que quiere migrar las bases de datos. Puede migrar bases de datos de un servidor único a un servidor flexible de destino en la misma región. Las migraciones entre regiones solo están habilitadas para servidores en India, China y Emiratos Árabes Unidos.

Después de elegir el origen de Servidor único, los cuadros de Ubicación y Versión de PostgreSQL se rellenan automáticamente. Asegúrese de proporcionar las credenciales de un rol de administrador, ya que es necesario para que el servicio de migración migre correctamente las bases de datos.

El campo FQDN/IP personalizado es opcional y se puede usar cuando el origen 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 singleserver.example.com, 198.1.0.2, o un FQDN de PostgreSQL como singleserver.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.

Después de rellenar todos los campos, seleccione el vínculo Conectar al origen. Esta acción valida que los detalles del servidor de origen especificados sean correctos y que se pueda acceder al servidor de origen.

Seleccione el botón Siguiente: Seleccionar destino de migración para continuar.

Selección del destino de migración

En la sección Seleccionar destino de migración se muestran los metadatos del destino del Servidor flexible, como Suscripción, Grupo de recursos, Nombre del servidor, Ubicación y Versión de PostgreSQL.

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.

Elija los valores adecuados para Método de autenticación y todos los campos relacionados con la autenticación. Asegúrese de que la identidad proporcionada es la del usuario administrador en el servidor de destino. Después de rellenar toda la información necesaria, seleccione el vínculo Conectar al destino. Esta acción valida que los detalles del servidor de destino especificados sean correctos y que se pueda acceder al servidor de destino.

Seleccione el botón Siguiente: Seleccionar bases de datos para la migración para seleccionar las bases de datos que se van a migrar.

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

En esta pestaña, hay una lista de bases de datos de usuario dentro del servidor único. 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. Las bases de datos seleccionadas que existen en el servidor de destino con los mismos nombres exactos se sobrescriben.

Seleccione el botón Siguiente: Resumen para revisar los detalles.

Resumen

En la pestaña Resumen se sintetizan todos los detalles para crear la validación o la migración. Revise los detalles y seleccione el botón Iniciar la validación y la migración.

Supervisar el portal de migración

Después de iniciar la migración, aparece una notificación para indicar que la validación o la creación de la migración se han realizado correctamente. Se le redirige automáticamente a la página Migración del servidor flexible. Tiene una nueva entrada para la validación o migración creada recientemente.

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, Hora de inicio y Duración. 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.

También puede seleccionar el nombre de una migración determinada 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.

Veamos cómo supervisar las migraciones para cada opción de migración.

Validación

Una vez completado el subestado PerformingPreRequisiteSteps, la validación pasa al subestado Validación en curso, donde se realizan comprobaciones en el servidor de origen y de destino para evaluar la preparación para la migración.

La validación pasa al estado de Correcto si todas las validaciones están en estado Correcto o Advertencia.

La cuadrícula de validación tiene la siguiente información:

• Secciones Detalles de validación para la instancia y Detalles de validación para bases de datos que representan las reglas de validación usadas para comprobar la preparación de la migración.
• Nombre de validación: el nombre de cada regla de validación específica.
• Estado de validación: representa el resultado de cada regla y puede tener cualquiera de los tres valores:
  • Correcto: si no se encontraron errores.
  • Error: si hay errores de validación.
  • Advertencia:: si hay advertencias de validación.
• Duración: tiempo necesario para la operación de validación.
• Hora de inicio (UTC) y Hora de finalización (UTC): hora de inicio y finalización de la operación de validación en UTC.

El estado de validación pasa a Con errores si se ha producido algún problema. Seleccione el Nombre de la validación o la validación Nombre de la base de datos en la que se ha producido el error y un panel de distribución ramificada proporcionará los detalles y la acción correctiva que debe realizar para evitar este error.

Migrate

Una vez completado el subestado PerformingPreRequisiteSteps, la migración pasa al subestado MigratingData, que es cuando se realiza la clonación o la copia de las bases de datos. El tiempo que tarda en completarse la migración depende del tamaño y la forma de las bases de datos que migre. La migración es rápida si los datos se distribuyen principalmente de forma uniforme en todas las tablas. Los tamaños de tablas sesgadas tardan un tiempo relativamente más largo.

Al seleccionar cualquiera de las bases de datos en la migración, aparece un panel de distribución ramificada. Tiene todos los recuentos de tablas (copiados, en cola, copiando y errores) y también el estado de migración de la base de datos.

La migración pasa al estado Correcto cuando el estado MigratingData se completa correctamente. Si hay algún problema en el subestado MigratingData, la migración pasa a un estado Error.

Una vez que la migración pasa al estado Correcto, se completa la migración del esquema y los datos del servidor único al destino del servidor flexible. Puede actualizar la página para comprobar el progreso.

Validar y migrar

En esta opción, 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.

Podrá ver los resultados de Validar y migrar una vez completada la operación.

En línea

Requisitos previos (en línea)

Antes de iniciar la migración con el servicio de migración en Azure Database for PostgreSQL, es fundamental cumplir con los siguientes requisitos previos que se aplican a escenarios de migración sin conexión.

Comprobación de la versión de origen

La versión de PostgreSQL de origen debe ser >= 9.5. Si la versión de PostgreSQL de origen es menor que 9.5, actualice la versión de PostgreSQL de origen a 9.5 o una superior antes de realizar la migración.

Configuración de parámetros de migración en línea

Para la migración en línea, la compatibilidad de replicación debe establecerse en Lógico en la configuración de replicación del servidor PostgreSQL de origen. Además, los parámetros de servidor max_wal_senders y max_replication_slots valores deben ser más que el número de bases de datos que deben migrarse. Los parámetros se pueden establecer en Azure Portal en Configuración:>Parámetros del servidor o configurados en la línea de comandos mediante los siguientes comandos:

• ALTER SYSTEM SET wal_level = logical;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Asegúrese de que no hay transacciones de larga duración. Las transacciones de larga duración no permiten la creación de ranuras de replicación. La creación de una ranura de replicación se realizará correctamente si todas las transacciones de larga duración se confirman o se revierten. Tendrá que reiniciar el servidor PostgreSQL de origen después de completar todos los requisitos previos de migración en línea.

Nota:

Para la migración en línea con un servidor único de Azure Database for PostgreSQL, la compatibilidad con la replicación de Azure se establece en Lógico en la configuración de replicación de la página de servidor único en Azure Portal.

Para evitar que la migración en línea se quede sin almacenamiento para almacenar los registros, asegúrese de que dispone de suficiente espacio de espacio de tablas utilizando un disco administrado aprovisionado. Para ello, deshabilite el parámetro de servidor azure.enable_temp_tablespaces_on_local_ssd en el servidor flexible durante la migración y restáurelo al estado original después de la migración.

Configuración del destino

• Azure Database for PostgreSQL debe configurarse en Azure antes de la migración.

• La SKU elegida para Azure Database for PostgreSQL debe corresponderse con las especificaciones de la base de datos de origen a fin de garantizar la compatibilidad y el rendimiento adecuado.

• Para obtener instrucciones detalladas sobre cómo crear una instancia de Azure Database for PostgreSQL, consulte el vínculo siguiente: Inicio rápido: Creación de un servidor.

• El parámetro de servidormax_replication_slots debe ser mayor que el número de bases de datos que deben migrarse. Se puede establecer en Azure Portal en Configuración:>Parámetros del servidor o configurados en la línea de comandos mediante el siguiente comando:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Importante

Cambie el parámetro de servidor password_encryption en el servidor flexible de SCRAM-SHA-256 a MD5 antes de iniciar la migración. Esto es esencial para que las credenciales existentes en un solo servidor funcionen en el servidor flexible.

Configuración de red

La configuración de red es fundamental para que el servicio de migración funcione correctamente. Asegúrese de que el servidor PostgreSQL de origen puede comunicarse con el servidor de Azure Database for PostgreSQL de destino. Las siguientes configuraciones de red son esenciales para una migración correcta.

Para obtener información sobre la configuración de red, visite Guía de red para el servicio de migración.

Habilitación de extensiones

Para asegurarse de que la migración se realiza correctamente usando el servicio de migración en Azure Database for PostgreSQL, es posible que tenga que comprobar las extensiones de la instancia de PostgreSQL de origen. Las extensiones proporcionan funcionalidad y características adicionales que podrían ser necesarias para la aplicación. Asegúrese de comprobar las extensiones en la instancia de PostgreSQL de origen antes de iniciar el proceso de migración.

Habilite las extensiones admitidas identificadas en la instancia de PostgreSQL de origen en la instancia de destino de Azure Database for PostgreSQL: servidor flexible.

Para obtener más información, consulte Extensiones de Azure Database for PostgreSQL.

Nota:

Cuando se producen cambios en el parámetro shared_preload_libraries, es necesario reiniciar.

Parámetros del servidor

Estos parámetros no se migran automáticamente al entorno de destino y deben configurarse manualmente.

• Haga coincidir los valores de parámetros del servidor de la base de datos de PostgreSQL de origen con Azure Database for PostgreSQL; para ello, acceda a la sección "Parámetros del servidor" en Azure Portal y actualice manualmente los valores según corresponda.

• Guarde los cambios de los parámetros y reinicie Azure Database for PostgreSQL para aplicar la nueva configuración si es necesario.

Deshabilitación de la alta disponibilidad (fiabilidad) y las réplicas de lectura en el destino

• Deshabilitar la alta disponibilidad (fiabilidad) y las réplicas de lectura en el entorno de destino es esencial. Estas características deben habilitarse solo una vez completada la migración.

• Al seguir estas instrucciones, puede ayudar a garantizar un proceso de migración fluido sin las variables agregadas que introducen la alta disponibilidad y las réplicas de lectura. Una vez que se completa la migración y la base de datos es estable, puede continuar con la habilitación de estas características para mejorar la disponibilidad y escalabilidad del entorno de base de datos en Azure.

Nota:

Se aplican algunas limitaciones a la migración en línea, que se documenta aquí. Asegúrese de que la base de datos sea compatible para ejecutar una migración en línea.

Configuración de la instancia de servidor flexible de Azure Database for PostgreSQL

• Cree el servidor flexible de destino. Para ver los pasos guiados, consulte el inicio rápido Creación de una instancia de servidor flexible de Azure Database for PostgreSQL con el portal.

• Agregue a la lista de permitidos las extensiones cuyas bibliotecas deben cargarse al iniciar el servidor. Es esencial que la extensión esté en la lista de permitidos antes de iniciar una migración.

• Compruebe si la distribución de datos entre las tablas de una base de datos es asimétrica con la mayoría de los datos presentes en una sola (o pocas) tablas. Si está sesgada, la velocidad de migración podría ser más lenta de lo esperado. En este caso, la velocidad de migración se puede aumentar mediante la migración en paralelo de la tabla grande.

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. Para iniciar sesión, escriba sus credenciales. 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 la opción Migración y selecciónela.

   

4. Seleccione el botón Crear para iniciar una migración de un servidor único a un 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 del servidor flexible, la cuadrícula contiene información sobre las migraciones que se intentaron para este destino desde el servidor único.

5. Puede pasar por una serie de pestañas basadas en el asistente para crear una migración a este destino de Servidor flexible desde diferentes orígenes posibles. De forma predeterminada, Tipo de servidor de origen se establece en Servidor único de Azure Database for PostgreSQL, que es el que nos interesa en este escenario.

Como alternativa, puede iniciar el proceso de migración desde el servidor único de Azure Database for PostgreSQL.

1. Abra el explorador web y vaya al portal. Para iniciar sesión, debe escribir sus credenciales. La vista predeterminada es el panel del servicio.

2. Al seleccionar el servidor único, puede observar un banner relacionado con la migración en la pestaña Información general. Seleccione Migrar ahora para empezar.

   

3. Se le remite a una página con dos opciones. Si ya ha creado un Servidor flexible y quiere usarlo como destino, elija Seleccionar existente y seleccione los detalles correspondientes de Suscripción, Grupo de recursos y Nombre del servidor. Una vez realizadas las selecciones, seleccione Ir al asistente para la migración y siga las instrucciones de la sección Configuración.

   

4. Si elige crear un Servidor flexible, seleccione Crear nuevo y seleccione Ir al Asistente para crear. Esta acción le guía por el proceso de creación del servidor flexible e implementa el servidor flexible.

   

Después de implementar el servidor flexible, siga los pasos del 3 al 5 en Configuración de la tarea de migración.

Configurar

La primera pestaña es Configuración. En caso de que se lo haya perdido, agregar a la lista de permitidos las extensiones necesarias, tal como se describe en Configuración del servidor flexible de Azure Database for PostgreSQL, antes de iniciar una migración.

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 y no acepta caracteres especiales excepto el subrayado (_) y el guión (-). El nombre debe comenzar con un carácter alfanumérico. El nombre también debe ser único para un servidor de destino, ya que ninguna migración al mismo destino del Servidor flexible puede tener el mismo nombre.

El valor de Tipo de servidor de origen indica el origen. En este caso, es un servidor único de Azure Database for PostgreSQL

La 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 la migración.
• 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ónValidar o Validar y migrar para realizar validaciones previas a la migración antes de ejecutar la migración.

Modo de migración permite elegir entre una migración en línea y sin conexión, en este caso debe establecerse en Conectado.

Cuando se selecciona el modo de migración Conectado, la replicación lógica debe estar activada en el Servidor único de origen. Si no está activado, el servicio de migración activa automáticamente la replicación lógica en el servidor único de origen. La replicación también se puede configurar manualmente seleccionando el elemento Replicación, en Configuración en el menú de recursos del Servidor único y estableciendo Compatibilidad con la replicación de Azure en LÓGICO. Cualquiera de los enfoques reinicia el servidor único de origen.

Seleccione el botón Siguiente: Seleccionar servidor en tiempo de ejecución.

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.

Seleccione el botón Siguiente: Conectar al origen.

Conectar a origen

La sección Origen le pide que proporcione detalles relacionados con el servidor único que es el origen de las bases de datos.

Después de realizar las selecciones Suscripción y Grupo de recursos, la lista desplegable de nombres de servidor muestra los servidores únicos en ese grupo de recursos entre regiones. Seleccione el origen des de el que quiere migrar las bases de datos. Puede migrar bases de datos de un servidor único a un servidor flexible de destino en la misma región. Las migraciones entre regiones solo están habilitadas para servidores en India, China y Emiratos Árabes Unidos.

Después de elegir el origen de Servidor único, los cuadros de Ubicación y Versión de PostgreSQL se rellenan automáticamente. Asegúrese de proporcionar las credenciales de un rol de administrador, ya que es necesario para que el servicio de migración migre correctamente las bases de datos.

Después de rellenar todos los campos, seleccione el vínculo Conectar al origen. Esta acción valida que los detalles del servidor de origen especificados sean correctos y que se pueda acceder al servidor de origen.

Seleccione el botón Siguiente: Seleccionar destino de migración para continuar.

Selección del destino de migración

En la sección Seleccionar destino de migración se muestran los metadatos del destino del Servidor flexible, como Suscripción, Grupo de recursos, Nombre del servidor, Ubicación y Versión de PostgreSQL.

Elija los valores adecuados para Método de autenticación y todos los campos relacionados con la autenticación. Asegúrese de que la identidad proporcionada es la del usuario administrador en el servidor de destino. Después de rellenar toda la información necesaria, seleccione el vínculo Conectar al destino. Esta acción valida que los detalles del servidor de destino especificados sean correctos y que se pueda acceder al servidor de destino.

Seleccione el botón Siguiente: Seleccionar bases de datos para la migración para seleccionar las bases de datos que se van a migrar.

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

En esta pestaña, hay una lista de bases de datos de usuario dentro del servidor único. 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. Las bases de datos seleccionadas que existen en el servidor de destino con los mismos nombres exactos se sobrescriben.

Seleccione el botón Siguiente: Resumen para revisar los detalles.

Resumen

En la pestaña Resumen se sintetizan todos los detalles para crear la validación o la migración. Revise los detalles y seleccione el botón Iniciar la validación y la migración.

Supervisar el portal de migración

Después de iniciar la migración, aparece una notificación para indicar que la validación o la creación de la migración se han realizado correctamente. Se le redirige automáticamente a la página Migración del servidor flexible. Tiene una nueva entrada para la validación o migración creada recientemente.

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, Hora de inicio y Duración. 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.

También puede seleccionar el nombre de una migración determinada 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.

Veamos cómo supervisar las migraciones para cada opción de migración.

Validación

Una vez completado el subestado PerformingPreRequisiteSteps, la validación pasa al subestado Validación en curso, donde se realizan comprobaciones en el servidor de origen y de destino para evaluar la preparación para la migración.

La validación pasa al estado de Correcto si todas las validaciones están en estado Correcto o Advertencia.

La cuadrícula de validación tiene la siguiente información:

• Secciones Detalles de validación para la instancia y Detalles de validación para bases de datos que representan las reglas de validación usadas para comprobar la preparación de la migración.
• Nombre de validación: el nombre de cada regla de validación específica.
• Estado de validación: representa el resultado de cada regla y puede tener cualquiera de los tres valores:
  • Correcto: si no se encontraron errores.
  • Error: si hay errores de validación.
  • Advertencia:: si hay advertencias de validación.
• Duración: tiempo necesario para la operación de validación.
• Hora de inicio (UTC) y Hora de finalización (UTC): hora de inicio y finalización de la operación de validación en UTC.

El estado de validación pasa a Con errores si se ha producido algún problema. Seleccione el Nombre de la validación o la validación Nombre de la base de datos en la que se ha producido el error y un panel de distribución ramificada proporcionará los detalles y la acción correctiva que debe realizar para evitar este error.

Migrate

Una vez completado el subestado PerformingPreRequisiteSteps, la migración pasa al subestado MigratingData, que es cuando se realiza la clonación o la copia de las bases de datos. El tiempo que tarda en completarse la migración depende del tamaño y la forma de las bases de datos que migre. La migración es rápida si los datos se distribuyen principalmente de forma uniforme en todas las tablas. Los tamaños de tablas sesgadas tardan un tiempo relativamente más largo.

Al seleccionar cualquiera de las bases de datos en la migración, aparece un panel de distribución ramificada. Tiene todos los recuentos de tablas (copiados, en cola, copiando y errores) y también el estado de migración de la base de datos.

La migración pasa al estado Correcto cuando el estado MigratingData se completa correctamente. Si hay algún problema en el subestado MigratingData, la migración pasa a un estado Error.

Una vez que la migración pasa al estado Correcto, se completa la migración del esquema y los datos del servidor único al destino del servidor flexible. Puede actualizar la página para comprobar el progreso.

Validar y migrar

En esta opción, 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.

Podrá ver los resultados de Validar y migrar una vez completada la operación.

Migración total

Para Migrar y las opciones de migración de Validar y migrar, la finalización de la migración en línea requiere que el usuario complete un paso adicional, que consiste en desencadenar la 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 el subestado `WaitingForCutoverTrigger. En este estado, el usuario puede desencadenar la transición desde el portal seleccionando la migración y seleccionando el botón Transición.

Antes de iniciar la transición, es esencial asegurarse de que:

• Las escrituras en el origen se detienen: el parámetro Latency (minutes) es 0 o cerca de 0 La información de Latency (minutes) se puede obtener en la pantalla de detalles de la migración:

El parámetro Latency (minutes) indica cuándo el destino se sincronice por última vez con el origen. Por ejemplo, para la base de datos Pedidos anterior, es 0,33333. Significa que los cambios que se produjeron en los últimos 0,3 minutos en el origen todavía se van a enviar al destino, para la base de datos Pedidos. En este momento, las escrituras en el origen se pueden detener e iniciar la transición. En caso de que haya tráfico pesado en el origen, se recomienda detener primero las escrituras para que Latency (minutes) pueda acercarse a 0 y, a continuación, iniciar la 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 latencia distinta de cero, la replicación se detiene hasta ese momento dado. Todos los datos del origen hasta el punto de transición se aplican al destino. Suponiendo una latencia de 15 minutos en el punto de transición, todos los datos modificados en 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 sea cero o cerca de cero, antes de desencadenar la transición.

La migración pasa al estado de Correcto en cuanto el subestado Migración de datos o la transición (en modo de migración en línea) finaliza correctamente. Si hay un problema en el subestado Migración de datos, la migración pasa a un estado Erróneo.

Los posibles estados de migración incluyen:

• InProgress: la infraestructura de migración se está configurando o la migración de datos en sí está en curso.
• Cancelada: la migración se ha cancelado o eliminado.
• Error: se han producido errores en la migración.
• Error de validación: se ha producido un error en la validación.
• Correcto: la migración se ha realizado correctamente y se ha completado.

Los posibles subestados de migración incluyen:

• PerformingPreRequisiteSteps: la infraestructura se está configurando para la migración de datos.
• Validación en curso: la validación está en curso.
• MigratingData: la migración de datos está en curso.
• CompletingMigration: la migración está en las últimas fases de finalización.
• Completada: la migración se ha completado correctamente.

Cancelación de la migración mediante el portal

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. La acción cancelar revertirá todos los cambios realizados por el servicio de migración en el servidor de destino.

CLI

Puede realizar la migración mediante la CLI de Azure.

Offline

Requisitos previos (sin conexión)

Antes de iniciar la migración con el servicio de migración en Azure Database for PostgreSQL, debe cumplir los siguientes requisitos previos, que se aplican a escenarios de migración sin conexión.

Comprobación de la versión de origen

La versión de PostgreSQL de origen debe ser >= 9.5. Si la versión de PostgreSQL de origen es menor que 9.5, actualice la versión de PostgreSQL de origen a 9.5 o una superior antes de realizar la migración.

Configuración de destino

• El servidor flexible de Azure Database for PostgreSQL debe implementarse y configurarse correctamente en Azure antes de comenzar el proceso de migración.

• La SKU elegida para Azure Database for PostgreSQL debe corresponderse con las especificaciones de la base de datos de origen a fin de garantizar la compatibilidad y el rendimiento adecuado.

• Para obtener instrucciones detalladas sobre cómo crear una instancia de Azure Database for PostgreSQL, consulte el vínculo siguiente: Inicio rápido: Creación de un servidor.

Configuración de red

La configuración de red es fundamental para que el servicio de migración funcione correctamente. Asegúrese de que el servidor PostgreSQL de origen puede comunicarse con el servidor de Azure Database for PostgreSQL de destino. Las siguientes configuraciones de red son esenciales para una migración correcta.

Para obtener información sobre la configuración de red, visite Guía de red para el servicio de migración.

Habilitación de extensiones

Para asegurarse de que la migración se realiza correctamente usando el servicio de migración en Azure Database for PostgreSQL, es posible que tenga que comprobar las extensiones de la instancia de PostgreSQL de origen. Las extensiones proporcionan funcionalidad y características adicionales que podrían ser necesarias para la aplicación. Asegúrese de comprobar las extensiones en la instancia de PostgreSQL de origen antes de iniciar el proceso de migración.

Habilite las extensiones admitidas identificadas en la instancia de PostgreSQL de origen en la instancia de destino de Azure Database for PostgreSQL: servidor flexible.

Para obtener más información, consulte Extensiones de Azure Database for PostgreSQL.

Nota:

Cuando se producen cambios en el parámetro shared_preload_libraries, es necesario reiniciar.

Comprobación de los parámetros del servidor

Estos parámetros no se migran automáticamente al entorno de destino y deben configurarse manualmente.

• Haga coincidir los valores de parámetros del servidor de la base de datos de PostgreSQL de origen con Azure Database for PostgreSQL accediendo a la sección Parámetros de servidor de Azure Portal y actualizando manualmente los valores en consecuencia.

• Guarde los cambios del parámetro y, si es necesario, reinicie el servidor flexible de Azure Database for PostgreSQL para aplicar la nueva configuración.

Importante

Cambie el parámetro de servidor password_encryption en el servidor flexible de SCRAM-SHA-256 a MD5 antes de iniciar la migración. Esto es esencial para que las credenciales existentes en un solo servidor funcionen en el servidor flexible.

Deshabilitación de la alta disponibilidad (fiabilidad) y las réplicas de lectura en el destino

• Deshabilitar la alta disponibilidad (fiabilidad) y las réplicas de lectura en el entorno de destino es esencial. Estas características deben habilitarse solo una vez completada la migración.

• Al seguir estas instrucciones, puede ayudar a garantizar un proceso de migración sin las variables agregadas introducidas por la alta disponibilidad y las réplicas de lectura. Una vez que se completa la migración y la base de datos es estable, puede continuar con la habilitación de estas características para mejorar la disponibilidad y escalabilidad del entorno de base de datos en Azure.

Introducción

1. Si no está familiarizado con Microsoft Azure, cree una cuenta para evaluar las ofertas.

2. Instale la CLI de Azure más reciente para el sistema operativo en la página de instalación de la CLI de Azure.

   Si la CLI de Azure ya está instalada, compruebe la versión mediante el comando az version. La versión debe ser la 2.50.0 o posterior para usar los comandos de la CLI de migración. Si no, actualice la versión de la CLI de Azure.

3. Ejecute el comando az login:

   az login
   

   Se abre una ventana del explorador con la página de inicio de sesión de Azure. Proporcione las credenciales de Azure para realizar una autenticación correcta. Para ver otras formas de iniciar sesión con la CLI de Azure, consulte este artículo.

Comandos de la CLI de migración (sin conexión)

El servicio de migración incluye unos comandos de la CLI fáciles de usar para realizar tareas relacionadas con la migración. Todos los comandos de la CLI comienzan por az postgres flexible-server migration. Es importante agregar a la lista de permitidos las extensiones antes de iniciar una migración.

Para obtener ayuda para comprender las opciones asociadas a un comando y con enmarcar la sintaxis correcta, puede usar el parámetro --help:

az postgres flexible-server migration --help

La ejecución del comando anterior devuelve la siguiente salida:

La salida muestra los comandos de migración admitidos, junto con sus acciones. Examinemos más de cerca estos comandos.

Creación de una migración mediante la CLI de Azure

El comando create ayuda a crear una migración de un servidor de origen a un servidor de destino:

az postgres flexible-server migration create --help

La ejecución del comando anterior devuelve la siguiente salida:

Indica los argumentos esperados y tiene una sintaxis de ejemplo para crear una migración correcta del servidor de origen al servidor de destino. Este es el comando de la CLI para crear una migración nueva:

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

Parámetro	Descripción
subscription	Identificador de suscripción del servidor flexible de destino.
resource-group	Grupo de recursos del servidor flexible de destino.
name	Nombre del servidor flexible de destino.
migration-name	Identificador único para cada migración a este destino del Servidor flexible. Este campo solo acepta caracteres alfanuméricos y no acepta caracteres especiales excepto el subrayado (_) y el guión (-). El nombre debe comenzar y terminar con un carácter alfanumérico. El nombre también debe ser único para un servidor de destino, ya que ninguna migración al mismo destino del Servidor flexible puede tener el mismo nombre.
migration-mode	Se trata de un parámetro opcional. Valor predeterminado: Sin conexión. La migración sin conexión implica copiar las bases de datos de origen en un momento dado en el servidor de destino.
properties	Ruta de acceso absoluta a un archivo JSON, que tiene la información sobre el servidor único de origen.

Por ejemplo:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode offline

El argumento migration-name usado en el comando create se empleará en otros comandos de la CLI, como update, delete y show. Identifica de forma única el intento de migración en las acciones correspondientes en todos esos comandos.

Finalmente, el comando create necesita que se indique un archivo JSON como parte del argumento properties.

La estructura del JSON es:

{
	"properties": {
		"sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
		"secretParameters": {
			"adminCredentials": {
				"sourceServerPassword": "<password>",
				"targetServerPassword": "<password>"
			},
			"sourceServerUserName": "<username>@<servername>",
			"targetServerUserName": "<username>"
		},
		"dbsToMigrate": [
			"<db1>",
			"<db2>"
		],
		"overwriteDbsInTarget": "true"
	}
}

Los parámetros create que se indican en el formato de archivo JSON se muestran a continuación:

Parámetro	Tipo	Descripción
sourceDbServerResourceId	Obligatorio	Este parámetro es el identificador de recurso del origen del Servidor único.
adminCredentials	Obligatorio	Este parámetro enumera las contraseñas de los usuarios administradores para el servidor único de origen y el servidor flexible de destino. Estas contraseñas ayudan a autenticarse en los servidores de origen y de destino.
sourceServerUserName	Obligatorio	El valor predeterminado es el usuario administrador especificado durante la creación de un único servidor y la contraseña proporcionada se usa para la autenticación con este usuario. Si no usa el usuario predeterminado, este parámetro es el usuario o rol del servidor de origen para realizar la migración. Este usuario debe tener privilegios y propiedad necesarios de los objetos de base de datos implicados en la migración y debe ser miembro de rol azure_pg_admin.
targetServerUserName	Obligatorio	El valor predeterminado es el usuario administrador creado durante la creación de un servidor flexible y la contraseña proporcionada se usa para la autenticación con este usuario. En caso de que no use el usuario predeterminado, este parámetro es el usuario o rol del servidor de destino que se usa para realizar la migración. Este usuario debe ser miembro de los roles azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables y debe tener los atributos Crear rol, Crear base de datos.
dbsToMigrate	Obligatorio	Especifique la lista de bases de datos que quiere migrar al servidor flexible. Solo se migran las bases de datos de usuario. Las bases de datos del sistema o las bases de datos de plantilla, como template0 y template1, no se migran.
overwriteDbsInTarget	Obligatorio	Cuando se establece en true, si el servidor de destino tiene una base de datos existente con el mismo nombre que la que intenta migrar, el servicio de migración sobrescribe automáticamente la base de datos.
setupLogicalReplicationOnSourceDBIfNeeded	Opcionales	Puede habilitar automáticamente la replicación lógica en el servidor de origen estableciendo esta propiedad en true. Este cambio en la configuración del servidor requiere un reinicio del servidor con dos o tres minutos de tiempo de inactividad.
sourceDBServerFullyQualifiedDomainName	Opcionales	Se usa cuando se emplea un servidor DNS personalizado para la resolución de nombres de una red virtual. Proporcione el FQDN de servidor único de origen según el servidor DNS personalizado para esta propiedad.
targetDBServerFullyQualifiedDomainName	Opcional	Se usa cuando se emplea un servidor DNS personalizado para la resolución de nombres dentro de una red virtual. Proporcione el FQDN del servidor flexible de destino según el servidor DNS personalizado. sourceDBServerFullyQualifiedDomainName y targetDBServerFullyQualifiedDomainName se incluyen como parte del archivo JSON solo en el caso excepcional de que para la resolución de nombres se use un servidor DNS personalizado en lugar del servidor DNS proporcionado por Azure. De lo contrario, no incluya estos parámetros en el archivo JSON.

Tenga en cuenta estos puntos esenciales para la respuesta del comando:

• Cuando se desencadena el comando create, la migración pasa al estado InProgress y al subestado PerformingPreRequisiteSteps. El flujo de trabajo de migración tarda unos minutos en implementar la infraestructura de migración y configurar las conexiones entre el origen y el destino.
• Una vez completado el subestado PerformingPreRequisiteSteps, la migración pasa al sustrato de Migrating Data,, donde se realizan la clonación y la copia de las bases de datos.
• Cada base de datos migrada tiene su propia sección con todos los detalles de migración, como el recuento de tablas, las inserciones incrementales, las eliminaciones y los bytes pendientes.
• El tiempo que tarda el subestado Migrating Data en finalizar depende del tamaño de las bases de datos migradas.
• La migración cambia al estado Succeeded en cuanto el subestado Migrating Data finaliza correctamente. Si hay un problema en el subestado Migrating Data, la migración pasa a un estado Failed.

Enumerar las migraciones

El comando list muestra todos los intentos de migración realizados en un servidor flexible de destino.

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

El parámetro filter tiene dos opciones:

• Active: muestra los intentos de migración activos (en curso) actuales en el servidor de destino. No se incluyen las migraciones con errores, ni las que se han cancelado o completado correctamente.
• All: enumera todos los intentos de migración al servidor de destino. Esto incluye las migraciones activas y completadas, independientemente del estado.

Para más información sobre este comando, use el parámetro --help:

az postgres flexible-server migration list --help

Supervisión de la migración

El comando --show ayuda a supervisar las migraciones en curso y proporciona el estado actual y el subestado de la migración.

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

El parámetro migration_name es el nombre asignado a la migración durante el comando create. Esta es una instantánea de la respuesta de ejemplo del comando de la CLI para mostrar los detalles:

Para más información sobre este comando, use el parámetro --help:

 az postgres flexible-server migration show --help

En las tablas siguientes se describen los estados de migración y los subestados.

Estado de la migración	Descripción
InProgress	La infraestructura de migración se ha configurado o la migración de datos real está en curso.
Canceled	La migración se ha cancelado o eliminado.
Failed	Se produjeron errores en la migración.
Succeeded	La migración se ha realizado correctamente y se ha completado.
ValidationFailed	Error en la migración durante la validación previa a la migración.

Subestados de la migración	Descripción
PerformingPreRequisiteSteps	La infraestructura está configurada y está preparada para la migración de datos.
MigratingData	La migración de datos está en curso.
CompletingMigration	Finalización del proceso de migración.
Completed	La migración se ha completado, ya sea en un estado correcto o no.
CancelingRequestedDBMigrations	Cancelación de la migración.
ValidationInProgress	Validación en curso.

En línea

Requisitos previos (en línea)

Antes de iniciar la migración con el servicio de migración en Azure Database for PostgreSQL, es fundamental cumplir con los siguientes requisitos previos que se aplican a escenarios de migración sin conexión.

Comprobación de la versión de origen

La versión de PostgreSQL de origen debe ser >= 9.5. Si la versión de PostgreSQL de origen es menor que 9.5, actualice la versión de PostgreSQL de origen a 9.5 o una superior antes de realizar la migración.

Configuración de parámetros de migración en línea

Para la migración en línea, la compatibilidad de replicación debe establecerse en Lógico en la configuración de replicación del servidor PostgreSQL de origen. Además, los parámetros de servidor max_wal_senders y max_replication_slots valores deben ser más que el número de bases de datos que deben migrarse. Los parámetros se pueden establecer en Azure Portal en Configuración:>Parámetros del servidor o configurados en la línea de comandos mediante los siguientes comandos:

• ALTER SYSTEM SET wal_level = logical;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Asegúrese de que no hay transacciones de larga duración. Las transacciones de larga duración no permiten la creación de ranuras de replicación. La creación de una ranura de replicación se realizará correctamente si todas las transacciones de larga duración se confirman o se revierten. Tendrá que reiniciar el servidor PostgreSQL de origen después de completar todos los requisitos previos de migración en línea.

Nota:

Para la migración en línea con un servidor único de Azure Database for PostgreSQL, la compatibilidad con la replicación de Azure se establece en Lógico en la configuración de replicación de la página de servidor único en Azure Portal.

Para evitar que la migración en línea se quede sin almacenamiento para almacenar los registros, asegúrese de que dispone de suficiente espacio de espacio de tablas utilizando un disco administrado aprovisionado. Para ello, deshabilite el parámetro de servidor azure.enable_temp_tablespaces_on_local_ssd en el servidor flexible durante la migración y restáurelo al estado original después de la migración.

Configuración del destino

• Azure Database for PostgreSQL debe configurarse en Azure antes de la migración.

• La SKU elegida para Azure Database for PostgreSQL debe corresponderse con las especificaciones de la base de datos de origen a fin de garantizar la compatibilidad y el rendimiento adecuado.

• Para obtener instrucciones detalladas sobre cómo crear una instancia de Azure Database for PostgreSQL, consulte el vínculo siguiente: Inicio rápido: Creación de un servidor.

• El parámetro de servidormax_replication_slots debe ser mayor que el número de bases de datos que deben migrarse. Se puede establecer en Azure Portal en Configuración:>Parámetros del servidor o configurados en la línea de comandos mediante el siguiente comando:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Importante

Cambie el parámetro de servidor password_encryption en el servidor flexible de SCRAM-SHA-256 a MD5 antes de iniciar la migración. Esto es esencial para que las credenciales existentes en un solo servidor funcionen en el servidor flexible.

Configuración de red

La configuración de red es fundamental para que el servicio de migración funcione correctamente. Asegúrese de que el servidor PostgreSQL de origen puede comunicarse con el servidor de Azure Database for PostgreSQL de destino. Las siguientes configuraciones de red son esenciales para una migración correcta.

Para obtener información sobre la configuración de red, visite Guía de red para el servicio de migración.

Habilitación de extensiones

Para asegurarse de que la migración se realiza correctamente usando el servicio de migración en Azure Database for PostgreSQL, es posible que tenga que comprobar las extensiones de la instancia de PostgreSQL de origen. Las extensiones proporcionan funcionalidad y características adicionales que podrían ser necesarias para la aplicación. Asegúrese de comprobar las extensiones en la instancia de PostgreSQL de origen antes de iniciar el proceso de migración.

Habilite las extensiones admitidas identificadas en la instancia de PostgreSQL de origen en la instancia de destino de Azure Database for PostgreSQL: servidor flexible.

Para obtener más información, consulte Extensiones de Azure Database for PostgreSQL.

Nota:

Cuando se producen cambios en el parámetro shared_preload_libraries, es necesario reiniciar.

Parámetros del servidor

Estos parámetros no se migran automáticamente al entorno de destino y deben configurarse manualmente.

• Haga coincidir los valores de parámetros del servidor de la base de datos de PostgreSQL de origen con Azure Database for PostgreSQL; para ello, acceda a la sección "Parámetros del servidor" en Azure Portal y actualice manualmente los valores según corresponda.

• Guarde los cambios de los parámetros y reinicie Azure Database for PostgreSQL para aplicar la nueva configuración si es necesario.

Deshabilitación de la alta disponibilidad (fiabilidad) y las réplicas de lectura en el destino

• Deshabilitar la alta disponibilidad (fiabilidad) y las réplicas de lectura en el entorno de destino es esencial. Estas características deben habilitarse solo una vez completada la migración.

• Al seguir estas instrucciones, puede ayudar a garantizar un proceso de migración fluido sin las variables agregadas que introducen la alta disponibilidad y las réplicas de lectura. Una vez que se completa la migración y la base de datos es estable, puede continuar con la habilitación de estas características para mejorar la disponibilidad y escalabilidad del entorno de base de datos en Azure.

Nota:

Se aplican algunas limitaciones a la migración en línea, que se documenta aquí. Asegúrese de que la base de datos sea compatible para ejecutar una migración en línea.

Introducción

1. Si no está familiarizado con Microsoft Azure, cree una cuenta para evaluar las ofertas.

2. Instale la CLI de Azure más reciente para el sistema operativo en la página de instalación de la CLI de Azure.

   Si la CLI de Azure ya está instalada, compruebe la versión mediante el comando az version. La versión debe ser la 2.50.0 o posterior para usar los comandos de la CLI de migración. Si no, actualice la versión de la CLI de Azure.

3. Ejecute el comando az login:

   az login
   

   Se abre una ventana del explorador con la página de inicio de sesión de Azure. Proporcione las credenciales de Azure para realizar una autenticación correcta. Para ver otras formas de iniciar sesión con la CLI de Azure, consulte este artículo.

Comandos de la CLI de migración (en línea)

El servicio de migración incluye unos comandos de la CLI fáciles de usar para realizar tareas relacionadas con la migración. Todos los comandos de la CLI comienzan por az postgres flexible-server migration. Es importante agregar a la lista de permitidos las extensiones antes de iniciar una migración.

Para obtener ayuda para comprender las opciones asociadas a un comando y con enmarcar la sintaxis correcta, puede usar el parámetro --help:

az postgres flexible-server migration --help

La ejecución del comando anterior devuelve la siguiente salida:

La salida muestra los comandos de migración admitidos, junto con sus acciones. Examinemos más de cerca estos comandos.

Creación de una migración mediante la CLI de Azure

El comando create ayuda a crear una migración de un servidor de origen a un servidor de destino:

az postgres flexible-server migration create --help

La ejecución del comando anterior devuelve la siguiente salida:

Indica los argumentos esperados y tiene una sintaxis de ejemplo para crear una migración correcta del servidor de origen al servidor de destino. Este es el comando de la CLI para crear una migración nueva:

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

Parámetro	Descripción
subscription	Identificador de suscripción del servidor flexible de destino.
resource-group	Grupo de recursos del servidor flexible de destino.
name	Nombre del servidor flexible de destino.
migration-name	Identificador único para cada migración a este destino del Servidor flexible. Este campo solo acepta caracteres alfanuméricos y no acepta caracteres especiales excepto el subrayado (_) y el guión (-). El nombre debe comenzar y terminar con un carácter alfanumérico. El nombre también debe ser único para un servidor de destino, ya que ninguna migración al mismo destino del Servidor flexible puede tener el mismo nombre.
migration-mode	Se trata de un parámetro opcional. El valor predeterminado es Offline. Para las migraciones en línea, debe pasar Online.
properties	Ruta de acceso absoluta a un archivo JSON, que tiene la información sobre el servidor único de origen.

Por ejemplo:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

El argumento migration-name usado en el comando create se empleará en otros comandos de la CLI, como update, delete y show. Identifica de forma única el intento de migración en las acciones correspondientes en todos esos comandos.

Finalmente, el comando create necesita que se indique un archivo JSON como parte del argumento properties.

La estructura del JSON es:

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

Los parámetros create que se indican en el formato de archivo JSON se muestran a continuación:

Parámetro	Tipo	Descripción
sourceDbServerResourceId	Obligatorio	Este parámetro es el identificador de recurso del origen del Servidor único.
adminCredentials	Obligatorio	Este parámetro enumera las contraseñas de los usuarios administradores para el servidor único de origen y el servidor flexible de destino. Estas contraseñas ayudan a autenticarse en los servidores de origen y de destino.
sourceServerUserName	Obligatorio	El valor predeterminado es el usuario administrador especificado durante la creación de un único servidor y la contraseña proporcionada se usa para la autenticación con este usuario. Si no usa el usuario predeterminado, este parámetro es el usuario o rol del servidor de origen para realizar la migración. Este usuario debe tener privilegios y propiedad necesarios de los objetos de base de datos implicados en la migración y debe ser miembro de rol azure_pg_admin.
targetServerUserName	Obligatorio	El valor predeterminado es el usuario administrador creado durante la creación de un servidor flexible y la contraseña proporcionada se usa para la autenticación con este usuario. En caso de que no use el usuario predeterminado, este parámetro es el usuario o rol del servidor de destino que se usa para realizar la migración. Este usuario debe ser miembro de los roles azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables y debe tener los atributos Crear rol, Crear base de datos.
dbsToMigrate	Obligatorio	Especifique la lista de bases de datos que quiere migrar al servidor flexible. Solo se migran las bases de datos de usuario. Las bases de datos del sistema o las bases de datos de plantilla, como template0 y template1, no se migran.
overwriteDbsInTarget	Obligatorio	Cuando se establece en true, si el servidor de destino tiene una base de datos existente con el mismo nombre que la que intenta migrar, el servicio de migración sobrescribe automáticamente la base de datos.
setupLogicalReplicationOnSourceDBIfNeeded	Opcionales	Puede habilitar automáticamente la replicación lógica en el servidor de origen estableciendo esta propiedad en true. Este cambio en la configuración del servidor requiere un reinicio del servidor con dos o tres minutos de tiempo de inactividad.
sourceDBServerFullyQualifiedDomainName	Opcionales	Se usa cuando se emplea un servidor DNS personalizado para la resolución de nombres de una red virtual. Proporcione el FQDN de servidor único de origen según el servidor DNS personalizado para esta propiedad.
targetDBServerFullyQualifiedDomainName	Opcional	Se usa cuando se emplea un servidor DNS personalizado para la resolución de nombres dentro de una red virtual. Proporcione el FQDN del servidor flexible de destino según el servidor DNS personalizado. sourceDBServerFullyQualifiedDomainName y targetDBServerFullyQualifiedDomainName se incluyen como parte del archivo JSON solo en el caso excepcional de que para la resolución de nombres se use un servidor DNS personalizado en lugar del servidor DNS proporcionado por Azure. De lo contrario, no incluya estos parámetros en el archivo JSON.

Tenga en cuenta estos puntos esenciales para la respuesta del comando:

• Cuando se desencadena el comando create, la migración pasa al estado InProgress y al subestado PerformingPreRequisiteSteps. El flujo de trabajo de migración tarda unos minutos en implementar la infraestructura de migración y configurar las conexiones entre el origen y el destino.
• Una vez completado el subestado PerformingPreRequisiteSteps, la migración pasa al sustrato de Migrating Data,, donde se realizan la clonación y la copia de las bases de datos.
• Cada base de datos migrada tiene su propia sección con todos los detalles de migración, como el recuento de tablas, las inserciones incrementales, las eliminaciones y los bytes pendientes.
• El tiempo que tarda el subestado Migrating Data en finalizar depende del tamaño de las bases de datos migradas.
• La migración cambia al estado Succeeded en cuanto el subestado Migrating Data finaliza correctamente. Si hay un problema en el subestado Migrating Data, la migración pasa a un estado Failed.

Configurar la replicación

Para el modo de migración en línea, la replicación lógica debe estar activada en el Servidor único de origen. Si no está activado, el servicio de migración activa automáticamente la replicación lógica en el servidor único de origen cuando se pasa el parámetro setupLogicalReplicationOnSourceDBIfNeeded con un valor de true en el archivo JSON adjunto. La replicación también se puede configurar manualmente en el origen después de iniciar la migración, mediante el comando siguiente. Cualquiera de los enfoques para activar la replicación lógica reinicia el servidor único de origen.

Por ejemplo:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

Este comando es necesario para avanzar la migración cuando el servidor flexible está esperando en estado WaitingForLogicalReplicationSetupRequestOnSourceDB.

Para realizar la migración en línea use:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

Enumerar las migraciones

El comando list muestra todos los intentos de migración realizados en un servidor flexible de destino.

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

El parámetro filter tiene dos opciones:

• Active: muestra los intentos de migración activos (en curso) actuales en el servidor de destino. No se incluyen las migraciones con errores, ni las que se han cancelado o completado correctamente.
• All: enumera todos los intentos de migración al servidor de destino. Esto incluye las migraciones activas y completadas, independientemente del estado.

Para más información sobre este comando, use el parámetro --help:

az postgres flexible-server migration list --help

Supervisión de las migraciones

El comando show ayuda a supervisar las migraciones en curso y proporciona el estado actual y el subestado de la migración.

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

El parámetro migration_name es el nombre asignado a la migración durante el comando create. Esta es una instantánea de la respuesta de ejemplo del comando de la CLI para mostrar los detalles:

Para más información sobre este comando, use el parámetro --help:

 az postgres flexible-server migration show --help

En las tablas siguientes se describen los estados de migración y los subestados.

Estado de la migración	Descripción
InProgress	La infraestructura de migración se ha configurado o la migración de datos real está en curso.
Canceled	La migración se ha cancelado o eliminado.
Failed	Se produjeron errores en la migración.
Succeeded	La migración se ha realizado correctamente y se ha completado.
ValidationFailed	Error en la migración durante la validación previa a la migración.

Subestados de la migración	Descripción
PerformingPreRequisiteSteps	La infraestructura está configurada y está preparada para la migración de datos.
MigratingData	La migración de datos está en curso.
WaitingForCutoverTrigger	Tarea de migración de datos completada y esperando a que el usuario desencadene la transición.
CompletingMigration	Finalización del proceso de migración.
Completed	La migración se ha completado, ya sea en un estado correcto o no.
CancelingRequestedDBMigrations	Cancelación de la migración.
ValidationInProgress	Validación en curso.

Transición de las migraciones

En las migraciones en línea, una vez completada la migración base de los datos, la tarea de migración se mueve al subestado WaitingForCutoverTrigger. En este estado, el usuario puede desencadenar la transición mediante la CLI con 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.

Por ejemplo:

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

Antes de iniciar la transición, es esencial asegurarse de que:

• Las escrituras en el origen se detienen: parámetro latency es 0 o cerca de 0

El parámetro latency indica cuándo el destino se sincronizó por última vez con el origen. Por ejemplo, aquí es 201 y 202 para las dos bases de datos, como se muestra en la imagen siguiente. Significa que los cambios que se produjeron en los últimos ~200 segundos en el origen aún no se sincronizarán con el destino. En este momento, las escrituras en el origen se pueden detener e iniciarse la 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 la 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. Suponiendo una latencia de 15 minutos en el punto de transición, todos los datos modificados en 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 información de latency se puede obtener mediante el comando migration show.

Esta es una instantánea de la migración antes de iniciar la transición:

Después de iniciar la transición, todas las transacciones que se produjeron durante la copia base se copian secuencialmente en el destino y se completa la migración.

Si la transición no se realiza correctamente, la migración se mueve al estado Failed.

Para más información sobre este comando, use el parámetro --help:

 az postgres flexible-server migration update --help

Cancelación de la migración mediante la CLI

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. Este es el comando de la CLI para cancelar una migración:

az postgres flexible-server migration update cancel [--subscription]
                                                    [--resource-group]
                                                    [--name]
                                                    [--migration-name]

Por ejemplo:

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

Para más información sobre este comando, use el parámetro --help:

 az postgres flexible-server migration update cancel --help

El comando proporciona el siguiente resultado:

Comprobación de la migración cuando se complete

Tras una migración correcta, asegúrese de que puede iniciar sesión en su servidor flexible utilizando las mismas credenciales que en el servidor único. Si se producen errores de autenticación en el servidor flexible después de migrar desde un servidor único, puede deberse a que la máquina virtual del nuevo servidor flexible sea compatible con FIPS o a que utilice un algoritmo de cifrado de contraseñas diferente (SCRAM-SHA-256) en comparación con el cifrado MD5 del servidor único. Para solucionar este problema, siga estos pasos:

1. Cambie el parámetro de servidor password_encryption en el servidor flexible de SCRAM-SHA-256 a MD5.
2. Vuelva a iniciar la migración desde el servidor único al servidor flexible.
3. Si los problemas de autenticación persisten, elimine el servidor flexible existente y aprovisione uno nuevo. Repita los pasos 1 y 2 para resolver el error.

Esto debe resolver los errores de autenticación.

Después de la migración, se pueden realizar las siguientes tareas:

• Compruebe los datos en el servidor flexible y asegúrese de que es una copia exacta de la instancia de origen.

• Después de la comprobación, habilite la opción de alta disponibilidad en el servidor flexible según sea necesario.

• Cambie la SKU del servidor flexible para que coincida con las necesidades de la aplicación. Este cambio requiere un reinicio del servidor de bases de datos.

• Si ha cambiado los valores predeterminados de los parámetros del servidor en la instancia de origen, copie esos valores de los parámetros del servidor en el servidor flexible.

• Copie otras opciones de configuración del servidor, como etiquetas, alertas, reglas de firewall (si procede) de la instancia de origen al servidor flexible.

• Realice cambios en la aplicación para que las cadenas de conexión apunten a un servidor flexible.

• Supervise atentamente el rendimiento de la base de datos para ver si requiere el ajuste del rendimiento.

Contenido relacionado

• Servicio de migración
• Migración desde AWS RDS
• procedimientos recomendados
• Limitaciones y problemas conocidos
• Configuración de red
• Validaciones previas a la migración