快速入门：使用 Azure CLI 创建 Azure Database for MariaDB 服务器

Azure CLI 可用于从命令行或脚本创建和管理 Azure 资源。 本快速入门教程介绍如何使用 Azure CLI 在大约 5 分钟内在 Azure 资源组中创建 Azure Database for MariaDB 服务器。

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

先决条件

• 如需在本地运行 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 或更高版本。

如果有多个订阅，请选择要计费的资源所在的订阅，或者本身要计费的订阅。 若要选择帐户中的特定订阅 ID，请使用 az account set 命令：

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

创建资源组

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

以下示例在 chinaeast2 位置创建一个名为 myresourcegroup 的资源组：

az group create --name myresourcegroup --location chinaeast2

创建 Azure Database for MariaDB 服务器

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

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

• --sku-name B_Gen5_1 映射到基本、第 5 代和 1 个 vCore。 此选项是可用的最小 SKU。
• --sku-name GP_Gen5_32 映射到常规用途、第 5 层和 32 个 vCore。
• --sku-name MO_Gen5_2 映射到内存优化、第 5 层和 2 个 vCore。

若要按区域和层了解有效值，请参阅定价层。

以下示例在“中国东部 2”区域创建一个名为 mydemoserver 的服务器。 该服务器在资源组 myresourcegroup 中，其服务器管理员登录名为 myadmin。 该服务器为“第 5 代”服务器，属于“常规用途”定价层，有 2 个 vCore。 服务器名称映射到 DNS 名称，必须在 Azure 中全局唯一。 将 <server_admin_password> 替换为你自己的服务器管理员密码。

az mariadb server create --resource-group myresourcegroup --name mydemoserver  --location chinaeast2 --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 --version 10.2

配置防火墙规则

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

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

az mariadb 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

配置 SSL 设置

默认情况下，在服务器和客户端应用程序之间强制实施 SSL 连接。 此默认设置可通过 Internet 加密数据流确保“传输中”数据的安全性。 就本快速入门来说，请禁用服务器的 SSL 连接。 建议不要对生产服务器禁用 SSL。 有关详细信息，请参阅配置应用程序中的 SSL 连接性以安全连接到 Azure Database for MariaDB。

以下示例禁止在 Azure Database for MariaDB 服务器上强制实施 SSL：

az mariadb server update --resource-group myresourcegroup --name mydemoserver --ssl-enforcement Disabled

获取连接信息

若要连接到服务器，需要提供主机信息和访问凭据。 若要获取连接信息，请运行以下命令：

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

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

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.mariadb.database.chinacloudapi.cn",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMariaDB/servers/mydemoserver",
  "location": "chinaeast2",
  "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.DBforMariaDB/servers",
  "userVisibleState": "Ready",
  "version": "10.2"
}

使用 mysql 命令行工具连接到服务器

使用 mysql 命令行工具连接到服务器。 可下载命令行工具并将其安装在计算机上。

若要使用 mysql 命令行工具连接到服务器，请执行以下操作：

1. 连接到服务器：

   mysql -h mydemoserver.mariadb.database.chinacloudapi.cn -u myadmin@mydemoserver -p
   

2. 在 mysql> 提示符处查看服务器状态：

   status
   

   应会看到类似于以下文本的内容：

   C:\Users\>mysql -h mydemoserver.mariadb.database.chinacloudapi.cn -u myadmin@mydemoserver -p
   Enter password: ***********
   Welcome to the MySQL monitor.  Commands end with ; or \g.
   Your MySQL connection id is 65512
   Server version: 5.6.39.0 MariaDB Server
   
   Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
   
   Oracle is a registered trademark of Oracle Corporation and/or its
   affiliates. Other names may be trademarks of their respective
   owners.
   
   Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
   
   mysql> status
   --------------
   mysql  Ver 14.14 Distrib 5.7.23, for Linux (x86_64)
   
   Connection id:          64681
   Current database:
   Current user:           myadmin@40.118.201.21
   SSL:                    Cipher in use is AES256-SHA
   Current pager:          stdout
   Using outfile:          ''
   Using delimiter:        ;
   Server version:         5.6.39.0 MariaDB Server
   Protocol version:       10
   Connection:             mydemoserver.mariadb.database.chinacloudapi.cn via TCP/IP
   Server characterset:    latin1
   Db     characterset:    latin1
   Client characterset:    utf8
   Conn.  characterset:    utf8
   TCP port:               3306
   Uptime:                 1 day 3 hours 28 min 50 sec
   
   Threads: 10  Questions: 29002  Slow queries: 0  Opens: 33  Flush tables: 3  Open tables: 1  Queries per second avg: 0.293
   --------------
   
   mysql>
   

使用 MySQL Workbench 连接服务器

1. 打开客户端计算机上的 MySQL Workbench。 如果尚未安装，请下载并安装此应用程序。

2. 在“设置新连接” 对话框的“参数” 选项卡上，输入以下信息：

   

   设置	建议值	说明
   连接名称	演示连接	输入此连接的标签（连接名称可以是任何内容）
   连接方法	标准 (TCP/IP)	使用 TCP/IP 协议连接到 Azure Database for MariaDB
   主机名	mydemoserver.mariadb.database.chinacloudapi.cn	前面记下的服务器名称。
   端口	3306	Azure Database for MariaDB 的默认端口。
   用户名	myadmin@mydemoserver	前面记下的服务器管理员登录名。
   密码	你的密码	使用之前设置的管理员帐户密码。

3. 若要检查所有参数是否已正确配置，请选择“测试连接” 。

4. 选择该连接，成功连接到服务器。

清理资源

如果不需要将本快速入门中使用的资源用于其他快速入门或教程，则可通过运行以下命令将其删除：

az group delete --name myresourcegroup

如果只需删除在本快速入门中创建的服务器，请运行 az mariadb server delete 命令：

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

后续步骤