Configuración de la replicación de datos de entrada en Azure Database for MariaDB

Artículo
06/01/2023

Importante

Azure Database for MariaDB está en proceso de retirada. Se recomienda encarecidamente migrar a Azure Database for MySQL. Para más información sobre la migración a Azure Database for MySQL, consulte ¿Qué ocurre con Azure Database for MariaDB?.

En este artículo se describe cómo configurar la Replicación de datos de entrada en Azure Database for MariaDB mediante la configuración de los servidores de origen y de réplica. En este artículo se asume que tiene alguna experiencia previa con servidores y bases de datos MariaDB.

Para crear una réplica en el servicio Azure Database for MariaDB, la Replicación de datos de entrada sincroniza los datos que proceden de un servidor MariaDB de origen local, de máquinas virtuales (VM) o de servicios de base de datos en la nube. La Replicación de datos de entrada se basa en la replicación según la posición del archivo de registro binario (binlog), que es nativa de MariaDB. Para obtener más información sobre la replicación de binlog, consulte la introducción a la replicación de binlog.

Revise las limitaciones y los requisitos de la replicación de datos de entrada antes de seguir los pasos de este artículo.

Nota:

Si el servidor de origen es la versión 10.2 o posterior, se recomienda configurar Replicación de datos de entrada mediante el uso de Identificador de transacción global.

Nota:

Este artículo contiene referencias al término esclavo, un término que Microsoft ya no usa. Cuando se elimine el término del software, se eliminará también de este artículo.

Creación de un servidor de MariaDB para utilizarlo como réplica

Cree un nuevo servidor Azure Database for MariaDB (por ejemplo, replica.mariadb.database.azure.com). Este servidor es el servidor de réplica en la replicación de datos de entrada.

Para obtener información sobre la creación del servidor, consulte Creación de un servidor de Azure Database for MariaDB mediante Azure Portal.

Importante

Debe crear el servidor de Azure Database for MariaDB en los planes de tarifa De uso general u Optimizada para memoria.
Cree cuentas de usuario idénticas y los privilegios correspondientes.

Las cuentas de usuario no se replican desde el servidor de origen al servidor de réplica. Para proporcionar a los usuarios acceso al servidor de réplica, debe crear manualmente todas las cuentas y los privilegios correspondientes en el servidor recién creado de Azure Database for MariaDB.
Agregue la dirección IP del servidor de origen a las reglas de firewall de la réplica.

Actualice las reglas de firewall mediante Azure Portal o la CLI de Azure.

Configuración del servidor de origen

En los siguientes pasos se prepara y configura el servidor MariaDB en el entorno local, en una VM o en un servicio de base de datos en la nube para la replicación de datos de entrada. El servidor MariaDB es el origen en Replicación de datos de entrada.

Revise los requisitos del servidor principal antes de continuar.
Asegúrese de que el servidor de origen permite el tráfico entrante y saliente en el puerto 3306 y de que el servidor de origen tiene una dirección IP pública, el DNS es accesible públicamente o tiene un nombre de dominio completo (FQDN).

Pruebe la conectividad con el servidor de origen; para ello, pruebe a conectarse desde una herramienta como la línea de comandos de MySQL hospedada en otra máquina o desde la instancia de Azure Cloud Shell disponible en Azure Portal.

Si su organización tiene estrictas directivas de seguridad y no permite que todas las direcciones IP del servidor de origen permitan la comunicación desde Azure al servidor de origen, puede usar el siguiente comando para determinar la dirección IP del servidor de Azure Database for MariaDB.
1. Inicie sesión en Azure Database for MariaDB con una herramienta como la línea de comandos de MySQL.
2. Ejecute la siguiente consulta.
```
SELECT @@global.redirect_server_host;
```
  A continuación se incluye una salida de ejemplo:
```
+-----------------------------------------------------------+
| @@global.redirect_server_host                             |
+-----------------------------------------------------------+
| e299ae56f000.tr1830.westus1-a.worker.database.windows.net |
 +-----------------------------------------------------------+
```
3. Salga de la línea de comandos de MySQL.
4. Ejecute el siguiente comando en la utilidad ping para obtener la dirección IP.
```
ping <output of step 2b>
```
  Por ejemplo:
```
C:\Users\testuser> ping e299ae56f000.tr1830.westus1-a.worker.database.windows.net
Pinging tr1830.westus1-a.worker.database.windows.net (**11.11.111.111**) 56(84) bytes of data.
```
5. Configure las reglas de firewall del servidor de origen para incluir la dirección IP de salida del paso anterior en el puerto 3306.
Nota:

Esta dirección IP puede cambiar debido a operaciones de mantenimiento o implementación. Este método de conectividad es solo para los clientes que no pueden permitirse que permitan todas las direcciones IP en el puerto 3306.
Active el registro binario.

