使用 PowerShell 在 Azure Database for MySQL 中配置服务器参数

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

重要

Azure Database for MySQL 单一服务器即将停用。 强烈建议升级到 Azure Database for MySQL 灵活服务器。 要详细了解如何迁移到 Azure Database for MySQL 灵活服务器,请参阅 Azure Database for MySQL 单一服务器发生了什么情况?

可以使用 PowerShell 列出、显示和更新 Azure Database for MySQL 服务器的配置参数。 在服务器级别会公开引擎配置的一个子集,并可以进行修改。

注意

可在服务器级别全局更新服务器参数,方式是使用 Azure CLIPowerShellAzure 门户

先决条件

若要完成本操作指南,需要:

重要

尽管 Az.MySql PowerShell 模块为预览版,但必须使用以下命令从 Az PowerShell 模块单独安装它:Install-Module -Name Az.MySql -AllowPrerelease。 Az.MySql PowerShell 模块正式版推出后,它将会包含在将来的 Az PowerShell 模块发行版中,并在 Azure Cloud Shell 中原生提供。

如果选择在本地使用 PowerShell,请使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。

Azure Cloud Shell

Azure 托管 Azure Cloud Shell(一个可通过浏览器使用的交互式 shell 环境)。 可以将 Bash 或 PowerShell 与 Cloud Shell 配合使用来使用 Azure 服务。 可以使用 Cloud Shell 预安装的命令来运行本文中的代码,而不必在本地环境中安装任何内容。

若要启动 Azure Cloud Shell,请执行以下操作:

选项 示例/链接
选择代码或命令块右上角的“试用”。 选择“试用”不会自动将代码或命令复制到 Cloud Shell。 显示 Azure Cloud Shell 的“试用”示例的屏幕截图。
转到 https://shell.azure.com 或选择“启动 Cloud Shell”按钮可在浏览器中打开 Cloud Shell。 用于启动 Azure Cloud Shell 的按钮。
选择 Azure 门户右上角菜单栏上的 Cloud Shell 按钮。 显示 Azure 门户中的 Cloud Shell 按钮的屏幕截图

若要使用 Azure Cloud Shell,请执行以下操作:

  1. 启动 Cloud Shell。

  2. 选择代码块(或命令块)上的“复制”按钮以复制代码或命令。

  3. 在 Windows 和 Linux 上选择 Ctrl+Shift+V,或在 macOS 上选择 Cmd+Shift+V 将代码或命令粘贴到 Cloud Shell 会话中。

  4. 选择“Enter”运行代码或命令。

列出 Azure Database for MySQL 服务器的服务器配置参数

若要列出服务器中的所有可修改参数及其值,请运行 Get-AzMySqlConfiguration cmdlet。

以下示例列出了资源组 myresourcegroup 中服务器 mydemoserver 的服务器配置参数。

Get-AzMySqlConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver

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

显示服务器配置参数详细信息

若要显示有关服务器的特定配置参数的详细信息,请运行 Get-AzMySqlConfiguration cmdlet 并指定 Name 参数。

本示例显示了资源组“myresourcegroup”下服务器 mydemoserver 的服务器配置参数 slow_query_log 的详细信息。

Get-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver

修改服务器配置参数值

此外,你还可以修改某个服务器配置参数的值,这会更新 MySQL 服务器引擎的基础配置值。 若要更新配置,请使用 Update-AzMySqlConfiguration cmdlet。

更新资源组“myresourcegroup”下服务器 mydemoserver 的服务器配置参数 slow_query_log。

Update-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On

后续步骤