Creación y administración de réplicas de lectura en Azure Database for MariaDB mediante la CLI de Azure y API REST

  • Artículo

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 aprenderá a crear y administrar réplicas de lectura en el servicio Azure Database for MariaDB mediante la CLI de Azure y API REST.

CLI de Azure

Puede crear y administrar réplicas de lectura mediante la CLI de Azure.

Prerrequisitos

Importante

La característica de réplica de lectura solo está disponible para servidores de Azure Database for MariaDB en los planes de tarifa De uso general u Optimizado para memoria. Asegúrese de que el servidor de origen esté en uno de estos planes de tarifa.

Creación de una réplica de lectura

Importante

Cuando se crea la réplica de origen que no tiene réplicas existentes, el origen se reiniciará primero a fin de prepararse para la replicación. Téngalo en cuenta y realice estas operaciones durante un período de poca actividad.

Un servidor de réplica de lectura se puede crear mediante el comando siguiente:

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup

El comando az mariadb server replica create requiere los siguientes parámetros:

Configuración Valor de ejemplo Descripción
resource-group  myresourcegroup  Grupo de recursos donde se creará el servidor de réplica. 
name mydemoreplicaserver Nombre del nuevo servidor de réplica que se crea.
source-server mydemoserver Nombre o identificador del servidor de origen existente desde el que se va a replicar.

Para crear una réplica de lectura entre regiones, use el parámetro --location.

El siguiente ejemplo de la CLI crea la réplica en Oeste de EE. UU.

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location westus

Nota

Para más información sobre las regiones en las que puede crear una réplica, consulte el artículo sobre los conceptos de la réplica de lectura.

Nota:

Las réplicas de lectura se crean con la misma configuración de servidor que el servidor maestro. Una vez creado, se puede cambiar la configuración del servidor de réplica. Se recomienda mantener la configuración del servidor de réplica con valores iguales o mayores que el de origen para asegurarse de que la réplica funciona al mismo nivel que el servidor maestro.

Enumeración de las réplicas de un servidor de origen

Para ver todas las réplicas de un determinado servidor de origen, ejecute el siguiente comando:

az mariadb server replica list --server-name mydemoserver --resource-group myresourcegroup

El comando az mariadb server replica list requiere los siguientes parámetros:

Configuración Valor de ejemplo Descripción
resource-group  myresourcegroup  Grupo de recursos donde se creará el servidor de réplica. 
server-name mydemoserver Nombre o identificador del servidor de origen.

Detención de la replicación en un servidor de réplica

Importante

La detención la replicación en un servidor es irreversible. Una vez detenida la replicación entre un origen y una réplica, la operación no se puede deshacer. Después, el servidor de réplica se convierte en un servidor independiente que admite operaciones de lectura y escritura. Este servidor no puede volver a convertirse en una réplica.

La replicación de un servidor de réplica de lectura se puede detener mediante el comando siguiente:

az mariadb server replica stop --name mydemoreplicaserver --resource-group myresourcegroup

El comando az mariadb server replica stop requiere los siguientes parámetros:

Configuración Valor de ejemplo Descripción
resource-group  myresourcegroup  Grupo de recursos donde se encuentra el servidor de réplica. 
name mydemoreplicaserver Nombre del servidor de réplica para el que desea detener la replicación.

Eliminación de un servidor de réplica

La eliminación de un servidor de réplica de lectura se puede realizar mediante la ejecución del comando az mariadb server delete.

az mariadb server delete --resource-group myresourcegroup --name mydemoreplicaserver

Eliminación de un servidor de origen

Importante

Al eliminar un servidor de origen, se detiene la replicación en todos los servidores de réplica y se elimina el propio servidor de origen. Los servidores de réplica se convierten en servidores independientes que ahora admiten tanto lectura como escritura.

Para eliminar un servidor de origen, puede ejecutar el comando az mariadb server delete.

az mariadb server delete --resource-group myresourcegroup --name mydemoserver

REST API

Puede crear y administrar réplicas de lectura mediante API REST de Azure.

Creación de una réplica de lectura

Puede crear una réplica de lectura mediante la API de creación:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{replicaName}?api-version=2017-12-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}"
  }
}

Nota

Para más información sobre las regiones en las que puede crear una réplica, consulte el artículo sobre los conceptos de la réplica de lectura.

Si no ha establecido el parámetro azure.replication_support en REPLICA en un servidor de origen de uso general u optimizado para memoria y ha reiniciado el servidor, aparece un error. Complete estos dos pasos antes de crear una réplica.

Una réplica se crea con la misma configuración de proceso y almacenamiento que el servidor maestro. Después de crear una réplica, se pueden cambiar varios valores independientemente del servidor de origen: generación de proceso, núcleos virtuales, almacenamiento y período de retención de copias de seguridad. El plan de tarifa también se puede cambiar de forma independiente, excepto si es con origen o destino en el nivel Básico.

Importante

Antes de actualizar un valor de un servidor de origen a uno nuevo, actualice la configuración de réplica a un valor igual o superior. Esta acción ayuda a que la réplica haga frente a los cambios realizados en el servidor maestro.

Lista de réplicas

Puede ver la lista de réplicas de un servidor de origen mediante la API de lista de réplicas:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}/Replicas?api-version=2017-12-01

Detención de la replicación en un servidor de réplica

Puede detener la replicación entre un servidor de origen y una réplica de lectura mediante la API de actualización.

Después de detener la replicación entre un servidor de origen y una réplica de lectura, este proceso no se puede deshacer. La réplica de lectura se convierte en un servidor independiente que admite operaciones de lectura y escritura. Este servidor independiente no puede volver a convertirse en una réplica.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}?api-version=2017-12-01

{
  "properties": {
    "replicationRole":"None"  
   }
}

Eliminación de un servidor de origen o de réplica

Para eliminar un servidor de origen o de réplica, use la API de eliminación:

Cuando se elimina un servidor de origen, la replicación se detiene en todas las réplicas de lectura. Las réplicas de lectura se convierten en servidores independientes que ahora admiten tanto lectura como escritura.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2017-12-01

Pasos siguientes