使用 Azure CLI 自定义 Azure Database for PostgreSQL(单一服务器)的服务器配置参数Customize server configuration parameters for Azure Database for PostgreSQL - Single Server using Azure CLI

可以使用命令行接口 (Azure CLI) 列出、显示和更新 Azure PostgreSQL 服务器的配置参数。You can list, show, and update configuration parameters for an Azure PostgreSQL server using the Command Line Interface (Azure CLI). 会在服务器级别公开引擎配置的一个子集,并且可以进行修改。A subset of engine configurations is exposed at server-level and can be modified.

必备条件Prerequisites

若要逐步执行本操作方法指南,需要:To step through this how-to guide, you need:

列出 Azure Database for PostgreSQL 服务器的服务器配置参数List server configuration parameters for Azure Database for PostgreSQL server

若要列出服务器中的所有可修改参数及其值,请运行 az postgres server configuration list 命令。To list all modifiable parameters in a server and their values, run the az postgres server configuration list command.

可以列出资源组“myresourcegroup”下服务器 mydemoserver.postgres.database.chinacloudapi.cn 的服务器配置参数。You can list the server configuration parameters for the server mydemoserver.postgres.database.chinacloudapi.cn under resource group myresourcegroup.

az postgres server configuration list --resource-group myresourcegroup --server mydemoserver

显示服务器配置参数详细信息Show server configuration parameter details

若要显示服务器的某个特定配置参数的详细信息,请运行 az postgres server configuration show 命令。To show details about a particular configuration parameter for a server, run the az postgres server configuration show command.

本示例显示了资源组“myresourcegroup”下服务器 mydemoserver.postgres.database.chinacloudapi.cn 的服务器配置参数 log_min_messages 的详细信息。This example shows details of the log_min_messages server configuration parameter for server mydemoserver.postgres.database.chinacloudapi.cn under resource group myresourcegroup.

az postgres server configuration show --name log_min_messages --resource-group myresourcegroup --server mydemoserver

修改服务器配置参数值Modify server configuration parameter value

还可以修改某个服务器配置参数的值,这会更新 PostgreSQL 服务器引擎的基础配置值。You can also modify the value of a certain server configuration parameter, which updates the underlying configuration value for the PostgreSQL server engine. 若要更新配置,请使用 az postgres server configuration set 命令。To update the configuration, use the az postgres server configuration set command.

更新资源组“myresourcegroup”下服务器 mydemoserver.postgres.database.chinacloudapi.cn 的服务器配置参数 log_min_messagesTo update the log_min_messages server configuration parameter of server mydemoserver.postgres.database.chinacloudapi.cn under resource group myresourcegroup.

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO

若要重置配置参数的值,只需选择省略可选的 --value 参数,服务将应用默认值。If you want to reset the value of a configuration parameter, you simply choose to leave out the optional --value parameter, and the service applies the default value. 以上述示例为例,它类似于下面这样:In above example, it would look like:

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver

此命令会将 log_min_messages 配置重置为默认值 WARNINGThis command resets the log_min_messages configuration to the default value WARNING. 有关服务器配置和允许值的详细信息,请参阅有关服务器配置的 PostgreSQL 文档。For more information on server configuration and permissible values, see PostgreSQL documentation on Server Configuration.

后续步骤Next steps