Partager via

Guide pratique pour créer et gérer des réplicas en lecture dans Azure Database for MariaDB à l’aide d’Azure CLI et de l’API REST

  • Article

Important

Azure Database for MariaDB est en voie de mise hors service. Nous vous recommandons vivement de migrer vers Azure Database pour MySQL. Pour plus d’informations sur la migration vers Azure Database pour MySQL, consultez Qu’est-ce qui se passe dans Azure Database for MariaDB ?.

Dans cet article, vous allez apprendre à créer et à gérer des réplicas en lecture dans le service Azure Database for MariaDB à l’aide d’Azure CLI et de l’API REST.

Azure CLI

Vous pouvez créer et gérer des réplicas en lecture à l’aide d’Azure CLI.

Prérequis

Important

La fonctionnalité de réplica en lecture est disponible uniquement pour les serveurs Azure Database for MariaDB dans les niveaux tarifaires Usage général ou Mémoire optimisée. Vérifiez que le serveur source se trouve dans l’un de ces niveaux tarifaires.

Créer un réplica en lecture

Important

Lorsque vous créez un réplica pour un serveur source qui n’en a pas, ce dernier commence par redémarrer afin de se préparer à la réplication. Tenez-en compte et effectuez ces opérations en période creuse.

Un serveur réplica en lecture peut être créé en utilisant la commande suivante :

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

La commande az mariadb server replica create requiert les paramètres suivants :

Paramètre Valeur d'exemple Description
resource-group  myResourceGroup  Groupe de ressources dans lequel le serveur réplica sera créé. 
name mydemoreplicaserver Nom du nouveau serveur réplica créé.
source-server mydemoserver Nom ou ID du serveur source à partir duquel la réplication doit être effectuée.

Pour créer un réplica en lecture entre régions, utilisez le paramètre --location.

L’exemple CLI ci-dessous crée le réplica dans la région USA Ouest.

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

Notes

Pour en savoir plus sur les régions dans lesquelles vous pouvez créer un réplica, consultez l’article Concepts relatifs aux réplicas en lecture.

Remarque

Les réplicas en lecture sont créés avec la même configuration de serveur que le serveur maître. La configuration du serveur réplica peut être modifiée après la création de ce dernier. Il est recommandé de maintenir la configuration du serveur réplica à des valeurs égales ou supérieures à celles du serveur source pour garantir que le réplica sera à la hauteur du serveur maître.

Répertorier les réplicas d'un serveur source

Pour afficher tous les réplicas d'un serveur source donné, exécutez la commande suivante :

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

La commande az mariadb server replica list requiert les paramètres suivants :

Paramètre Valeur d'exemple Description
resource-group  myResourceGroup  Groupe de ressources dans lequel le serveur réplica sera créé. 
server-name mydemoserver Nom ou ID du serveur source.

Arrêter la réplication vers un serveur réplica

Important

L’arrêt de la réplication vers un serveur est irréversible. Une fois la réplication entre un serveur source et un serveur réplica arrêtée, il est impossible de revenir en arrière. Le serveur réplica devient un serveur autonome et prend désormais en charge la lecture et les écritures. Ce serveur ne peut pas être à nouveau transformé en réplica.

La réplication d'un serveur réplica en lecture peut être arrêtée en utilisant la commande suivante :

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

La commande az mariadb server replica stop requiert les paramètres suivants :

Paramètre Valeur d'exemple Description
resource-group  myResourceGroup  Groupe de ressources où se trouve le serveur réplica. 
name mydemoreplicaserver Nom du serveur réplica pour lequel arrêter la réplication.

Supprimer un serveur réplica

La suppression d’un serveur réplica en lecture peut être effectuée en exécutant la commande az mariadb server delete.

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

Supprimer un serveur source

Important

La suppression d’un serveur source arrête la réplication vers tous les serveurs réplicas et supprime le serveur source proprement dit. Les serveurs réplicas deviennent des serveurs autonomes qui prennent désormais en charge la lecture et les écritures.

Pour supprimer un serveur source, vous pouvez exécuter la commande az mariadb server delete.

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

API REST

Vous pouvez créer et gérer des réplicas en lecture à l’aide de l’API REST Azure.

Créer un réplica en lecture

Vous pouvez créer un réplica en lecture à l’aide de l’API de création :

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}"
  }
}

Notes

Pour en savoir plus sur les régions dans lesquelles vous pouvez créer un réplica, consultez l’article Concepts relatifs aux réplicas en lecture.

Si vous n’avez pas affecté au paramètre azure.replication_support la valeur REPLICA sur un serveur source à usage général ou à mémoire optimisée, et que vous avez redémarré le serveur, vous recevez une erreur. Effectuez ces deux étapes avant de créer un réplica.

Le réplica doit être créé en utilisant les mêmes paramètres de calcul et de stockage que le serveur maître. Une fois le réplica créé, vous pouvez changer plusieurs paramètres indépendamment du serveur source : génération de calcul, vCores, stockage et durée de conservation des sauvegardes. Le niveau tarifaire peut également être changé indépendamment, sauf vers ou depuis le niveau De base.

Important

Avant de modifier un paramètre du serveur source, remplacez la valeur du paramètre du réplica par une valeur supérieure ou égale à celle du serveur maître. Vous garantissez ainsi l’alignement du réplica sur les changements apportés au serveur maître.

Lister les réplicas

Vous pouvez afficher la liste des réplicas d'un serveur source à l'aide de l'API Lister les réplicas :

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

Arrêter la réplication vers un serveur réplica

Vous pouvez arrêter la réplication entre un serveur source et un réplica en lecture à l'aide de l'API de mise à jour.

Une fois que vous avez arrêté la réplication entre un serveur source et un réplica en lecture, vous ne pouvez pas revenir en arrière. Le réplica en lecture devient un serveur autonome qui prend en charge les lectures et les écritures. Le serveur autonome ne peut pas être retransformé en réplica.

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

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

Supprimer un serveur source ou réplica

Pour supprimer un serveur source ou réplica, vous devez utiliser l'API de suppression :

Lorsque vous supprimez un serveur source, la réplication est arrêtée sur tous les réplicas en lecture. Les réplicas en lecture deviennent des serveurs autonomes qui prennent désormais en charge les lectures et les écritures.

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

Étapes suivantes