你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure CLI 管理 Azure Database for PostgreSQL 单一服务器

  • 项目

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

重要

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

本文介绍如何管理 Azure 中部署的单一服务器。 管理任务包括计算和存储缩放、管理员密码重置，以及查看服务器详细信息。

先决条件

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。 本文要求在本地运行 Azure CLI 2.0 或更高版本。 若要查看安装的版本，请运行 az --version 命令。 如果需要进行安装或升级，请参阅安装 Azure CLI。

你将需要使用 az login 命令登录到你的帐户。 请注意 id 属性，该属性指的是 Azure 帐户的订阅 ID。

az login

使用 az account set 命令选择帐户下的特定订阅。 记下 az login 输出中的 id 值，以用作命令中订阅参数的值。 如果有多个订阅，请选择应计费的资源所在的相应订阅。 若要获取所有订阅，请使用 az account list。

az account set --subscription <subscription id>

如果尚未创建服务器，请参考此快速入门创建一个。

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”运行代码或命令。

缩放计算和存储

可以使用以下命令轻松地纵向扩展定价层、计算和存储。 可以参阅 az postgres server 概述，了解可执行的所有服务器操作

az postgres server update --resource-group myresourcegroup --name mydemoserver --sku-name GP_Gen5_4 --storage-size 6144

下面是上述参数的详细信息：

设置 示例值 说明
name mydemoserver 输入 Azure Database for PostgreSQL 服务器的唯一名称。 服务器名称只能包含小写字母、数字和连字符 (-) 字符。 必须包含 3 到 63 个字符。
resource-group myresourcegroup 提供 Azure 资源组的名称。
sku-name GP_Gen5_2 输入定价层和计算配置的名称。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 有关详细信息，请参阅定价层。
storage-size 6144 服务器的存储容量（以 MB 为单位）。 最小值为 5120，以 1024 为增量递增。

重要

  • 存储可以纵向扩展（但不能纵向缩减）
  • 不支持从“基本”定价层纵向扩展到“常规用途”或“内存优化”定价层。 可以使用 bash 脚本或使用 PostgreSQL Workbench 进行手动纵向扩展

管理服务器上的 PostgreSQL 数据库。

可以使用以下任何命令来创建、删除、列出和查看服务器上数据库的数据库属性。

Cmdlet 使用情况 说明
az postgres db create az postgres db create -g myresourcegroup -s mydemoserver -n mydatabasename 创建数据库
az postgres db delete az postgres db delete -g myresourcegroup -s mydemoserver -n mydatabasename 从服务器中删除数据库。 此命令不会删除服务器。
az postgres db list az postgres db list -g myresourcegroup -s mydemoserver 列出服务器上的所有数据库
az postgres db show az postgres db show -g myresourcegroup -s mydemoserver -n mydatabasename 显示数据库的更多详细信息

更新管理员密码

可以使用此命令更改管理员角色的密码

az postgres server update --resource-group myresourcegroup --name mydemoserver --admin-password <new-password>

重要

请确保密码至少有 8 个字符，至多有 128 个字符。 密码必须包含以下类别中的三个类别的字符：英文大写字母、英文小写字母、数字和非字母数字字符。

删除服务器

如果只想删除 PostgreSQL 单一服务器，可运行 az postgres server delete 命令。

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

后续步骤