你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
快速入门：使用 az postgres up 命令创建 Azure Database for PostgreSQL - 单一服务器
适用于：
Azure Database for PostgreSQL 单一服务器
重要
Azure Database for PostgreSQL - 单一服务器即将停用。 我们强烈建议升级到 Azure Database for PostgreSQL 灵活服务器。 有关迁移到 Azure Database for PostgreSQL 灵活服务器的详细信息，请参阅 Azure Database for PostgreSQL 单一服务器的最新动态。
用于 PostgreSQL 的 Azure 数据库是一种托管服务，可用于在云中运行、管理和缩放具有高可用性的 PostgreSQL 数据库。 Azure CLI 用于从命令行或脚本创建和管理 Azure 资源。 此快速入门介绍了如何使用 az postgres up 命令和 Azure CLI 来创建 Azure Database for PostgreSQL 服务器。 除了创建服务器，az postgres up 命令还会创建示例数据库、在数据库中创建根用户、为 Azure 服务打开防火墙，并为客户端计算机创建默认防火墙规则。 这些默认值有助于加快开发过程。
如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。
创建 Azure Database for PostgreSQL 服务器
先决条件
在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。
出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。
启动 Azure Cloud Shell
Azure Cloud Shell 是免费的交互式 shell，可以使用它运行本文中的步骤。 它预安装有常用 Azure 工具并将其配置与帐户一起使用。
若要打开 Cloud Shell，只需要从代码块的右上角选择“试一试”。 也可以通过转到 https://shell.azure.com 在单独的浏览器标签页中启动 Cloud Shell。
当 Cloud Shell 打开时，请验证是否为环境选择了“Bash”。 后续会话将在 Bash 环境中使用 Azure CLI，选择“复制”以复制代码块，将其粘贴到 Cloud Shell 中，然后按 Enter 来运行它。
登录 Azure
Cloud Shell 会在登录时使用的初始帐户下自动进行身份验证。 使用以下脚本通过其他订阅登录，将 <Subscription ID> 替换为 Azure 订阅 ID。 如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
安装 db-up 扩展。 如果返回错误，则请确保已安装最新版本的 Azure CLI。 请参阅安装 Azure CLI。
az extension add --name db-up
若要使用以下命令创建 Azure Database for PostgreSQL 服务器：
az postgres up
服务器是使用以下默认值创建的（除非手动替代它们）：
| 设置 | 默认值 | 说明 |
|---|---|---|
| server-name | 系统生成的 | 用于标识用于 PostgreSQL 的 Azure 数据库服务器的唯一名称。 |
| resource-group | 系统生成的 | 新的 Azure 资源组。 |
| sku-name | GP_Gen5_2 | SKU 的名称。 请遵循简写约定 {pricing tier}_{compute generation}_{vCores}。 默认为带 2 个 vCore 的常规用途 Gen5 服务器。 有关各层的详细信息，请参阅定价页。 |
| backup-retention | 7 | 备份保留的期限。 单位为天。 |
| geo-redundant-backup | 已禁用 | 是否应该为此服务启用异地冗余备份。 |
| location | westus2 | 服务器的 Azure 位置。 |
| ssl-enforcement | 已禁用 | 是否应该为此服务器启用 TLS/SSL。 |
| storage-size | 5120 | 服务器的存储容量（以 MB 为单位）。 |
| 版本 | 10 | PostgreSQL 主版本。 |
| admin-user | 系统生成的 | 管理员用户名。 |
| admin-password | 系统生成的 | 管理员用户的密码。 |
注意
有关 az postgres up 命令及其附加参数的详细信息，请参阅 Azure CLI 文档。
服务器创建后，随附有以下设置：
- 创建了一条名为“devbox”的防火墙规则。 Azure CLI 尝试检测运行
az postgres up命令的计算机的 IP 地址，并允许此 IP 地址。 - “允许访问 Azure 服务”设置为“开”。 此设置会将服务器的防火墙配置为接受来自所有 Azure 资源（包括非订阅中的资源）的连接。
- 创建了一个名为“sampledb”的空数据库
- 创建了一个特权为“sampledb”且名为“root”的新用户
注意
Azure Database for PostgreSQL 通过端口 5432 进行通信。 从企业网络内部进行连接时，该网络的防火墙可能不允许经端口 5432 的出站流量。 让 IT 部门打开端口 5432 以连接到你的服务器。
获取连接信息
在完成 az postgres up 命令后，将向你返回一个常用编程语言连接字符串列表。 这些连接字符串使用你新创建的 Azure Database for PostgreSQL 服务器的特定属性进行了预配置。
可使用 az postgres show-connection-string 命令再次列出这些连接字符串。
清理资源
请使用以下命令清除在此快速入门中创建的所有资源。 此命令会删除 Azure Database for PostgreSQL 服务器和资源组。
az postgres down --delete-group
若要删除新创建的服务器，可运行 az postgres down 命令。
az postgres down