Para ver si se ha habilitado el registro binario en el servidor principal, introduzca el comando siguiente:
```
SHOW VARIABLES LIKE 'log_bin';
```
Si la variable log_bin devuelve el valor ON, el registro binario está habilitado en el servidor.

Si log_bin devuelve el valor OFF, edite el archivo my.cnf para que log_bin=ON active el registro binario. Reinicie el servidor para que el cambio surta efecto.
Establezca la configuración del servidor de origen.

Replicación de datos de entrada requiere el parámetro lower_case_table_names para ser coherente entre los servidores de origen y de réplica. El parámetro lower_case_table_names se establece de forma predeterminada en 1 en Azure Database for MariaDB.
```
SET GLOBAL lower_case_table_names = 1;
```
Cree un nuevo rol de replicación y configure los permisos.

Cree una cuenta de usuario en el servidor de origen que está configurado con privilegios de replicación. Puede crear una cuenta mediante el uso de comandos SQL o MySQL Workbench. Si va a replicar con SSL, debe especificarlo al crear la cuenta de usuario.

Para obtener información sobre cómo agregar cuentas de usuario al servidor de origen, consulte la documentación de MariaDB.

Mediante el uso de los comandos siguientes, el nuevo rol de replicación creado puede acceder al servidor de origen desde cualquier máquina, no solo desde la máquina que hospeda al servidor de origen. Para este acceso, especifique syncuser'%' en el comando para crear un usuario.

Para obtener más información sobre la documentación de MariaDB, consulte Especificación de nombres de cuenta.

Comando SQL
- Replicación con SSL
  
  Para requerir SSL para todas las conexiones de usuario, introduzca el comando siguiente para crear un usuario:
```
CREATE USER 'syncuser'@'%' IDENTIFIED BY 'yourpassword';
GRANT REPLICATION SLAVE ON *.* TO ' syncuser'@'%' REQUIRE SSL;
```
- Replicación sin SSL
  
  Si SSL no es necesario para todas las conexiones, introduzca el comando siguiente para crear un usuario:
```
CREATE USER 'syncuser'@'%' IDENTIFIED BY 'yourpassword';
GRANT REPLICATION SLAVE ON *.* TO ' syncuser'@'%';
```
MySQL Workbench

Para crear el rol de replicación en MySQL Workbench, abra el panel Administración y seleccione Usuarios y privilegios. A continuación, seleccione Agregar cuenta.

Introduzca un nombre de usuario en el campo Nombre de inicio de sesión.

Seleccione el panel Roles administrativos y, a continuación, en la lista Privilegios globales, seleccione Servidor subordinado de replicación. Seleccione Aplicar para crear el rol de replicación.
Establezca el servidor de origen en el modo de solo lectura.

Antes de volcar una base de datos, el servidor debe configurarse en modo de solo lectura. En modo de solo lectura, el servidor de origen no puede procesar cualquier transacción de escritura. Para ayudar a evitar que afecte a la actividad de la empresa, programe la ventana de solo lectura durante un período de menor actividad.
```
FLUSH TABLES WITH READ LOCK;
SET GLOBAL read_only = ON;
```
Obtenga el nombre de archivo de registro binario y el desplazamiento actuales.

Ejecute el comando show master status para determinar el nombre de archivo de registro binario actual y el desplazamiento actuales.
```
show master status;
```
Los resultados deberían asemejarse a esta tabla:

Anote el nombre del archivo binario, ya que se utilizará en pasos posteriores.
Obtenga la posición de GTID (opcional, es necesario para la replicación con GTID).

Ejecute la función BINLOG_GTID_POS para obtener la posición de GTID para el nombre de archivo binlog y el desplazamiento correspondientes.
```
select BINLOG_GTID_POS('<binlog file name>', <binlog offset>);
```

Volcado y restauración del servidor de origen

Vuelque todas las bases de datos desde el servidor de origen.

Utilice mysqldump para volcar todas las bases de datos desde el servidor de origen. No es necesario volcar la biblioteca de MySQL y la biblioteca de prueba.

Para obtener más información, consulte Volcar y restaurar.
Establezca el servidor de origen en modo de lectura/escritura.

Cuando se haya volcado la base de datos, vuelva a cambiar el servidor de MariaDB de origen al modo de lectura/escritura.
```
SET GLOBAL read_only = OFF;
UNLOCK TABLES;
```
Restaure el archivo de volcado en el servidor nuevo.

Restaure el archivo de volcado en el servidor creado en el servicio Azure Database for MariaDB. Consulte Volcado y restauración para obtener información sobre cómo restaurar un archivo de volcado en un servidor MariaDB.

