使用 PowerShell 自定义 Azure Database for PostgreSQL 服务器参数

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

重要

Azure Database for PostgreSQL - 单一服务器即将停用。 强烈建议升级到 Azure Database for PostgreSQL - 灵活服务器。 有关迁移到 Azure Database for PostgreSQL 灵活服务器的详细信息,请参阅 Azure Database for PostgreSQL 单一服务器的最新动态?

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

先决条件

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

重要

尽管 Az.PostgreSql PowerShell 模块为预览版,但必须使用以下命令从 Az PowerShell 模块单独安装它:Install-Module -Name Az.PostgreSql -AllowPrerelease

使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。

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

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

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

Get-AzPostgreSqlConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver

有关每个列出参数的定义,请参阅环境变量上的 PostgreSQL 引用部分。

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

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

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

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

修改服务器配置参数值

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

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

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

后续步骤