使用 Azure CLI 在 Azure Database for MySQL 灵活服务器中配置服务器参数

项目
07/12/2024

适用于： Azure Database for MySQL 灵活服务器

可以使用 Azure CLI、Azure 命令行实用工具来列出、显示和更新 Azure Database for MySQL 灵活服务器实例的参数。创建服务器时，将使用默认值和推荐值配置服务器参数。

本文介绍如何使用 Azure CLI 列出、显示和更新服务器参数。

注意

可在服务器级别全局更新服务器参数，方法是使用 Azure CLI 或 Azure 门户

先决条件

若要逐步执行本操作方法指南，需要：

Azure Database for MySQL 灵活服务器实例
Azure CLI 命令行实用工具。

为 Azure Database for MySQL 灵活服务器实例列出服务器参数

若要列出 Azure Database for MySQL 灵活服务器实例中的所有参数及其值，请运行 az mysql flexible-server parameter list 命令。

可以列出资源组“myresourcegroup”下服务器 mydemoserver.mysql.database.chinacloudapi.cn 的服务器参数。

az mysql flexible-server parameter list --resource-group myresourcegroup --server-name mydemoserver

有关每个列出参数的定义，请参阅服务器系统变量上的 MySQL 引用部分。

显示服务器参数详细信息

若要显示 Azure Database for MySQL 灵活服务器实例的某个特定参数的详细信息，请运行 az mysql flexible-server parameter show 命令。

本示例显示了资源组“myresourcegroup”下服务器 mydemoserver.mysql.database.chinacloudapi.cn 的服务器参数 slow_query_log 的详细信息。

az mysql flexible-server parameter show --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver

修改服务器参数值

还可以修改某个 Azure Database for MySQL 灵活服务器实例参数的值，这会更新 MySQL 服务器引擎的基础配置值。若要更新服务器参数，请使用 az mysql flexible-server parameter set 命令。

更新资源组“myresourcegroup”下服务器 mydemoserver.mysql.database.chinacloudapi.cn 的服务器参数 slow_query_log。

az mysql flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver --value ON

更新资源组“myresourcegroup”下服务器 mydemoserver.mysql.database.chinacloudapi.cn 的服务器参数 slow_query_log。

az mysql flexible-server parameter set-batch -resource-group myresourcegroup --server-name mydemoserver --source "user-override" --args slow_query_log="ON" audit_log_enabled="ON"

若要重置参数的值，省去可选的 --value 参数，服务将应用默认值。对于上述示例，它将如下所示：

az mysql flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver

此代码会将 slow_query_log 重置为默认值 OFF。

设置不可修改的服务器参数

如果要更新的 Azure Database for MySQL 灵活服务器参数不可修改，则可以选择性地使用 init_connect 在连接级别设置参数。此项可为每个连接到服务器的客户端设置服务器参数。

更新资源组 myresourcegroup 下服务器 mydemoserver.mysql.database.chinacloudapi.cn 的 init_connect 服务器参数，以设置字符集之类的值。

az mysql flexible-server parameter set --name init_connect --resource-group myresourcegroup --server-name mydemoserver --value "SET character_set_client=utf8;SET character_set_database=utf8mb4;SET character_set_connection=latin1;SET character_set_results=latin1;"

注意

init_connect 可用于在会话级别更改无需 SUPER 权限的参数。若要验证是否可以使用 init_connect 设置参数，请执行 set session parameter_name=YOUR_DESIRED_VALUE; 命令，如果出现“拒绝访问；需要 SUPER 权限”错误，则无法使用“init_connect”设置参数。

使用时区参数

设置全局级时区

可以使用 az mysql flexible-server parameter set 命令来设置全局级时区。

以下命令将资源组 myresourcegroup 下的服务器 mydemoserver.mysql.database.chinacloudapi.cn 的 time_zone 服务器参数更新为 +08:00。

az mysql flexible-server parameter set --name time_zone --resource-group myresourcegroup --server-name mydemoserver --value " +08:00"

设置会话级时区

可以通过从 MySQL 命令行或 MySQL Workbench 等工具运行 SET time_zone 命令来设置会话级时区。以下示例将时区设置为 +08:00 时区。

SET time_zone = ' +08:00';

若要了解日期和时间函数，请参阅 MySQL 文档。

备注

若要在会话级别更改时区，必须至少将服务器参数 time_zone 全局更新为所需的时区一次，以便更新 mysql.time_zone_name 表。

后续步骤

如何配置 Azure 门户中的服务器参数

通过