Partekatu honen bidez:

Configuración de la CLI de Azure para el servicio de migración en el servidor flexible de Azure Database for PostgreSQL

  • Artikulua

La CLI de Azure es un conjunto de comandos que se usan en los servicios de Azure para crear y administrar recursos. Proporciona las mismas funcionalidades que Azure Portal, pero está optimizada para los usuarios que prefieren trabajar en un entorno de línea de comandos. Para empezar a migrar mediante la CLI de Azure, tiene que instalar la CLI de Azure en la máquina local.

Requisitos previos

  • Instalación de la CLI de Azure: en función del sistema operativo, descargue e instale la CLI de Azure. Está disponible para Windows, macOS y Linux.
  • Guía de instalación de la CLI de Azure: siga las instrucciones proporcionadas en la documentación oficial de Azure para instalar la CLI de Azure: instalación de la CLI de Azure.
  • Compruebe la versión de la CLI de Azure: asegúrese de que la versión de la CLI de Azure sea al menos 2.56.0 o posterior, ya que esto es necesario para el servicio de migración. Use el comando az --version para comprobar la versión actual.
  • Inicie sesión en Azure: después de la instalación, ejecute az login para autenticarse. Se abre el explorador predeterminado para completar el proceso de inicio de sesión con las credenciales de Azure.

Estos pasos preparan el entorno para usar la CLI de Azure para administrar el servicio de migración en Azure Database for PostgreSQL de forma eficaz. Consulte siempre la documentación más reciente de Azure para conocer las actualizaciones o los cambios en el proceso de instalación.

Configuración de comandos de la CLI para el servicio de migración

Todos los comandos de la CLI comienzan por az postgres flexible-server migration. También se proporcionan instrucciones de ayuda para ayudarle a comprender las distintas opciones y enmarcar la sintaxis correcta para los comandos de la CLI.

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

Migración de comandos

El servicio de migración proporciona los siguientes comandos para ayudarle a migrar las instancias de PostgreSQL al servidor flexible de Azure Database for PostgreSQL.

Comando help

El comando --help de la CLI de Azure es una opción valiosa que proporciona documentación detallada sobre los comandos y sus subcomandos, incluidos los verbos necesarios para las operaciones. El comando –-help muestra los comandos necesarios y sus acciones asociadas para el servicio de migración en Azure Database for PostgreSQL.

az postgres flexible-server migration –-help

La salida le guía por los pasos y parámetros necesarios para administrar las migraciones de base de datos de forma eficaz mediante la CLI de Azure.

Create, comando

El comando az postgres flexible-server migration create de la CLI de Azure se usa para iniciar un nuevo flujo de trabajo de migración. Facilita la migración de bases de datos de una instancia de PostgreSQL de origen a una instancia de Servidor flexible de Azure Database for PostgreSQL de destino. Este comando configura los parámetros y configuraciones necesarios para garantizar un proceso de migración fluido y eficaz.

Para más información, consulte az postgres flexible-server migration create

Comando list

El comando az postgres flexible-server migration list se usa para enumerar todos los intentos de migración realizados en un destino de Azure Database for PostgreSQL. Este comando proporciona información general sobre las migraciones que se han iniciado, lo que le permite realizar un seguimiento del estado y los detalles de cada intento de migración.

Para más información, consulte az postgres flexible-server migration list

Comando show

El comando az postgres flexible-server migration show ayuda a supervisar las migraciones en curso y proporciona el estado actual y el subestado de la migración. Estos detalles incluyen información sobre el estado actual y el subestado de la migración.

Para más información, consulte az postgres flexible-server migration show

Algunos estados de migración posibles:

Estados de migración

Estado Descripción
InProgress La infraestructura de migración se está configurando o la migración de datos en sí está en curso.
Canceled La migración se ha cancelado o eliminado.
Erróneo Se produjeron errores en la migración.
Error de validación Se ha producido un error de validación.
Correcto La migración se ha realizado correctamente y se ha completado.
WaitingForUserAction Aplicable solo para la migración online. Espera a que la acción del usuario realice la transición.

Subestados de la migración

Subestado Descripción
PerformingPreRequisiteSteps La infraestructura se está configurando para la migración de datos.
Validación en curso Validación en curso.
MigratingData La migración de datos está en curso.
CompletingMigration La migración está en las últimas fases de finalización.
Completados La migración se ha completado.
Con error Se produjeron errores en la migración.

Subestados de validación

