通过 Azure 门户、CLI 或 REST API 在 Azure Database for PostgreSQL 灵活服务器中创建和管理只读副本

项目
05/17/2024

适用于：Azure Database for PostgreSQL 灵活服务器

本文介绍如何通过 Azure 门户、CLI 和 REST API 在 Azure Database for PostgreSQL 灵活服务器中创建和管理只读副本。若要详细了解只读副本，请参阅概述。

先决条件

作为主服务器的 Azure Database for PostgreSQL 灵活服务器实例。

注意

在为持久性大量写入密集型主工作负载部署只读副本时，复制滞后时间可能会持续增加，并且可能永远无法赶上主工作负载。这还可能增加主工作负载的存储使用量，因为只有在副本收到 WAL 文件后才会将该文件删除。

查看主服务器设置

在为 Azure Database for PostgreSQL 灵活服务器设置只读副本之前，请确保将主服务器配置为满足必要的先决条件。主服务器上的特定设置可能会影响创建副本的能力。

存储自动增长：主服务器及其只读副本上的存储自动增长设置必须遵守特定准则，以确保一致性并防止复制中断。有关详细规则和设置，请参阅存储自动增长。

在 Azure 门户中，选择要用于副本的 Azure Database for PostgreSQL 灵活服务器实例。
在“概述”对话框中，记下 PostgreSQL 版本（例如 15.4）。此外，请注意主服务器部署到的区域。
在服务器边栏的“设置”下，选择“计算 + 存储”。
查看并记下以下设置：
- 计算层、处理器、大小（例如 Standard_D4ds_v4）。
- 存储
  - 存储大小（例如 128GB）
  - 自动增长
- 高可用性
  - 已弃用/已禁用
  - 可用性区域设置
- 备份设置
  - 保留期
  - 冗余选项
在“设置”下选择“网络” 。
查看网络设置。

注意

本指南中提供的命令适用于 Azure CLI 版本 2.56.0 或更高版本。确保安装了所需的版本或更高版本，以便成功执行这些命令。可以通过在命令行界面中运行 az --version 来查看当前的 Azure CLI 版本。若要将 Azure CLI 更新到最新版本，请按照 Azure CLI 文档中提供的说明进行操作。

若要查看 Azure PostgreSQL 灵活服务器的配置和当前状态，请使用 az postgres flexible-server show 命令。此命令提供有关指定服务器的详细信息。

az postgres flexible-server show \
  --resource-group <resource-group> \
  --name <server-name>

将 <resource-group> 和 <server-name> 替换为要查看的特定资源组和服务器的名称。

查看并记下以下设置：

计算层、处理器、大小（例如 Standard_D4ds_v4）。
存储
- 类型
- 存储大小（例如 128）
- autogrow
高可用性
- 已弃用/已禁用
- 可用性区域设置
备份设置
- 保留期
- 冗余选项

