您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az postgres arc-server

备注

此引用是用于 Azure CLI 的 arcdata 扩展的一部分,需要版本2.3.1 或更高版本。 首次运行 az postgres arc-server 命令时,扩展将自动安装。 详细了解扩展。

管理已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

命令

az postgres arc-server create

创建已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server delete

删除已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server edit

编辑已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的配置。

az postgres arc-server endpoint

管理已启用 Azure Arc 的超大规模 PostgreSQL 服务器组终结点。

az postgres arc-server endpoint list

列出已启用 Azure Arc 的超大规模 PostgreSQL 服务器组终结点。

az postgres arc-server list

列出已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server show

显示和已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的详细信息。

az postgres arc-server create

创建已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

若要设置服务器组的密码,请 AZDATA_PASSWORD 设置环境变量。

az postgres arc-server create --name
                              [--coordinator-engine-settings]
                              [--cores-limit]
                              [--cores-request]
                              [--engine-settings]
                              [--engine-version]
                              [--extensions]
                              [--memory-limit]
                              [--memory-request]
                              [--namespace]
                              [--no-external-endpoint]
                              [--no-wait]
                              [--path]
                              [--port]
                              [--storage-class-backups]
                              [--storage-class-data]
                              [--storage-class-logs]
                              [--volume-claim-mounts]
                              [--volume-size-backups]
                              [--volume-size-data]
                              [--volume-size-logs]
                              [--worker-engine-settings]
                              [--workers]

示例

创建已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server create -n pg1

创建具有引擎设置的已启用 Azure Arc 的 PostgreSQL 超大规模服务器组。 下面的两个示例都有效。

az postgres arc-server create -n pg1 --engine-settings "key1=val1"
az postgres arc-server create -n pg1 --engine-settings 'key2=val2'

创建具有批量声明装载的 PostgreSQL 服务器组。

az postgres arc-server create -n pg1 --volume-claim-mounts backup-pvc:backup

为不同节点角色创建具有特定内存限制的 PostgreSQL 服务器组。

az postgres arc-server create -n pg1 --memory-limit "coordinator=2Gi,w=1Gi" --workers 1

必需参数

--name -n

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的名称。

可选参数

--coordinator-engine-settings -c

要应用于“协调器”节点角色的以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。 指定特定于节点角色的设置时,默认设置将被忽略,并替换为此处提供的设置。

--cores-limit

每个节点可用的已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的最大 CPU 核心数。 支持小数核心数。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--cores-request

每个节点计划服务时可使用的最小 CPU 核心数。 支持小数核心数。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--engine-settings

以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。

--engine-version

必须为 11 或 12。 默认值为 12。

默认值: 12
--extensions

应在启动时加载的 Postgres 扩展的逗号分隔列表。 请参阅 postgres 文档了解支持的值。

--memory-limit

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的内存限制,表示为数字后跟 Ki(千字节)、Mi(兆字节)或 Gi(千兆字节)。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--memory-request

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的内存请求,表示为数字后跟 Ki(千字节)、Mi(兆字节)或 Gi(千兆字节)。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--namespace -s

部署了 Azure Arc enabled PostgreSQL 超大规模服务器组的命名空间。

--no-external-endpoint

如果已指定,则不会创建外部服务。 否则,将使用与数据控制器相同的服务类型来创建外部服务。

--no-wait

如果给定,该命令不会等待实例处于就绪状态再返回。

--path -p

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的源 json 文件的路径。 此为可选项。

--port

可选。

--storage-class-backups

要用于备份永久性卷的存储类。

--storage-class-data

要用于数据永久性卷的存储类。

--storage-class-logs

要用于日志永久性卷的存储类。

--volume-claim-mounts

以逗号分隔的卷声明装载列表。 卷声明装载是(相同命名空间中)的一对现有永久性卷声明和卷类型(和可选元数据,具体取决于卷类型),用冒号分隔。将在 PostgreSQL 服务器组的每个 pod 中装入永久性卷。 装载路径可能取决于卷类型。

--volume-size-backups

要用于备份的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。

--volume-size-data

要用于数据的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。

--volume-size-logs

要用于日志的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。

--worker-engine-settings -w

要应用于“工作器”节点角色的以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。 指定特定于节点角色的设置时,默认设置将被忽略,并替换为此处提供的设置。

--workers

要在服务器组中预配的工作器节点数。 在预览版中,不支持减少工作器节点数。 参阅文档以了解更多详细信息。

az postgres arc-server delete

删除已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server delete --name
                              [--engine-version]
                              [--force]
                              [--namespace]

示例

删除已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server delete -n pg1

必需参数

--name -n

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的名称。

可选参数

--engine-version

已弃用。

--force -f

强制删除已启用 Azure Arc 的超大规模 PostgreSQL 服务器组而不进行确认。