Si el archivo de volcado es grande, cárguelo a una VM en Azure dentro de la misma región que el servidor de réplica. Restáurelo en el servidor de Azure Database for MariaDB desde la VM.

Vinculación de los servidores de origen y de réplica para iniciar Replicación de datos de entrada

Establezca el servidor de origen.

Todas las funciones de la replicación de datos internos se realizan mediante los procedimientos almacenados. Puede encontrar todos los procedimientos en Procedimientos almacenados de replicación de datos internos. Los procedimientos almacenados se pueden ejecutar en el shell de MySQL o en MySQL Workbench.

Para vincular dos servidores e iniciar la replicación, inicie sesión en el servidor de réplica de destino en el servicio Azure Database for MariaDB. A continuación, establezca la instancia externa como servidor de origen mediante el uso de los procedimientos almacenados mysql.az_replication_change_master o mysql.az_replication_change_master_with_gtid en la base de datos de Azure para el servidor de MariaDB.
```
CALL mysql.az_replication_change_master('<master_host>', '<master_user>', '<master_password>', 3306, '<master_log_file>', <master_log_pos>, '<master_ssl_ca>');
```
or
```
CALL mysql.az_replication_change_master_with_gtid('<master_host>', '<master_user>', '<master_password>', 3306, '<master_gtid_pos>', '<master_ssl_ca>');
```
- master_host: nombre de host del servidor de origen
- master_user: nombre de usuario para el servidor de origen
- master_password: contraseña para el servidor de origen
- master_log_file: nombre del archivo de registro binario procedente de la ejecución de show master status
- master_log_pos: posición del registro binario procedente de la ejecución de show master status
- master_gtid_pos: posición GTID desde la ejecución select BINLOG_GTID_POS('<binlog file name>', <binlog offset>);
- master_ssl_ca: contexto del certificado de entidad de certificación. Si no usa SSL, pase una cadena vacía.*
* Se recomienda pasar el parámetro master_ssl_ca como variable. Para más información, vea los ejemplos siguientes.

Ejemplos
- Replicación con SSL
  
  Para crear la variable @cert, ejecute los comandos siguientes:
```
SET @cert = '-----BEGIN CERTIFICATE-----
PLACE YOUR PUBLIC KEY CERTIFICATE\'S CONTEXT HERE
-----END CERTIFICATE-----'
```
  La replicación con SSL se configura entre un servidor de origen hospedado en el dominio companya.com y un servidor de réplica hospedado en Azure Database for MariaDB. Este procedimiento almacenado se ejecuta en la réplica.
```
CALL mysql.az_replication_change_master('master.companya.com', 'syncuser', 'P@ssword!', 3306, 'mariadb-bin.000016', 475, @cert);
```
- Replicación sin SSL
  
  La replicación sin SSL se configura entre un servidor maestro hospedado en el dominio companya.com y un servidor de réplica hospedado en Azure Database for MariaDB. Este procedimiento almacenado se ejecuta en la réplica.
```
CALL mysql.az_replication_change_master('master.companya.com', 'syncuser', 'P@ssword!', 3306, 'mariadb-bin.000016', 475, '');
```
Inicie la replicación.

Llame al procedimiento almacenado mysql.az_replication_start para iniciar la replicación.
```
CALL mysql.az_replication_start;
```
Compruebe el estado de replicación.

Llame al comando show slave status en el servidor de réplica para ver el estado de replicación.
```
show slave status;
```
Si Slave_IO_Running y Slave_SQL_Running tienen el estado yes y el valor de Seconds_Behind_Master es 0, la replicación funciona correctamente. Seconds_Behind_Master indica el tiempo de retraso de la réplica. Si el valor no es 0, la réplica procesa actualizaciones.
Actualice las variables del servidor correspondientes con el fin de que la replicación de datos de entrada sea más segura (solo es necesario para la replicación sin GTID).

Debido a una limitación de la replicación nativa de MariaDB, debe establecer las variables sync_master_info y sync_relay_log_info en la replicación sin el escenario GTID.

Compruebe las variables sync_master_info y sync_relay_log_info del servidor de réplica para asegurarse de que la replicación de datos de entrada es estable y establezca las variables en 1.

Otros procedimientos almacenados

Detención replicación

Para detener la replicación entre el servidor de origen y de réplica, use el siguiente procedimiento almacenado:

CALL mysql.az_replication_stop;

Eliminación de la relación de replicación

Para eliminar la relación entre el servidor de origen y de réplica, use el siguiente procedimiento almacenado:

CALL mysql.az_replication_remove_master;

Omitir el error de replicación

Para omitir un error de replicación y permitir la replicación, use el siguiente procedimiento almacenado:

CALL mysql.az_replication_skip_counter;

Pasos siguientes

Obtenga más información sobre Replicación de datos de entrada para Azure Database for MariaDB.

Compartir a través de