示例响应

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "authConfig": {
    "activeDirectoryAuth": "Disabled",
    "passwordAuth": "Enabled",
    "tenantId": null
  },
  "availabilityZone": "2",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2024-01-06T11:43:44.485537+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "createMode": null,
  "dataEncryption": {
    "geoBackupEncryptionKeyStatus": null,
    "geoBackupKeyUri": null,
    "geoBackupUserAssignedIdentityId": null,
    "primaryEncryptionKeyStatus": null,
    "primaryKeyUri": null,
    "primaryUserAssignedIdentityId": null,
    "type": "SystemManaged"
  },
  "fullyQualifiedDomainName": "{serverName}.postgres.database.chinacloudapi.cn",
  "highAvailability": {
    "mode": "Disabled",
    "standbyAvailabilityZone": null,
    "state": "NotEnabled"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
  "identity": null,
  "location": "China North 3",
  "maintenanceWindow": {
    "customWindow": "Disabled",
    "dayOfWeek": 0,
    "startHour": 0,
    "startMinute": 0
  },
  "minorVersion": "0",
  "name": "{serverName}",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "pointInTimeUtc": null,
  "privateEndpointConnections": null,
  "replica": {
    "capacity": 5,
    "promoteMode": null,
    "promoteOption": null,
    "replicationState": null,
    "role": "Primary"
  },
  "replicaCapacity": 5,
  "replicationRole": "Primary",
  "resourceGroup": "{resourceGroupName}",
  "sku": {
    "name": "Standard_D4ds_v4",
    "tier": "GeneralPurpose"
  },
  "sourceServerResourceId": null,
  "state": "Ready",
  "storage": {
    "autoGrow": "Disabled",
    "iops": 500,
    "storageSizeGb": 128,
    "throughput": null,
    "tier": "P10",
    "type": ""
  },
  "systemData": {
    "createdAt": "2023-11-08T11:27:48.972812+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": null,
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "tags": {},
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "16"
}

若要获取有关 Azure Database for PostgreSQL 灵活服务器的服务器配置信息，特别是为了查看最近引入的功能（如存储自动增长或专用链接）的设置，应使用最新的 API 版本 2023-06-01-preview。 GET 请求的格式如下：

https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2023-06-01-preview

将 {subscriptionId}、{resourceGroupName} 和 {serverName}分别替换为 Azure 订阅 ID、资源组名称和要查看的主服务器的名称。此请求允许你访问主服务器的配置详细信息，确保其已正确设置以创建只读副本。

查看并记下以下设置：

计算层、处理器、大小（例如 Standard_D4ds_v4）。
存储
- 类型
- 存储大小（例如 128）
- autogrow
网络
高可用性
- 已弃用/已禁用
- 可用性区域设置
备份设置
- 保留期
- 冗余选项

示例响应

{
    "sku": {
        "name": "Standard_D4ds_v4",
        "tier": "GeneralPurpose"
    },
    "systemData": {
        "createdAt": "2023-11-22T16:11:42.2461489Z"
    },
    "properties": {
        "replica": {
            "role": "Primary",
            "capacity": 5
        },
        "storage": {
            "type": "",
            "iops": 500,
            "tier": "P10",
            "storageSizeGB": 128,
            "autoGrow": "Disabled"
        },
        "network": {
            "publicNetworkAccess": "Enabled"
        },
        "dataEncryption": {
            "type": "SystemManaged"
        },
        "authConfig": {
            "activeDirectoryAuth": "Disabled",
            "passwordAuth": "Enabled"
        },
        "fullyQualifiedDomainName": "{serverName}.postgres.database.chinacloudapi.cn",
        "version": "15",
        "minorVersion": "4",
        "administratorLogin": "myadmin",
        "state": "Ready",
        "availabilityZone": "1",
        "backup": {
            "backupRetentionDays": 7,
            "geoRedundantBackup": "Disabled",
            "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00"
        },
        "highAvailability": {
            "mode": "Disabled",
            "state": "NotEnabled"
        },
        "maintenanceWindow": {
            "customWindow": "Disabled",
            "dayOfWeek": 0,
            "startHour": 0,
            "startMinute": 0
        },
        "replicationRole": "Primary",
        "replicaCapacity": 5
    },
    "location": "China North 3",
    "tags": {},
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "name": "{serverName}",
    "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

创建只读副本

若要创建只读副本，请遵循以下步骤：

选择要用作主服务器的现有 Azure Database for PostgreSQL 灵活服务器实例。
在服务器边栏中的“设置”下，选择“复制”。
选择“创建副本”。
在“基本信息”窗体中输入以下信息。
选择“审阅 + 创建”以确认创建该副本，或者如果要添加、删除或修改任何防火墙规则，请选择“下一步: 网络”。
将其余字段保留默认值，然后选择页面底部的“查看 + 创建”按钮，或者转到下一个窗体以添加标记或更改数据加密方法。
查看最终确认窗口中的信息。准备就绪后，选择“创建”。将创建新部署。
在部署期间，你将看到主服务器处于 Updating 状态。

创建只读副本后，可以在“复制”窗口中查看它。

可以使用 az postgres flexible-server replica create 命令为 Azure PostgreSQL 灵活服务器创建只读副本。

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

请将 <replica-name>、<resource-group>、<source-server-name> 和 <location> 替换为特定值。

创建只读副本后，可以使用 az postgres flexible-server replica create 命令获取作为主要副本的副本的所有服务器的属性。

az postgres flexible-server replica list \
  --name <source-server-name> \
  --resource-group <resource-group>

将 <source-server-name> 和 <resource-group> 替换为特定值。

使用服务器创建 API 发起 HTTP PUT 请求：

PUT https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

在这里，需要将 {subscriptionId}、{resourceGroupName} 和 {replicaserverName} 分别替换为你的特定 Azure 订阅 ID、资源组的名称和只读副本所需的名称。

{
  "location": "chinanorth3",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

创建只读副本后，可以通过使用通过服务器 API 列出副本发起 HTTP GET 请求，来获取作为主要副本的副本的所有服务器的属性：

GET https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/replicas?api-version=2022-12-01

在此处，需要将 {subscriptionId}、{resourceGroupName} 和 {sourceserverName} 分别替换为特定的 Azure 订阅 ID、资源组名称，以及分配给主要副本的名称。

[
  {
    "administratorLogin": null,
    "administratorLoginPassword": null,
    "authConfig": null,
    "availabilityZone": null,
    "backup": {
      "backupRetentionDays": null,
      "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "createMode": null,
    "dataEncryption": {
      "geoBackupEncryptionKeyStatus": null,
      "geoBackupKeyUri": null,
      "geoBackupUserAssignedIdentityId": null,
      "primaryEncryptionKeyStatus": null,
      "primaryKeyUri": null,
      "primaryUserAssignedIdentityId": null,
      "type": "SystemManaged"
    },
    "fullyQualifiedDomainName": null,
    "highAvailability": null,
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{replicaserverName}",
    "identity": null,
    "location": "chinanorth3",
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "minorVersion": null,
    "name": "{replicaserverName}",
    "network": {
      "delegatedSubnetResourceId": null,
      "privateDnsZoneArmResourceId": null,
      "publicNetworkAccess": "Disabled"
    },
    "pointInTimeUtc": null,
    "privateEndpointConnections": null,
    "replica": {
      "capacity": null,
      "promoteMode": null,
      "promoteOption": null,
      "replicationState": "Active",
      "role": "AsyncReplica"
    },
    "replicaCapacity": null,
    "replicationRole": "AsyncReplica",
    "resourceGroup": "{resourceGroupName}",
    "sku": {
      "name": "",
      "tier": null
    },
    "sourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "iops": null,
      "storageSizeGb": 0,
      "throughput": null,
      "tier": null,
      "type": null
    },
    "systemData": {
      "createdAt": "2023-11-22T17:11:42.2461489Z",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": null,
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "tags": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers",
    "version": null
  }
]

设置副本服务器名称。

提示

使用资源命名约定是云采用框架 (CAF) 的最佳做法，它会支持你轻松确定要连接到或管理的实例，以及实例的驻留位置。
选择与主服务器不同的位置，但请注意，可以选择同一区域。

提示

若要详细了解可以在哪些区域中创建副本，请访问只读副本概念文章。
将计算和存储设置为从主服务器记录的内容。如果显示的计算不匹配，请选择“配置服务器”并选择相应的一个。

注意

如果选择的计算大小小于主服务器，则部署将失败。另请注意，计算大小可能在其他区域中不可用。

重要

查看“只读副本”概述的注意事项部分。

为了避免在提升副本期间出现问题，请先更改副本上的以下服务器参数，然后再在主服务器上应用它们：max_connections、max_prepared_transactions、max_locks_per_transaction、max_wal_senders、max_worker_processes。

将副本提升到独立服务器

还可以中断副本的复制，以将其设为它的独立服务器，而不是切换到副本。

在 Azure 门户中，选择 Azure Database for PostgreSQL 灵活服务器主服务器。
在服务器边栏中服务器菜单上的“设置”下，选择“复制”。
在“服务器”下，选择要提升为独立服务器的副本的“提升”图标。
选择“提升”，该过程将开始。完成后，服务器不再是主服务器的副本。

在 Azure PostgreSQL 灵活服务器中提升副本时，默认行为是将其提升为独立服务器。提升是通过使用 az postgres flexible-server replica promote 命令且不指定 --promote-mode 选项实现的，因为默认采用 standalone 模式。

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name>

在此命令中，将 <resource-group> 和 <replica-server-name> 替换为特定的资源组名称和你创建的第一个副本服务器（不再是虚拟终结点的一部分）的名称。

可以使用 PATCH 请求将副本提升为独立服务器。请将 PATCH 请求发送到指定的 Azure 管理 REST API URL，其中第一个 JSON 正文的 PromoteMode 设置为 standalone，PromoteOption 设置为 planned。第二种 JSON 正文格式（ReplicationRole 设置为 None）已弃用，但为了向后兼容，仍在此处提及。

PATCH https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "standalone",
      "PromoteOption": "planned"
    }
  }
}

{
  "Properties": {
    "ReplicationRole": "None"
  }
}

注意

将副本提升到独立服务器后，将无法将其添加回复制集。

删除副本

删除只读副本的方法与删除独立 Azure Database for PostgreSQL 灵活服务器实例的方法类似。

在 Azure 门户中，打开只读副本的“概述”页。选择“删除”。

也可以在“复制”窗口中遵循以下步骤删除只读副本：

在 Azure 门户中，选择主 Azure Database for PostgreSQL 灵活服务器实例。
在服务器菜单中的“设置”下，选择“复制”。
选择要删除的只读副本，然后选择省略号。选择“删除”。
确认“删除”操作。

若要删除主服务器或副本服务器，请使用 az postgres flexible-server delete 命令。如果服务器具有只读副本，则应先删除只读副本，然后再删除主服务器。

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

将 <resource-group> 和 <server-name> 替换为资源组名称和要删除的副本服务器名称。

若要删除主服务器或副本服务器，请使用服务器删除 API。如果服务器具有只读副本，则应先删除只读副本，然后再删除主服务器。

DELETE https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

删除主服务器

只有在删除所有只读副本后，才能删除主服务器。若要删除副本，请按照删除副本部分中的说明操作，然后继续执行提供的步骤。

若要在 Azure 门户中删除服务器，请遵循以下步骤：

在 Azure 门户中，选择主 Azure Database for PostgreSQL 灵活服务器实例。
打开服务器的“概述”页并选择“删除”。
输入要删除的主服务器的名称。选择“删除”以确认删除主服务器。

若要删除主服务器或副本服务器，请使用 az postgres flexible-server delete 命令。如果服务器具有只读副本，则应先删除只读副本，然后再删除主服务器。

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

将 <resource-group> 和 <server-name> 替换为资源组名称和要删除的主服务器名称。

若要删除主服务器或副本服务器，请使用服务器删除 API。如果服务器具有只读副本，则应先删除只读副本，然后再删除主服务器。

DELETE https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}?api-version=2022-12-01

