如何使用 Azure CLI 和 REST API 在 Azure Database for MariaDB 中创建和管理只读副本
重要
Azure Database for MariaDB 已列入停用计划。 强烈建议迁移到 Azure Database for MySQL。 若要详细了解如何迁移到 Azure Database for MySQL,请参阅《Azure Database for MariaDB 发生了什么情况?》。
本文介绍如何使用 Azure CLI 和 REST API 在 Azure Database for MariaDB 服务中创建和管理只读副本。
Azure CLI
可以使用 Azure CLI 创建和管理只读副本。
先决条件
重要
只读副本功能仅适用于“常规用途”或“内存优化”定价层中的 Azure Database for MariaDB 服务器。 请确保源服务器位于其中一个定价层中。
创建只读副本
重要
在为没有现有副本的源创建副本时,该源服务器会先重启,以便为复制做好自身准备。 请考虑这一点并在非高峰期执行这些操作。
可以使用以下命令创建只读副本服务器:
az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup
az mariadb server replica create
命令需要以下参数:
设置 | 示例值 | 说明 |
---|---|---|
resource-group | myresourcegroup | 要在其中创建副本服务器的资源组。 |
name | mydemoreplicaserver | 所创建的新副本服务器的名称。 |
source-server | mydemoserver | 要从中进行复制的现有源服务器的名称或 ID。 |
若要创建跨区域只读副本,请使用 --location
参数。
下面的 CLI 示例在中国北部 2 创建副本。
az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location chinanorth2
注意
若要详细了解可以在哪些区域中创建副本,请访问只读副本概念文章。
注意
只读副本使用与主服务器相同的服务器配置创建。 副本服务器配置在创建后可以更改。 建议副本服务器的配置应始终采用与源服务器相同或更大的值,以确保副本能够与主服务器保持一致。
列出源服务器的副本
若要查看给定源服务器的所有副本,请运行以下命令:
az mariadb server replica list --server-name mydemoserver --resource-group myresourcegroup
az mariadb server replica list
命令需要以下参数:
设置 | 示例值 | 说明 |
---|---|---|
resource-group | myresourcegroup | 要在其中创建副本服务器的资源组。 |
server-name | mydemoserver | 源服务器的名称或 ID。 |
停止复制到副本服务器
重要
停止复制到服务器操作不可逆。 一旦源服务器和副本服务器之间的复制停止,将无法撤消它。 然后,副本服务器将成为独立服务器,并且现在支持读取和写入。 此服务器不能再次成为副本服务器。
可以使用以下命令停止复制到只读副本服务器:
az mariadb server replica stop --name mydemoreplicaserver --resource-group myresourcegroup
az mariadb server replica stop
命令需要以下参数:
设置 | 示例值 | 说明 |
---|---|---|
resource-group | myresourcegroup | 副本服务器所在的资源组。 |
name | mydemoreplicaserver | 要停止在其上进行复制的副本服务器的名称。 |
删除副本服务器
可以通过运行 az mariadb server delete 命令删除只读副本服务器。
az mariadb server delete --resource-group myresourcegroup --name mydemoreplicaserver
删除源服务器
重要
删除源服务器会停止复制到所有副本服务器,并删除源服务器本身。 副本服务器成为现在支持读取和写入的独立服务器。
若要删除源服务器,可以运行 az mariadb server delete 命令。
az mariadb server delete --resource-group myresourcegroup --name mydemoserver
REST API
可以使用 Azure REST API 创建和管理只读副本。
创建只读副本
可以使用创建 API 创建只读副本:
PUT https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{replicaName}?api-version=2017-12-01
{
"location": "chinanorth2",
"properties": {
"createMode": "Replica",
"sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}"
}
}
注意
若要详细了解可以在哪些区域中创建副本,请访问只读副本概念文章。
如果尚未在“常规用途”或“内存优化”源服务器上将 azure.replication_support
参数设置为“REPLICA”并重启服务器,将会收到错误。 请在创建副本之前完成这两个步骤。
使用与主服务器相同的计算和存储设置创建副本。 创建副本后,可以独立于源服务器更改多项设置:计算代系、vCore 数、存储和备份保留期。 定价层也可以独立更改,但“基本”层除外。
重要
将源服务器设置更新为新值之前,请将副本设置更新为一个相等或更大的值。 此操作可帮助副本与主服务器发生的任何更改保持同步。
列出副本
可以使用副本列表 API 查看源服务器的副本列表:
GET https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}/Replicas?api-version=2017-12-01
停止复制到副本服务器
可以使用更新 API 停止源服务器与只读副本之间的复制。
停止复制到源服务器和只读副本后,无法撤消该操作。 只读副本将成为支持读取和写入的独立服务器。 独立服务器不能再次成为副本。
PATCH https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}?api-version=2017-12-01
{
"properties": {
"replicationRole":"None"
}
}
删除源服务器或副本服务器
若要删除源服务器或副本服务器,请使用删除 API:
删除源服务器后,将停止复制到所有只读副本的操作。 只读副本将成为支持读取和写入的独立服务器。
DELETE https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2017-12-01
后续步骤
- 详细了解只读副本