你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何使用 PowerShell 来备份和还原 Azure Database for PostgreSQL 服务器

项目
03/30/2023

适用于：Azure Database for PostgreSQL 单一服务器

重要

Azure Database for PostgreSQL - 单一服务器即将停用。强烈建议升级到 Azure Database for PostgreSQL - 灵活服务器。有关迁移到 Azure Database for PostgreSQL - 灵活服务器的详细信息，请参阅 Azure Database for PostgreSQL 单一服务器会发生什么情况？。

Azure Database for PostgreSQL 服务器定期进行备份以便启用还原功能。通过此功能，用户可将服务器及其所有数据库还原到新服务器上的某个较早时间点。

先决条件

若要完成本操作指南，需要：

本地安装 Az PowerShell 模块或浏览器中有 Azure Cloud Shell
Azure Database for PostgreSQL 服务器

重要

尽管 Az.PostgreSql PowerShell 模块为预览版，但必须使用以下命令从 Az PowerShell 模块单独安装它：Install-Module -Name Az.PostgreSql -AllowPrerelease。 Az.PostgreSql PowerShell 模块正式版推出后，它会包含在将来的 Az PowerShell 模块发行版中，并在 Azure Cloud Shell 中原生提供。

如果选择在本地使用 PowerShell，请使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。

Azure Cloud Shell

Azure 托管 Azure Cloud Shell（一个可通过浏览器使用的交互式 shell 环境）。可以将 Bash 或 PowerShell 与 Cloud Shell 配合使用来使用 Azure 服务。可以使用 Cloud Shell 预安装的命令来运行本文中的代码，而不必在本地环境中安装任何内容。

若要启动 Azure Cloud Shell，请执行以下操作：

选项	示例/链接
选择代码或命令块右上角的“试用”。选择“试用”不会自动将代码或命令复制到 Cloud Shell。
转到 https://shell.azure.com 或选择“启动 Cloud Shell”按钮可在浏览器中打开 Cloud Shell。
选择 Azure 门户右上角菜单栏上的 Cloud Shell 按钮。

若要使用 Azure Cloud Shell，请执行以下操作：

启动 Cloud Shell。
选择代码块（或命令块）上的“复制”按钮以复制代码或命令。
在 Windows 和 Linux 上选择 Ctrl+Shift+V，或在 macOS 上选择 Cmd+Shift+V 将代码或命令粘贴到 Cloud Shell 会话中。
选择“Enter”运行代码或命令。

设置备份配置

创建服务器时，可以选择将服务器配置为创建本地冗余备份还是创建异地冗余备份。

注意

创建服务器后，无法在异地冗余或本地冗余之间更改服务器冗余类型。

通过 New-AzPostgreSqlServer 命令创建服务器时，GeoRedundantBackup 参数描述备份冗余选项。如果为“启用”，则创建异地冗余备份。或者如果为“禁用”，则创建本地冗余备份。

备份保留期由参数 BackupRetentionDay 设置。

有关在服务器创建过程中设置这些值的详细信息，请参阅使用 PowerShell 创建 Azure Database for PostgreSQL 服务器。

可以如下所述更改服务器的备份保留期：

Update-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup -BackupRetentionDay 10

前面的示例将 mydemoserver 的备份保留期更改为 10 天。

备份保留期控制可以往回检索多长时间的时间点还原，因为它基于可用备份。下一部分中进一步介绍了时间点还原。

服务器时间点还原

可以将服务器还原到以前的某个时间点。将还原的数据复制到新服务器，现有服务器保持不变。例如，如果意外删除了某个表，可以还原到删除时的时间点。然后可以从服务器的已还原副本中检索缺少的表和数据。

若要还原服务器，请使用 Restore-AzPostgreSqlServer PowerShell cmdlet。

运行还原命令

若要还原服务器，请在 PowerShell 中运行以下示例。

$restorePointInTime = (Get-Date).AddMinutes(-10)
Get-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
  Restore-AzPostgreSqlServer -Name mydemoserver-restored -ResourceGroupName myresourcegroup -RestorePointInTime $restorePointInTime -UsePointInTimeRestore

Restore-AzPostgreSqlServer cmdlet 的 PointInTimeRestore 参数集需要以下参数：

设置	建议值	说明
ResourceGroupName	myresourcegroup	源服务器所在的资源组。
名称	mydemoserver-restored	通过还原命令创建的新服务器的名称。
RestorePointInTime	2020-03-13T13:59:00Z	选择要还原的时间点。此日期和时间必须在源服务器的备份保留期限内。使用 ISO8601 日期和时间格式。例如，可以使用自己的本地时区，如 2020-03-13T05:59:00-08:00。也可以使用 UTC Zulu 格式，如 2018-03-13T13:59:00Z。
UsePointInTimeRestore	`<SwitchParameter>`	使用时间点模式还原。

将服务器还原到以前的某个时间点时，会创建新服务器。原始服务器及其从指定时间点开始创建的数据库会复制到新服务器。

还原的服务器的位置值和定价层值与原始服务器保持相同。

还原过程完成后，找到新服务器，验证数据是否已按预期还原。新服务器具有相同的服务器管理员登录名和密码，该登录名和密码在开始还原时对现有服务器有效。可以从新服务器的“概述” 页更改密码。

还原期间创建的新服务器没有原始服务器上存在的 VNet 服务终结点。必须单独为新服务器设置这些规则。将从原始服务器还原防火墙规则。

异地还原

如果为服务器配置了异地冗余备份，则可以从该现有服务器的备份创建新服务器。可以在 Azure Database for PostgreSQL 可用的任何区域中创建此新服务器。

若要使用异地冗余备份创建服务器，请使用带有 UseGeoRestore 参数的 Restore-AzPostgreSqlServer 命令。

注意

首次创建服务器时，该服务器可能不会立即可用于异地还原。填充必需的元数据可能需要几个小时。

若要异地还原服务器，请在 PowerShell 中运行以下示例：

Get-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
  Restore-AzPostgreSqlServer -Name mydemoserver-georestored -ResourceGroupName myresourcegroup -Location eastus -Sku GP_Gen5_8 -UseGeoRestore

此示例在美国东部区域创建一个名为 mydemoserver-georestored 且将属于 myresourcegroup 的新服务器。它是第 5 代常规用途服务器，具有 8 个 vCore。该服务器是基于也在资源组 myresourcegroup 中的 mydemoserver 的异地冗余备份创建的。

若要在与现有服务器不同的资源组创建新服务器，请使用 ResourceGroupName 参数指定新资源组的名称，如以下示例所示：

Get-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
  Restore-AzPostgreSqlServer -Name mydemoserver-georestored -ResourceGroupName newresourcegroup -Location eastus -Sku GP_Gen5_8 -UseGeoRestore

Restore-AzPostgreSqlServer cmdlet 的 GeoRestore 参数集需要以下参数：

设置	建议值	说明
ResourceGroupName	myresourcegroup	新服务器属于的资源组的名称。
名称	mydemoserver-georestored	新服务器的名称。
位置	eastus	新服务器的位置。
UseGeoRestore	`<SwitchParameter>`	使用异地模式还原。

通过异地还原创建新服务器时，它将继承与源服务器相同的存储大小和定价层，除非指定 Sku 参数。

在还原期间创建的新服务器没有原始服务器上存在的 VNet 服务终结点。必须单独为新服务器设置这些规则。将从原始服务器还原防火墙规则。

后续步骤

如何使用 PowerShell 生成 Azure Database for PostgreSQL 连接字符串

通过