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

Artículo
23/04/2025

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

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

先决条件

创建 Azure Database for PostgreSQL 灵活服务器作为主服务器。

Nota

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

查看主要设置

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

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

高级 SSD v2：当前版本不支持使用高级 SSD v2 存储为主服务器创建只读副本。如果工作负载需要只读副本，请为主服务器选择不同的存储选项。

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

Nota

本指南中提供的命令适用于 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）
- 自动增长
高可用性
- 启用/禁用
- 可用性区域设置
备份设置
- 保留期
- 冗余选项

示例响应

{
  "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）
- 自动增长
网络
高可用性
- 启用/禁用
- 可用性区域设置
备份设置
- 保留期
- 冗余选项

示例响应

{
    "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> 替换为特定值。

使用HTTP PUT 发起请求：

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

在此处，需要分别用特定的 Azure 订阅 ID、资源组名称以及只读副本所需名称来替换 {subscriptionId}、{resourceGroupName} 和 {replicaserverName}。

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

创建只读副本后，可以通过使用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
  }
]

设置副本服务器名称。

Sugerencia

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

Sugerencia

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

Nota

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

Importante

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

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

创建虚拟终结点

Nota

涉及虚拟终结点的所有操作，例如添加、编辑和删除，都在主服务器的上下文中执行。

在 Azure 门户中，选择主服务器。
在服务器边栏中的“设置”下，选择“复制”。
选择“创建终结点”。
在对话框中，为终结点键入有意义的名称。请注意正在生成的 DNS 终结点。
选择“创建”。

Nota

如果不创建虚拟终结点，在尝试提升副本时会收到错误消息。

可以使用 az postgres flexible-server virtual-endpoint create 命令创建虚拟终结点。

    az postgres flexible-server virtual-endpoint create \
      --resource-group <resource-group> \
      --server-name <primary-name> \
      --name <virtual-endpoint-name> \
      --endpoint-type ReadWrite \
      --members <replica-name>

请将 <resource-group>、<primary-name>、<virtual-endpoint-name> 和 <replica-name> 替换为特定值。

若要使用 Azure 的 REST API 创建虚拟终结点，请使用 HTTP PUT 请求。请求应如下所示：

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

此请求的随附 JSON 正文如下所示：

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
}

此处 {replicaserverName} 应替换为要作为读取者终结点目标包含在此虚拟终结点中的副本服务器的名称。

列出虚拟终结点

若要列出虚拟终结点，请执行以下步骤：

在 Azure 门户中，选择主服务器。
在服务器边栏中的“设置”下，选择“复制”。
页面顶部会显示读取器和编写器终结点，以及它们指向的服务器的名称。

可以使用 list 或 show 命令查看虚拟终结点的详细信息。由于每个主要副本对只允许一个虚拟终结点，因此这两个命令生成相同的结果。

以下示例演示如何使用 list 命令：

az postgres flexible-server virtual-endpoint list \
      --resource-group <resource-group> \
      --server-name <server-name>

请将 <server-name> 替换为主服务器的名称，将 <resource-group> 替换为资源组的名称。

下面演示如何使用 show 命令：

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

在此命令中，请将 <virtual-endpoint-name>、<server-name> 和 <resource-group> 替换为相应的名称。 <server-name> 是主服务器的名称。

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

此处 {sourceserverName} 应是管理虚拟终结点的主服务器的名称。

修改应用程序以指向虚拟终结点

修改使用 Azure Database for PostgreSQL 灵活服务器实例的所有应用程序，以使用新的虚拟终结点（例如：corp-pg-001.writer.postgres.database.chinacloudapi.cn 和 corp-pg-001.reader.postgres.database.chinacloudapi.cn）。

提升副本

准备好所有必要组件后，即可执行将副本提升到主副本的操作。

若要通过 Azure 门户提升副本，请执行以下步骤：

在 Azure 门户中，选择主 Azure Database for PostgreSQL 灵活服务器实例。
在服务器菜单中的“设置”下，选择“复制”。
在“服务器”下，选择副本的“提升”图标。
在对话框中，确保操作为“提升到主服务器”。
对于“数据同步”，确保已选择“已计划 - 提升前同步数据”。
选择“提升”以开始该过程。完成后，角色将反转：副本变为主副本，主副本则转变为副本的角色。

将副本提升到 Azure PostgreSQL 灵活服务器中的主服务器时，请使用 az postgres flexible-server replica promote 命令。此过程对于将副本服务器提升为主服务器，以及将当前主服务器降级为副本角色至关重要。在命令中指定 --promote-mode switchover 和 --promote-option planned。

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

请将 <resource-group> 和 <replica-server-name> 替换为特定的资源组和副本服务器名称。此命令可确保以计划的方式顺利将副本转换为主副本角色。

将副本提升为主服务器时，使用具有特定 HTTP PATCH 正文的 JSON 请求来设置提升选项。需要提升副本服务器以充当主服务器时，此过程至关重要。

HTTP 请求的结构如下：

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

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

在此 JSON 中，通过使用 switchover 提升选项将提升设置为在 planned 模式下发生。虽然有两个促销选项 - planned 或 forced - 但在此练习中请选择 planned。

Nota

要升级的副本须具有分配的读取者虚拟终结点，否则提升时会显示错误。

测试应用程序

若要执行某些操作，请重启应用程序，然后尝试这些操作。应用程序应无缝运行，而无需修改虚拟终结点连接字符串或 DNS 条目。此次让应用程序保持运行状态。

故障回复到原始服务器和区域

重复相同的操作，将原始服务器提升为主副本。

