教程：使用 Azure CLI 设计 Azure Database for MySQL

项目
06/20/2022

适用于： Azure Database for MySQL - 单一服务器

重要

Azure Database for MySQL 单一服务器即将停用。强烈建议升级到 Azure Database for MySQL 灵活服务器。有关如何迁移到 Azure Database for MySQL 灵活服务器的详细信息，请参阅 Azure Database for MySQL 单一服务器发生了什么情况？

Azure Database for MySQL 是 Microsoft 云中基于 MySQL Community Edition 数据库引擎的一种关系型数据库服务。在本教程中，需使用 Azure CLI（命令行接口）以及其他实用工具了解如何完成以下操作：

创建 Azure Database for MySQL
配置服务器防火墙
使用 mysql 命令行工具创建数据库
加载示例数据
查询数据
更新数据
还原数据

如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

先决条件

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

本文需要 Azure CLI 版本 2.0 或更高版本。如果使用 Azure Cloud Shell，则最新版本已安装。

如果有多个订阅，请选择资源所在的相应订阅或对资源进行计费的订阅。使用 az account set 命令选择帐户下的特定订阅 ID。

az account set --subscription 00000000-0000-0000-0000-000000000000

创建资源组

使用 az group create 命令创建 Azure 资源组。资源组是在其中以组的形式部署和管理 Azure 资源的逻辑容器。

以下示例在 westus 位置创建名为 myresourcegroup 的资源组。

az group create --name myresourcegroup --location westus

创建 Azure Database for MySQL 服务器

使用 az mysql server create 命令创建 Azure Database for MySQL 服务器。一个服务器可以管理多个数据库。通常，每个项目或每个用户使用一个单独的数据库。

以下示例在资源组 myresourcegroup 中的 westus 处创建名为 mydemoserver 的 Azure Database for MySQL 服务器。该服务器的管理员用户名为 myadmin。它是一台常规用途第 5 代服务器，具有 2 个 vCore。用自己的值替换 <server_admin_password>。

az mysql server create --resource-group myresourcegroup --name mydemoserver --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 --version 5.7

sku-name 参数值遵循 {定价层}_{计算层代}_{vCore 数} 约定，如以下示例中所示：

--sku-name B_Gen5_2 映射到基本、第 5 代和 2 个 vCore。
--sku-name GP_Gen5_32 映射到常规用途、第 5 层和 32 个 vCore。
--sku-name MO_Gen5_2 映射到内存优化、第 5 层和 2 个 vCore。

请参阅定价层文档来了解适用于每个区域和每个层的有效值。

重要

此处指定的服务器管理员登录名和密码是以后在本快速入门中登录到服务器及其数据库所必需的。请牢记或记录此信息，以后会使用到它。

配置防火墙规则

使用 az mysql server firewall-rule create 命令创建 Azure Database for MySQL 服务器级防火墙规则。服务器级防火墙规则允许外部应用程序（如 mysql 命令行工具或 MySQL Workbench）通过 Azure MySQL 服务防火墙连接到服务器。

以下示例创建名为 AllowMyIP 的防火墙规则，该规则允许从特定的 IP 地址 (192.168.0.1) 进行连接。替代与要从其进行连接的地址相对应的 IP 地址或 IP 地址范围。

az mysql server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

获取连接信息

若要连接到服务器，需要提供主机信息和访问凭据。

az mysql server show --resource-group myresourcegroup --name mydemoserver

结果采用 JSON 格式。记下 fullyQualifiedDomainName 和 administratorLogin 。

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "fullyQualifiedDomainName": "mydemoserver.mysql.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMySQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
 "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforMySQL/servers",
  "userVisibleState": "Ready",
  "version": "5.7"
}

使用 mysql 连接服务器

使用 mysql 命令行工具建立与 Azure Database for MySQL 数据库的连接。在此示例中，该命令是：

mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p

创建空数据库

连接到服务器后，创建一个空数据库。

mysql> CREATE DATABASE mysampledb;

出现提示时，请运行以下命令，切换为连接此新建的数据库：

mysql> USE mysampledb;

在数据库中创建表

现已介绍了如何连接 Azure Database for MySQL 数据库，接下来可以完成一些基本任务。

首先，创建表并加载一些数据。创建一个存储清单信息的表。

CREATE TABLE inventory (
	id serial PRIMARY KEY, 
	name VARCHAR(50), 
	quantity INTEGER
);

将数据加载到表

表格创建好后，可向其插入一些数据。在打开的命令提示窗口中，运行以下查询来插入几行数据。

INSERT INTO inventory (id, name, quantity) VALUES (1, 'banana', 150); 
INSERT INTO inventory (id, name, quantity) VALUES (2, 'orange', 154);

现已将两行示例数据加载到了之前创建的表中。

查询和更新表中的数据

执行以下查询，从数据库表中检索信息。

SELECT * FROM inventory;

还可以更新表中的数据。

UPDATE inventory SET quantity = 200 WHERE name = 'banana';

检索数据时行也会相应进行更新。

SELECT * FROM inventory;

将数据库还原到以前的时间点

假设意外删除了此表。这是不能轻易还原的内容。借助 Azure Database for MySQL，可返回到最近 35 天内的任意时间点并将此时间点还原到新的服务器。可以使用此新服务器恢复已删除的数据。以下步骤将示例服务器还原到添加此表之前的时间点。

执行还原需要以下信息：

还原点：选择更改服务器前的时间点。必须大于或等于源数据库的最早备份值。
目标服务器：提供一个要还原到的新服务器名称
源服务器:提供想从中进行还原的服务器的名称
位置：不能选择区域，此区域默认与源服务器相同

az mysql server restore --resource-group myresourcegroup --name mydemoserver-restored --restore-point-in-time "2017-05-4 03:10" --source-server-name mydemoserver

az mysql server restore 命令需以下参数：

设置	建议值	说明
resource-group	myresourcegroup	源服务器所在的资源组。
name	mydemoserver-restored	通过还原命令创建的新服务器的名称。
restore-point-in-time	2017-04-13T13:59:00Z	选择要还原到的时间点。此日期和时间必须在源服务器的备份保留期限内。使用 ISO8601 日期和时间格式。例如，可使用自己的本地时区（如 `2017-04-13T05:59:00-08:00`），或使用 UTC Zulu 格式 `2017-04-13T13:59:00Z`。
source-server	mydemoserver	要从其还原的源服务器的名称或 ID。

将服务器还原到某个时间点会创建一个新服务器，该服务器是通过复制所指定的时间点之前那段时间的原始服务器而生成的。还原的服务器的位置值和定价层值与源服务器相同。

该命令是同步的，且会在服务器还原后返回。还原完成后，找到创建的新服务器。验证数据是否按预期还原。

清理资源

如果不需要将这些资源用于其他快速入门/教程，则可通过执行以下命令将其删除：

az group delete --name myresourcegroup

若要删除新创建的服务器，可运行 az mysql server delete 命令。

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

后续步骤

本教程介绍了：

创建 Azure Database for MySQL 服务器
配置服务器防火墙
使用 mysql 命令行工具创建数据库
加载示例数据
查询数据
更新数据
还原数据

Azure Database for MySQL - Azure CLI 示例

通过