Creación y administración de réplicas de lectura en Azure Database for MariaDB mediante la CLI de Azure y API REST
Importante
Azure Database for MariaDB está en proceso de retirada. Le recomendamos que realice la migración a Azure Database for MySQL. Para más información sobre la migración a Azure Database for MySQL, consulte ¿Qué está ocurriendo 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
- Instalación de la CLI de Azure 2.0
- Un servidor de Azure Database for MariaDB que se usará como servidor de origen.
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
- Obtenga más información sobre las réplicas de lectura