在 Azure 门户中，选择副本。
在服务器边栏的“设置”下，选择“复制”
在“服务器”下，选择副本的“提升”图标。
在对话框中，确保操作为“提升到主服务器”。
对于“数据同步”，确保已选择“已计划 - 提升前同步数据”。
选择“提升”，该过程将开始。完成后，角色将反转：副本变为主副本，主副本则转变为副本的角色。

这一次，请更改 <replica-server-name> 命令中的 az postgres flexible-server replica promote 以引用旧的主服务器（该服务器当前充当副本），然后再次执行请求。

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

请将 <resource-group> 和 <replica-server-name> 替换为特定的资源组和当前副本服务器名称。

这一次，更改 API 请求中的 {replicaserverName} 以引用旧主服务器（该服务器当前充当副本），然后再次执行请求。

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

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

测试应用程序

同样，切换到其中一个使用中的应用程序。等待主服务器和副本状态更改为 Updating，然后尝试执行一些操作。在副本提升期间，应用程序可能会遇到临时的与终结点的连接问题：

添加次要只读副本

在单独的区域中创建次读副本，以修改读者虚拟终结点，从而允许创建与第一个副本独立的服务器。

在 Azure 门户中，选择主 Azure Database for PostgreSQL 灵活服务器实例。
在服务器边栏中的“设置”下，选择“复制”。
选择“创建副本”。
向“基本信息”窗体输入第三区域的信息（例如 chinanorth3 和 corp-pg-chinanorth-001）
选择“审阅 + 创建”以确认创建该副本，或者如果要添加、删除或修改任何防火墙规则，请选择“下一步: 网络”。
验证防火墙设置。请注意主要设置如何被自动复制。
保留剩余的默认值，然后选择页面底部的“审阅 + 创建”按钮，或转到以下表单以配置安全性或添加标记。
查看最终确认窗口中的信息。准备就绪后，选择“创建”。将创建新的部署。
在部署期间，你将看到主服务器处于 Updating 状态。

可使用 az postgres flexible-server replica create 命令创建一个次要只读副本。

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> 替换为特定值。

可使用服务器创建 API 创建一个次要只读副本：

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

为 {replicaserverName} 选择不同的名称，以将其与主服务器和其他所有副本区分开来。

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

位置设置为 chinanorth3，但你可以根据地理和运营需求对设置进行调整。

修改虚拟终结点

在 Azure 门户中，选择主 Azure Database for PostgreSQL 灵活服务器实例。
在服务器边栏中的“设置”下，选择“复制”。
选择省略号，然后选择“编辑”。
在对话框中，选择新的次要副本。
选择“保存”。读取者终结点现在指向次要副本，提升操作现在绑定到此副本。

现在，可以使用 az postgres flexible-server virtual-endpoint update 命令修改读取器终结点，以指向新建的次要副本。记得将 <replica-name> 替换为新创建的只读副本的名称。

az postgres flexible-server virtual-endpoint update \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name> \
  --endpoint-type ReadWrite \
  --members <replica-name>

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

现在，可以使用 PATCH 请求修改读取器终结点，以指向新创建的次要副本。记得将 {replicaserverName} 替换为新创建的只读副本的名称。

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

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
}

将副本提升为独立服务器

在切换到副本之外，还可以中断副本的复制，使其成为其独立服务器。

在 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 请求将副本提升为独立服务器。向指定的 Azure 管理 REST API URL 发送一个 PATCH 请求，其中包含第一个 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"
  }
}

Nota

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

删除虚拟终结点

在 Azure 门户中，选择主服务器。
在服务器边栏中的“设置”下，选择“复制”。
在页面顶部找到 Virtual endpoints 分区。导航到终结点名称旁边的三个点（菜单选项），展开它，然后选择 Delete。
将显示确认删除对话框。它会发出警告：“此操作会删除虚拟终结点 virtualendpointName。任何使用这些域连接的客户端都可能会失去访问权限。”确认知晓影响并单击“删除”以确认。

若要从 Azure PostgreSQL 灵活服务器中删除虚拟终结点，可以使用 az postgres flexible-server virtual-endpoint delete 命令。此操作将永久删除指定的虚拟终结点。

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

在此命令中，请将 <resource-group>、<server-name> 和 <virtual-endpoint-name> 替换为特定的资源组、服务器名称和要删除的虚拟终结点的名称。

若要使用 Azure 的 REST API 删除虚拟终结点，需要发出 HTTP DELETE 请求。请求 URL 的结构如下：

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

删除副本

删除只读副本的方法与删除独立 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 门户中，选择只读副本。
选择“指标”。在“指标”窗口中，选择“只读副本滞后时间”。
对于“聚合”，请选择“最大”。

El futuro es suyo

Compartir a través de

先决条件

查看主要设置

创建只读副本

创建虚拟终结点

列出虚拟终结点

修改应用程序以指向虚拟终结点

提升副本

测试应用程序

故障回复到原始服务器和区域

测试应用程序

添加次要只读副本

修改虚拟终结点

将副本提升为独立服务器

删除虚拟终结点

删除副本

删除主服务器

监视副本

物理复制最大滞后时间

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

Compartir a través de

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

先决条件

查看主要设置

创建只读副本

创建虚拟终结点

列出虚拟终结点

修改应用程序以指向虚拟终结点

提升副本

测试应用程序

故障回复到原始服务器和区域

测试应用程序

添加次要只读副本

修改虚拟终结点

将副本提升为独立服务器

删除虚拟终结点

删除副本

删除主服务器

监视副本

物理复制最大滞后时间

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

相关内容

Recursos adicionales