--namespace -s

部署了 Azure Arc enabled PostgreSQL 超大规模服务器组的命名空间。 如果未指定命名空间,则使用数据控制器的命名空间。

az postgres arc-server edit

编辑已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的配置。

az postgres arc-server edit --name
                            [--admin-password]
                            [--coordinator-engine-settings]
                            [--cores-limit]
                            [--cores-request]
                            [--engine-settings]
                            [--engine-version]
                            [--extensions]
                            [--memory-limit]
                            [--memory-request]
                            [--namespace]
                            [--no-wait]
                            [--path]
                            [--port]
                            [--replace-engine-settings]
                            [--worker-engine-settings]
                            [--workers]

示例

编辑已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的配置。

az postgres arc-server edit --path ./spec.json -n pg1

编辑具有协调器节点引擎设置的已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server edit -n pg1 --coordinator-engine-settings 'key2=val2'

编辑已启用 Azure Arc 的超大规模 PostgreSQL 服务器组,并使用新设置 key1=val1 替换现有引擎设置。

az postgres arc-server edit -n pg1 --engine-settings 'key1=val1' --replace-engine-settings

必需参数

--name -n

要编辑的已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的名称。 不能更改部署实例时为其指定的名称。

可选参数

--admin-password

如果指定,已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的管理员密码将设置为 AZDATA_PASSWORD 环境变量的值(如果存在),否则为提示的值。

--coordinator-engine-settings -c

要应用于“协调器”节点角色的以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。 指定特定于节点角色的设置时,默认设置将被忽略,并替换为此处提供的设置。

--cores-limit

每个节点可用的已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的最大 CPU 核心数,支持小数核心数。 若要删除 cores_limit,请将其值指定为空字符串。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--cores-request

每个节点计划服务时可使用的最小 CPU 核心数,支持小数核心数。 若要删除 cores_request,请将其值指定为空字符串。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--engine-settings

以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。 提供的设置将与现有设置合并。 若要删除某个设置,请提供一个空值,如“removedKey=”。 如果更改了需要重启的引擎设置,则将重启服务以立即应用该设置。

--engine-version

已弃用。

--extensions

应在启动时加载的 Postgres 扩展的逗号分隔列表。 请参阅 postgres 文档了解支持的值。

--memory-limit

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的内存限制,表示为数字后跟 Ki(千字节)、Mi(兆字节)或 Gi(千兆字节)。 若要删除 memory_limit,请将其值指定为空字符串。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--memory-request

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的内存请求,表示为数字后跟 Ki(千字节)、Mi(兆字节)或 Gi(千兆字节)。 若要删除 memory_request,请将其值指定为空字符串。 (可选)可以按 = 格式指定包含值的以逗号分隔的角色列表. 有效角色为:“协调器”(“c”)、“工作器”(“w”)。 如果未指定角色,则设置将应用于 PostgreSQL 超大规模服务器组的所有节点。

--namespace -s

部署已启用 Azure Arc 的超大规模 PostgreSQL组的命名空间。 如果未指定命名空间,则使用数据控制器的命名空间。 无法更改部署实例的命名空间。

--no-wait

如果给定,该命令不会等待实例处于就绪状态再返回。

--path -p

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的源 json 文件的路径。 此为可选项。

--port

可选。

--replace-engine-settings -r

指定为 --engine-settings 后,会将所有现有自定义引擎设置替换为一组新的设置和值。

--worker-engine-settings -w

要应用于“工作器”节点角色的以逗号分隔的 Postgres 引擎设置列表,格式为“key1=val1, key2=val2”。 指定特定于节点角色的设置时,默认设置将被忽略,并替换为此处提供的设置。

--workers

要在服务器组中预配的工作器节点数。 在预览版中,不支持减少工作器节点数。 参阅文档以了解更多详细信息。

az postgres arc-server list

列出已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server list [--namespace]

示例

列出已启用 Azure Arc 的超大规模 PostgreSQL 服务器组。

az postgres arc-server list

可选参数

--namespace -s

部署已启用 Azure Arc 的超大规模 PostgreSQL组的命名空间。 如果未指定,它将使用数据控制器命名空间。

az postgres arc-server show

显示和已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的详细信息。

az postgres arc-server show --name
                            [--engine-version]
                            [--namespace]
                            [--path]

示例

显示和已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的详细信息。

az postgres arc-server show -n pg1

必需参数

--name -n

已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的名称。

可选参数

--engine-version

已弃用。

--namespace -s

部署已启用 Azure Arc 的超大规模 PostgreSQL组的命名空间。 如果未指定,它将使用数据控制器命名空间。

--path -p

应将已启用 Azure Arc 的超大规模 PostgreSQL 服务器组的完整规范写入到的路径。 如果省略,则会将规范写入标准输出。