监视副本

可以使用两个指标来监视只读副本。

物理复制最大滞后时间

仅在主服务器上可用。

“物理复制最大滞后”指标显示主服务器与滞后最大的副本之间的滞后（以字节为单位）。

在 Azure 门户中，选择主服务器。
选择“指标”。在“指标”窗口中，选择“物理复制最大滞后时间”。
对于“聚合”，请选择“最大”。

“只读副本滞后时间”指标

“只读副本滞后时间”指标显示自从在副本上最后一次执行重放事务以来所经历的时间。如果主服务器上未发生任何事务，则该指标会反映此滞后时间。例如，如果主服务器上未发生任何事务，并且最后一个事务是在 5 秒前重放的，则只读副本滞后将显示 5 秒延迟。

在 Azure 门户中，选择只读副本。
选择“指标”。在“指标”窗口中，选择“只读副本滞后时间”。
对于“聚合”，请选择“最大”。

Azure Database for PostgreSQL 灵活服务器中的只读副本

Share via

通过 Azure 门户、CLI 或 REST API 在 Azure Database for PostgreSQL 灵活服务器中创建和管理只读副本

先决条件

查看主服务器设置

创建只读副本

将副本提升到独立服务器

删除副本

删除主服务器

监视副本

物理复制最大滞后时间

“只读副本滞后时间”指标

其他资源

Share via

通过 Azure 门户、CLI 或 REST API 在 Azure Database for PostgreSQL 灵活服务器中创建和管理只读副本

先决条件

查看主服务器设置

创建只读副本

将副本提升到独立服务器

删除副本

删除主服务器

监视副本

物理复制最大滞后时间

“只读副本滞后时间”指标

相关内容

其他资源