如何通过Azure CLI创建非ARC PostgreSQL Hyperscale Citus数据库

完全可以通过Azure CLI完成该类型数据库的全量创建操作，不需要依赖Azure Portal，也不涉及任何Arc-enabled Kubernetes相关操作。很多人没找到对应方法，是因为Hyperscale (Citus)的CLI命令独立归类在az postgres server-group命令组下，和常规单服务器、灵活服务器的命令分支不互通。

前置准备 #

• 本地安装的Azure CLI版本不低于2.40.0，可执行az version查看当前版本，版本过低时执行az upgrade完成升级
• 执行az login完成账号身份认证，确认账号对目标资源组拥有参与者及以上权限
• 提前确认部署参数：目标资源组、部署区域、服务器组名称、管理员账号密码、协调器/工作节点的计算存储规格、工作节点数量、PostgreSQL与Citus版本

操作步骤 #

1. 首次使用该服务时，先注册对应资源提供程序：

az provider register --namespace Microsoft.DBforPostgreSQL

等待注册完成后，可执行以下命令校验状态，返回Registered即为注册成功：

az provider show --namespace Microsoft.DBforPostgreSQL --query registrationState -o tsv

2. 执行创建命令，以下为通用公网部署示例：

az postgres server-group create \
  --resource-group <替换为你的目标资源组名称> \
  --name <替换为你的Citus服务器组全局唯一名称> \
  --location <替换为目标区域，例如chinaeast2、eastus> \
  --administrator-login <替换为自定义管理员用户名，不能使用azure_superuser、admin、root等系统保留名> \
  --administrator-login-password <替换为自定义管理员密码，要求长度8-128位，同时包含大小写字母、数字、非字母数字特殊字符三类> \
  --enable-public-network true \
  --coordinator-server-edition GeneralPurpose \
  --coordinator-vcores 4 \
  --coordinator-storage-gb 128 \
  --node-server-edition GeneralPurpose \
  --node-vcores 4 \
  --node-storage-gb 512 \
  --node-count 2 \
  --postgresql-version 15 \
  --citus-version 12

参数说明：

• 上述示例会部署2个工作节点的生产级Citus集群：协调器为4核通用规格、128GB存储，工作节点为4核通用规格、512GB存储，使用PostgreSQL 15、Citus 12版本，开启公网访问
• 如果需要私网部署，将--enable-public-network设为false，额外补充--subnet-arm-resource-id <预配置好的PostgreSQL委托子网资源ID>参数即可
• --node-count支持0-20的取值，设为0时为单节点Citus部署，适合本地测试、小规模场景使用

3. 校验部署结果：
   执行以下命令查看服务器组详情，返回结果中provisioningState字段值为Succeeded即代表创建完成：

az postgres server-group show --resource-group <资源组名称> --name <服务器组名称>

注意事项 #

该套命令仅针对Azure公有云上的托管式Hyperscale (Citus)服务，和Arc-enabled Kubernetes场景下的Citus部署命令完全独立，不存在交叉依赖。
后续如果需要调整节点数量、扩缩容计算存储规格、修改防火墙规则，都可以通过az postgres server-group update命令完成，所有Portal支持的配置操作都有对应的CLI参数覆盖。

内容的提问来源于stack exchange，提问作者mobiusinversion