Subestado Descripción
Con error Error de validación.
Correcto La validación se ha realizado correctamente.
Advertencia La validación está en Advertencia.

Comando Update

El comando az postgres flexible-server migration update se usa para administrar el proceso de migración a un servidor flexible de Azure Database for PostgreSQL. En concreto, se puede usar para:

  • Realizar una transición: finaliza el proceso de migración cambiando el tráfico de la base de datos del servidor de origen al servidor flexible de destino.
    • Una vez completada la migración de datos base, la tarea de migración se mueve al subestado WaitingForCutoverTrigger. En este estado, los usuarios pueden desencadenar la transición desde el portal seleccionando el nombre de la migración en la cuadrícula de migración o a través de la CLI.
    • Antes de iniciar la transición, es importante comprobar lo siguiente:
      • Las escrituras en el origen se detienen
      • 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. 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 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 en el 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.
  • Cancelar la migración: si es necesario, esta opción le permite detener el proceso de migración.
  • Configuración de la replicación lógica en el origen: esto resulta útil cuando el servidor de origen es un servidor único de Azure Database for PostgreSQL, ya que prepara el servidor para la replicación de datos en el servidor flexible.

Para más información, consulte az postgres flexible-server migration update

Resumen

En la tabla siguiente se resumen los parámetros utilizados por los comandos de migración:

Parámetro Comandos pertinentes Descripción
subscription create, list, show, update Id. de suscripción del servidor flexible de PostgreSQL
resource-group create, list, show, update Grupo de recursos del servidor flexible de PostgreSQL
name create, list, show Nombre del servidor flexible de PostgreSQL
migration-name create, show, update Identificador único de las migraciones que se intentaron en el servidor flexible. Este campo solo acepta caracteres alfanuméricos; no acepta caracteres especiales, excepto un guion (-). El nombre no puede comenzar por - y dos migraciones a un servidor flexible de destino no pueden tener el mismo nombre.
filter list Para filtrar las migraciones, se admiten dos valores: Active y All.
help create, list, show, update Proporciona información sobre cada comando.
migration-mode create Se trata de un parámetro opcional. Los valores permitidos son: sin conexión, en línea. Valor predeterminado: Sin conexión.
migration-option create Le permite realizar validaciones antes de desencadenar una migración. El valor predeterminado es ValidateAndMigrate. Los valores permitidos son: Migrate, Validate, ValidateAndMigrate.
properties create Ruta de acceso absoluta a un archivo JSON que tiene la información sobre el origen, el servidor de destino, las bases de datos para migrar, los modos SSL, la definición de tipos de origen

Detalles del archivo JSON

El comando az postgres flexible-server migration create requiere una ruta de acceso del archivo JSON como parte del parámetro --properties, que contiene detalles de configuración para la migración, como el identificador de recurso del servidor de base de datos de origen, las credenciales de administrador, las bases de datos para migrar y otras configuraciones importantes. A continuación se muestran las distintas propiedades:

Nombre de propiedad Descripción
sourceDbServerResourceId Detalles del servidor de origen en el formato para locales, máquinas virtuales (VM), servicio PostgreSQL basado en la nube: <<hostname or IP address>>:<<port>>@<<username>>. Si el servidor de origen es Azure Database for PostgreSQL: servidor único, el identificador de recurso tiene el formato: /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Este parámetro enumera las contraseñas de los usuarios administradores para el servidor de origen y el servidor flexible de PostgreSQL de destino. Estas contraseñas ayudan a autenticarse en los servidores de origen y de destino. Incluye dos subpropiedades, sourceServerPassword y targetServerPassword
targetServerUserName El valor predeterminado es el usuario administrador creado durante la creación del servidor flexible de destino de PostgreSQL y la contraseña proporcionada se usa para la autenticación en este usuario.
dbsToMigrate Especifique la lista de bases de datos que quiere migrar al servidor flexible. Puede incluir hasta ocho nombres de bases de datos a la vez. Proporcionar la lista de las bases de datos en formato de matriz.
overwriteDBsInTarget Cuando se establece en true (valor predeterminado), 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
migrationRuntimeResourceId Requerido si es necesario usar un servidor en tiempo de ejecución para la migración. El formato es: /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Parámetro obligatorio. Los valores pueden ser: on-premises, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Modos de la SSL para la migración. El modo de la SSL para PostgreSQLSingleServer es VerifyFull y Prefer/Require para otros tipos de origen.

Contenido relacionado