How to create and manage read replicas in Azure Database for MariaDB using the Azure portal

Important

Azure Database for MariaDB is on the retirement path. We strongly recommend that you migrate to Azure Database for MySQL. For more information about migrating to Azure Database for MySQL, see What's happening to Azure Database for MariaDB?.

In this article, you will learn how to create and manage read replicas in the Azure Database for MariaDB service using the Azure portal.

Prerequisites

Important

The read replica feature is only available for Azure Database for MariaDB servers in the General Purpose or Memory Optimized pricing tiers. Ensure the source server is in one of these pricing tiers.

Create a read replica

Important

When you create a replica for a source that has no existing replicas, the source will first restart to prepare itself for replication. Take this into consideration and perform these operations during an off-peak period.

A read replica server can be created using the following steps:

  1. Sign in to the Azure portal.

  2. Select the existing Azure Database for MariaDB server that you want to use as a master. This action opens the Overview page.

  3. Select Replication from the menu, under SETTINGS.

  4. Select Add Replica.

    Azure Database for MariaDB - Replication

  5. Enter a name for the replica server.

    Azure Database for MariaDB - Replica name

  6. Select the location for the replica server. The default location is the same as the source server's.

    Azure Database for MariaDB - Replica location

  7. Select OK to confirm creation of the replica.

Note

Read replicas are created with the same server configuration as the master. The replica server configuration can be changed after it has been created. It is recommended that the replica server's configuration should be kept at equal or greater values than the source to ensure the replica is able to keep up with the master.

Once the replica server has been created, it can be viewed from the Replication blade.

Azure Database for MariaDB - List replicas

Stop replication to a replica server

Important

Stopping replication to a server is irreversible. Once replication has stopped between a source and replica, it cannot be undone. The replica server then becomes a standalone server and now supports both read and writes. This server cannot be made into a replica again.

To stop replication between a source and a replica server from the Azure portal, use the following steps:

  1. In the Azure portal, select your source Azure Database for MariaDB server.

  2. Select Replication from the menu, under SETTINGS.

  3. Select the replica server you wish to stop replication for.

    Azure Database for MariaDB - Stop replication select server

  4. Select Stop replication.

    Azure Database for MariaDB - Stop replication

  5. Confirm you want to stop replication by selecting OK.

    Azure Database for MariaDB - Stop replication confirm

Delete a replica server

To delete a read replica server from the Azure portal, use the following steps:

  1. In the Azure portal, select your source Azure Database for MariaDB server.

  2. Select Replication from the menu, under SETTINGS.

  3. Select the replica server you wish to delete.

    Azure Database for MariaDB - Delete replica select server

  4. Select Delete replica

    Azure Database for MariaDB - Delete replica

  5. Type the name of the replica and select Delete to confirm deletion of the replica.

    Azure Database for MariaDB - Delete replica confirm

Delete a source server

Important

Deleting a source server stops replication to all replica servers and deletes the source server itself. Replica servers become standalone servers that now support both read and writes.

To delete a source server from the Azure portal, use the following steps:

  1. In the Azure portal, select your source Azure Database for MariaDB server.

  2. From the Overview, select Delete.

    Azure Database for MariaDB - Delete master

  3. Type the name of the source server and select Delete to confirm deletion of the source server.

    Azure Database for MariaDB - Delete master confirm

Monitor replication

  1. In the Azure portal, select the replica Azure Database for MariaDB server you want to monitor.

  2. Under the Monitoring section of the sidebar, select Metrics:

  3. Select Replication lag in seconds from the dropdown list of available metrics.

    Select Replication lag

  4. Select the time range you wish to view. The image below selects a 30 minute time range.

    Select time range

  5. View the replication lag for the selected time range. The image below displays the last 30 minutes for a large workload.

    Select time range 30 minutes

Next steps