教程：使用迁移服务从 Azure Database for PostgreSQL - 单一服务器迁移到 Azure Database for PostgreSQL - 灵活服务器

项目
04/19/2024

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

使用 Azure 门户，你可以将 Azure Database for PostgreSQL 单一服务器的实例迁移到 Azure Database for PostgreSQL 灵活服务器。在本教程中，我们将使用 Azure 门户将示例数据库从 Azure Database for PostgreSQL 单一服务器迁移到 PostgreSQL 灵活服务器。

配置你的 Azure Database for PostgreSQL 灵活服务器
配置迁移任务
监视迁移
取消迁移
迁移之后

Portal
CLI

使用 Azure 门户进行迁移。

Offline
联机（预览版）

先决条件（脱机）

在使用 Azure Database for PostgreSQL 中的迁移服务开始迁移之前，必须满足适用于脱机迁移方案的以下先决条件。

验证源版本

源 PostgreSQL 版本应该为 >= 9.5。如果源 PostgreSQL 版本低于 9.5，请在迁移之前将源 PostgreSQL 版本升级到 9.5 或更高版本。

目标设置

迁移之前，必须在 Azure 中设置 Azure Database for PostgreSQL。
为 Azure Database for PostgreSQL 选择的 SKU 应与源数据库的规范相对应，以确保兼容性和足够的性能。
有关创建新 Azure Database for PostgreSQL 的详细说明，请参阅以下链接：快速入门：创建服务器。

网络设置

正确的网络设置对于确保迁移期间源和目标之间的成功连接至关重要。以下指南可帮助你为不同的方案建立网络连接：

迁移的网络要求：

ExpressRoute/IPsec VPN/VPN 隧道：将本地/AWS 源连接到 Azure 时，可能需要设置 ExpressRoute、IPsec VPN 或 VPN 隧道，以促进安全的数据传输。
VNET 对等互连：在两个不同的 VNet 之间建立虚拟网络对等互连，以实现直接网络连接，这是在 Azure VM 与 Azure Database for PostgreSQL 之间进行迁移的先决条件。

连接方案：

下表可以帮助设置源和目标之间的网络。

Source	目标	连接提示
公用	公用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
专用	公用	不支持此配置；请使用 pg_dump/pg_restore 进行数据传输。
公用	专用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
Private	Private	在源与目标之间建立 ExpressRoute、IPsec VPN、VPN 隧道或虚拟网络对等互连。
Private	专用终结点	不支持此配置，请联系 Azure 支持。

其他网络注意事项：

pg_hba.conf 配置：为了促进源与目标 PostgreSQL 实例之间的连接，必须验证并可能需要修改 pg_hba.conf 文件。此文件包括客户端身份验证，必须配置为允许目标 PostgreSQL 连接到源。对 pg_hba.conf 文件的更改通常需要重启源 PostgreSQL 实例才能生效。

注意

pg_hba.conf 文件位于 PostgreSQL 安装的数据目录中。如果源数据库是本地 PostgreSQL 服务器或 Azure VM 上托管的 PostgreSQL 服务器，则应检查并配置此文件。对于 AWS RDS 或类似托管服务上的 PostgreSQL 实例，pg_hba.conf 文件不可直接访问或适用，而是会通过服务提供的安全性和网络访问配置来控制访问。

有关网络设置的详细信息，请访问 Azure Database for PostgreSQL 灵活服务器中的迁移服务网络指南。

扩展

扩展是可以添加到 PostgreSQL 以增强其功能的额外功能。 Azure Database for PostgreSQL 支持扩展，但必须手动启用扩展。若要启用扩展，请执行以下步骤：

在源中使用 select 命令列出所有正在使用的扩展 - select extname,extversion from pg_extension;
在 Azure Database for PostgreSQL 的“服务器参数”页面上搜索 azure.extensions 服务器参数。启用在 PostgreSQL 内的源中找到的扩展。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。
检查列表中是否包含以下任一扩展：
- PG_CRON
- PG_HINT_PLAN
- PG_PARTMAN_BGW
- PG_PREWARM
- PG_STAT_STATEMENTS
- PG_AUDIT
- PGLOGICAL
- WAL2JSON

如果是，请在服务器参数页面中搜索 shared_preload_libraries 参数。此参数指示在服务器重启时预加载的扩展库集。

服务器参数

这些参数不会自动迁移到目标环境，必须手动进行配置。

通过访问 Microsoft Azure 门户中的“服务器参数”部分并相应地手动更新相关值，将源 PostgreSQL 数据库中的服务器参数值与 Azure Database for PostgreSQL 相匹配。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。

在目标中禁用高可用性（可靠性）和只读副本

在目标环境中禁用高可用性（可靠性）和只读副本至关重要。只有在迁移完成后才能启用这些功能。
遵循这些准则有助于避免因 HA 和只读副本而引入更多变量，确保迁移过程顺利进行。迁移完成并且数据库稳定后，可以继续启用这些功能，以提高 Azure 中数据库环境的可用性和可伸缩性。

配置你的 Azure Database for PostgreSQL 灵活服务器

创建目标灵活服务器。有关引导式步骤，请参阅快速入门使用门户创建 Azure Database for PostgreSQL 灵活服务器。
允许列表扩展，其库必须在服务器启动时加载。在启动迁移之前，扩展必须位于允许列表上。
检查数据库的表之间的数据分布是否存在倾斜，大部分数据是否存在于单个（或少数）表中。如果发生倾斜，迁移速度可能会比预期要慢。在这种情况下，可以通过并行迁移大型表来提高迁移速度。

配置迁移任务

该迁移服务在 Microsoft Azure 门户中提供了一种基于向导的简单体验。下面介绍如何开始：

打开 Web 浏览器并转到门户。如果要登录，请输入凭据。默认视图是服务仪表板。
转到你的 Azure Database for PostgreSQL 灵活服务器目标。
在灵活服务器的“概述”选项卡上的左侧菜单中，向下滚动到“迁移”并将其选中。
选择“创建”按钮，以开始从单一服务器迁移到灵活服务器。第一次使用迁移服务时，将会显示一个空网格，并提示你开始第一次迁移。

如果已经创建向灵活服务器目标的迁移，则网格会包含有关已尝试从单一服务器迁移到此目标的相关信息。
选择“从单一服务器迁移”按钮。你通过一系列基于向导的选项卡来创建从任何源单一服务器到此灵活服务器目标的迁移。

或者，也可以从 Azure Database for PostgreSQL 单一服务器启动迁移过程。

打开 Web 浏览器并转到门户。如果要登录，必须输入凭据。默认视图是服务仪表板。
选择单一服务器后，可以在“概述”选项卡中看到与迁移相关的横幅。选择“立即迁移”以开始。
你转到包含两个选项的页面。如果已创建灵活服务器，并且要将其用作目标，请选择“选择现有”，然后选择相应的“订阅”、“资源组”和“服务器名称”详细信息。完成后，选择“转到迁移向导”，跳到此页面的“设置选项卡”部分下的说明。
如果选择创建新的灵活服务器，请选择“新建”，然后单击“转到创建向导”。此操作引导你完成灵活服务器的创建过程并部署灵活服务器。

部署灵活服务器后，请按照配置迁移任务中的步骤 3 到 5 进行操作。

“设置”选项卡

第一个选项卡是“设置”。如果错过了这一步，则将必需的扩展加入允许列表，如请务必在启动迁移前将这些扩展加入允许列表中所示。

“迁移名称”是每个到此灵活服务器目标的迁移的唯一标识符。此字段仅接受字母数字字符，不接受除连字符 (-) 之外的任何特殊字符。名称不能以连字符开头，并且对于目标服务器应是唯一的。到同一灵活服务器目标的两个迁移不能同名。

“源服务器类型”指示源。在本例中，它是 Azure Database for PostgreSQL 单一服务器

借助迁移选项，可以在在触发迁移之前执行验证。可以选择以下任一选项。

验证 - 检查服务器和数据库就绪情况，以便迁移到目标。
迁移 - 跳过验证并开始迁移。
验证并迁移 - 在触发迁移之前执行验证。仅当未发生验证失败时，才会触发迁移。

在运行迁移之前，选择“验证”或“验证并迁移”选项来执行迁移前验证始终是一种良好做法。

如果选择“联机”迁移预览，则必须在源单一服务器中启用逻辑复制。如果未启用，迁移服务会自动在源单一服务器上启用逻辑复制。还可以通过将 Azure 复制支持级别设置为“逻辑”，在单一服务器端窗格中的“复制”选项卡下手动设置复制。这两种方法都将重启源单一服务器。

选择“下一步: 连接到源”按钮。

“源”选项卡

“源”选项卡会提示你提供与作为数据库源的单一服务器相关的详细信息。

完成“订阅”和“资源组”的选择后，服务器名称下拉列表将显示不同区域中该资源组下的单一服务器。选择要从中迁移数据库的源。

选择单一服务器源后，“位置”、“PostgreSQL 版本”和“服务器管理员登录名”框会自动填充。服务器管理员登录名是用于创建单一服务器的管理员用户名。在“密码”框中，输入该管理员登录名的密码。迁移服务将单一服务器数据库作为管理员用户进行迁移。

填写所有字段后，选择“连接到源”链接。这将验证输入的源服务器详细信息是否正确，以及源服务器是否可访问。

选择“下一步: 选择迁移目标”按钮继续。

“目标”选项卡

“目标”选项卡显示灵活服务器目标的元数据，例如订阅名称、资源组、服务器名称、位置和 PostgreSQL 版本。

对于“服务器管理员登录名”，该选项卡会显示创建灵活服务器目标期间使用的管理员用户名。输入管理员用户的相应密码。填写密码后，选择“连接到目标”链接。这将验证输入的目标服务器详细信息是否正确以及目标服务器是否可访问。

选择“下一步”按钮，以选择要迁移的数据库。

为“迁移”选项卡选择“数据库”

在此选项卡下，有一个列表显示单一服务器中的用户数据库。可以在一次迁移尝试中选择和迁移最多 8 个数据库。如果用户数据库超过 8 个，则会在源服务器和目标服务器之间针对下一组数据库重复迁移过程。默认情况下，目标上具有相同名称的选定数据库将被覆盖。

选择“下一步”按钮以查看详细信息。

总结

“摘要”选项卡汇总了用于创建验证或迁移的所有详细信息。查看详细信息，然后选择“开始”按钮。

监视迁移门户

选择“开始”按钮后，会在几秒钟内显示一条通知，指出验证或迁移创建已成功。系统会将你自动重定向到灵活服务器的“迁移”页面。这是最近创建的验证或迁移的新条目。

显示迁移的网格包含以下列：“名称”、“状态”、“迁移类型”、“迁移模式”、“源服务器”、“源服务器类型”、“数据库”、“开始时间”和“持续时间”。条目按开始时间的降序显示，最近的条目位于顶部。

可以使用“刷新”按钮刷新验证或迁移的状态。还可以在网格中选择迁移名称以查看关联的详细信息。

创建验证或迁移后，它会进入“InProgress”状态和“PerformingPreRequisiteSteps”子状态。该工作流需要 2-3 分钟来设置迁移基础结构和网络连接。

我们来看一看如何监视每个迁移选项的迁移。

验证

PerformingPreRequisiteSteps 子状态完成后，验证将进入“正在进行验证”子状态，在此状态下，将对源和目标服务器进行检查以评估迁移就绪状态。

如果所有验证都处于“成功”或“警告”状态，则验证将进入“成功”状态。

验证网格包含

“实例的验证详细信息”和“数据库的验证详细信息”部分，表示用于检查迁移就绪情况的验证规则。
验证状态 - 表示每个规则的结果，可以是三个值中的任意一个
- 成功 - 如果未发现错误。
- 失败 - 如果存在验证错误。
- 警告 - 如果存在验证警告。
持续时间 - 验证操作所使用的时间。
开始和结束时间 - 验证操作的开始时间和结束时间（UTC 时间）。

如果验证中出现任何错误，“验证状态”将进入“失败”状态。选择已失败验证的“验证名称”或“数据库名称”，扇出窗格提供了详细信息以及为避免此错误而应采取的纠正措施。

Migrate

完成“PerformingPreRequisiteSteps”子状态后，迁移将转到“正在迁移数据”子状态，此时会执行数据库的克隆/转储。迁移完成时间取决于要迁移的数据库大小和形状。如果数据大部分均匀分布在所有表中，则迁移速度会很快。不均衡的表大小需要相对较长的时间。

选择正在迁移的任何数据库时，将显示扇出窗格。除数据库迁移状态外，它还包含所有表计数 - 已复制、已排队、正在复制和错误。

“正在迁移数据”状态成功完成后，迁移将会进入“成功”状态。如果 Migrating Data 状态出现问题，迁移将进入 Failed 状态。

迁移进入“成功”状态后，将会完成架构和数据从单一服务器到灵活服务器目标的迁移。可以使用页面上的刷新按钮来确认这一点。

验证和迁移

如果使用此选项，将先执行验证，然后再执行迁移。完成“PerformingPreRequisiteSteps”子状态后，工作流将进入“正在进行验证”子状态。

如果验证出现错误，迁移将进入“失败”状态。
如果验证完成且未出现任何错误，迁移会开始，并且工作流将进入“Migrating Data”子状态。

操作完成后，可以看到“验证和迁移”的结果。

先决条件（联机）

在使用 Azure Database for PostgreSQL 中的迁移服务开始迁移之前，必须满足适用于脱机迁移方案的以下先决条件。

验证源版本

源 PostgreSQL 版本应该为 >= 9.5。如果源 PostgreSQL 版本低于 9.5，请在迁移之前将源 PostgreSQL 版本升级到 9.5 或更高版本。

目标设置

迁移之前，必须在 Azure 中设置 Azure Database for PostgreSQL。
为 Azure Database for PostgreSQL 选择的 SKU 应与源数据库的规范相对应，以确保兼容性和足够的性能。
有关创建新 Azure Database for PostgreSQL 的详细说明，请参阅以下链接：快速入门：创建服务器。

设置联机迁移参数

对于联机迁移，应在源 PostgreSQL 服务器的“复制设置”下将复制支持设置为“逻辑”。此外，服务器参数 max_wal_senders 和 max_replication_slots 值应等于需要迁移的数据库数。也可以使用以下命令在命令行中配置它们：

ALTER SYSTEM SET wal_level = logical;
ALTER SYSTEM SET max_wal_senders = number of databases to migrate;
ALTER SYSTEM SET max_replication_slots = number of databases to migrate;

完成所有联机迁移先决条件后，需要重启源 PostgreSQL 服务器。

注意

要使用 Azure Database for PostgreSQL 单一服务器进行联机迁移，可在 Azure 门户中单一服务器页的“复制设置”下将 Azure 复制支持设置为“逻辑”。

网络设置

正确的网络设置对于确保迁移期间源和目标之间的成功连接至关重要。以下指南可帮助你为不同的方案建立网络连接：

迁移的网络要求：

ExpressRoute/IPsec VPN/VPN 隧道：将本地/AWS 源连接到 Azure 时，可能需要设置 ExpressRoute、IPsec VPN 或 VPN 隧道，以促进安全的数据传输。
VNET 对等互连：在两个不同的 VNet 之间建立虚拟网络对等互连，以实现直接网络连接，这是在 Azure VM 与 Azure Database for PostgreSQL 之间进行迁移的先决条件。

连接方案：

下表可以帮助设置源和目标之间的网络。

Source	目标	连接提示
公用	公用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
专用	公用	不支持此配置；请使用 pg_dump/pg_restore 进行数据传输。
公用	专用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
Private	Private	在源与目标之间建立 ExpressRoute、IPsec VPN、VPN 隧道或虚拟网络对等互连。
Private	专用终结点	不支持此配置，请联系 Azure 支持。

其他网络注意事项：

pg_hba.conf 配置：为了促进源与目标 PostgreSQL 实例之间的连接，必须验证 pg_hba.conf 文件并对其进行可能的修改。此文件包括客户端身份验证，必须配置为允许目标 PostgreSQL 连接到源。对 pg_hba.conf 文件的更改通常需要重启源 PostgreSQL 实例才能生效。

注意

有关网络设置的详细信息，请访问 Azure Database for PostgreSQL 灵活服务器中的迁移服务网络指南。

扩展

扩展是可以添加到 PostgreSQL 以增强其功能的额外功能。 Azure Database for PostgreSQL 支持扩展，但必须手动启用扩展。若要启用扩展，请执行以下步骤：

在源中使用 select 命令列出所有正在使用的扩展 - select extname,extversion from pg_extension;
在 Azure Database for PostgreSQL 的“服务器参数”页面上搜索 azure.extensions 服务器参数。启用在 PostgreSQL 内的源中找到的扩展。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。
检查列表中是否包含以下任一扩展：
- PG_CRON
- PG_HINT_PLAN
- PG_PARTMAN_BGW
- PG_PREWARM
- PG_STAT_STATEMENTS
- PG_AUDIT
- PGLOGICAL
- WAL2JSON

如果是，请在服务器参数页面中搜索 shared_preload_libraries 参数。此参数指示在服务器重启时预加载的扩展库集。

服务器参数

这些参数不会自动迁移到目标环境，必须手动进行配置。

通过访问 Microsoft Azure 门户中的“服务器参数”部分并相应地手动更新相关值，将源 PostgreSQL 数据库中的服务器参数值与 Azure Database for PostgreSQL 相匹配。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。

在目标中禁用高可用性（可靠性）和只读副本

在目标环境中禁用高可用性（可靠性）和只读副本至关重要。只有在迁移完成后才能启用这些功能。
遵循这些准则有助于避免因 HA 和只读副本而引入更多变量，确保迁移过程顺利进行。迁移完成并且数据库稳定后，可以继续启用这些功能，以提高 Azure 中数据库环境的可用性和可伸缩性。

配置你的 Azure Database for PostgreSQL 灵活服务器

创建目标灵活服务器。有关引导式步骤，请参阅快速入门使用门户创建 Azure Database for PostgreSQL 灵活服务器。
允许列表扩展，其库必须在服务器启动时加载。在启动迁移之前，扩展必须位于允许列表上。
检查数据库的表之间的数据分布是否存在倾斜，大部分数据是否存在于单个（或少数）表中。如果发生倾斜，迁移速度可能会比预期要慢。在这种情况下，可以通过并行迁移大型表来提高迁移速度。

配置迁移任务

该迁移服务在 Microsoft Azure 门户中提供了一种基于向导的简单体验。下面介绍如何开始：

打开 Web 浏览器并转到门户。如果要登录，请输入凭据。默认视图是服务仪表板。
转到你的 Azure Database for PostgreSQL 灵活服务器目标。
在灵活服务器的“概述”选项卡上的左侧菜单中，向下滚动到“迁移”并将其选中。
选择“创建”按钮，以开始从单一服务器迁移到灵活服务器。第一次使用迁移服务时，将会显示一个空网格，并提示你开始第一次迁移。

如果已经创建向灵活服务器目标的迁移，则网格会包含有关已尝试从单一服务器迁移到此目标的相关信息。
选择“从单一服务器迁移”按钮。你通过一系列基于向导的选项卡来创建从任何源单一服务器到此灵活服务器目标的迁移。

或者，也可以从 Azure Database for PostgreSQL 单一服务器启动迁移过程。

打开 Web 浏览器并转到门户。如果要登录，必须输入凭据。默认视图是服务仪表板。
选择单一服务器后，可以在“概述”选项卡中看到与迁移相关的横幅。选择“立即迁移”以开始。
你转到包含两个选项的页面。如果已创建灵活服务器，并且要将其用作目标，请选择“选择现有”，然后选择相应的“订阅”、“资源组”和“服务器名称”详细信息。完成后，选择“转到迁移向导”，跳到此页面的“设置选项卡”部分下的说明。
如果选择创建新的灵活服务器，请选择“新建”，然后单击“转到创建向导”。此操作引导你完成灵活服务器的创建过程并部署灵活服务器。

部署灵活服务器后，请按照配置迁移任务中的步骤 3 到 5 进行操作。

“设置”选项卡

第一个选项卡是“设置”。如果错过了这一步，则将必需的扩展加入允许列表，如请务必在启动迁移前将这些扩展加入允许列表中所示。

“源服务器类型”指示源。在本例中，它是 Azure Database for PostgreSQL 单一服务器

借助迁移选项，可以在在触发迁移之前执行验证。可以选择以下任一选项。

验证 - 检查服务器和数据库就绪情况，以便迁移到目标。
迁移 - 跳过验证并开始迁移。
验证并迁移 - 在触发迁移之前执行验证。仅当未发生验证失败时，才会触发迁移。

在运行迁移之前，选择“验证”或“验证并迁移”选项来执行迁移前验证始终是一种良好做法。

选择“下一步: 连接到源”按钮。

“源”选项卡

“源”选项卡会提示你提供与作为数据库源的单一服务器相关的详细信息。

完成“订阅”和“资源组”的选择后，服务器名称下拉列表将显示不同区域中该资源组下的单一服务器。选择要从中迁移数据库的源。

填写所有字段后，选择“连接到源”链接。这将验证输入的源服务器详细信息是否正确，以及源服务器是否可访问。

选择“下一步: 选择迁移目标”按钮继续。

“目标”选项卡

“目标”选项卡显示灵活服务器目标的元数据，例如订阅名称、资源组、服务器名称、位置和 PostgreSQL 版本。

选择“下一步”按钮，以选择要迁移的数据库。

为“迁移”选项卡选择“数据库”

选择“下一步”按钮以查看详细信息。

总结

“摘要”选项卡汇总了用于创建验证或迁移的所有详细信息。查看详细信息，然后选择“开始”按钮。

使用 Azure 门户监视迁移

可以使用“刷新”按钮刷新验证或迁移的状态。还可以在网格中选择迁移名称以查看关联的详细信息。

创建验证或迁移后，它会进入“InProgress”状态和“PerformingPreRequisiteSteps”子状态。该工作流需要 2-3 分钟来设置迁移基础结构和网络连接。

我们来看一看如何监视每个迁移选项的迁移。

验证

PerformingPreRequisiteSteps 子状态完成后，验证将进入“正在进行验证”子状态，在此状态下，将对源和目标服务器进行检查以评估迁移就绪状态。

如果所有验证都处于“成功”或“警告”状态，则验证将进入“成功”状态。

验证网格包含

“实例的验证详细信息”和“数据库的验证详细信息”部分，表示用于检查迁移就绪情况的验证规则。
验证状态 - 表示每个规则的结果，可以是三个值中的任意一个
- 成功 - 如果未发现错误。
- 失败 - 如果存在验证错误。
- 警告 - 如果存在验证警告。
持续时间 - 验证操作所使用的时间。
开始和结束时间 - 验证操作的开始时间和结束时间（UTC 时间）。

Migrate

选择正在迁移的任何数据库时，将显示扇出窗格。除数据库迁移状态外，它还包含所有表计数 - 已复制、已排队、正在复制和错误。

“正在迁移数据”状态成功完成后，迁移将会进入“成功”状态。如果 Migrating Data 状态出现问题，迁移将进入 Failed 状态。

迁移进入“成功”状态后，将会完成架构和数据从单一服务器到灵活服务器目标的迁移。可以使用页面上的刷新按钮来确认这一点。

验证和迁移

如果使用此选项，将先执行验证，然后再执行迁移。完成“PerformingPreRequisiteSteps”子状态后，工作流将进入“正在进行验证”子状态。

如果验证出现错误，迁移将进入“失败”状态。
如果验证完成且未出现任何错误，迁移会开始，并且工作流将进入“Migrating Data”子状态。

操作完成后，可以看到“验证和迁移”的结果。

直接转换迁移

如果同时存在“迁移”和“验证并迁移”，则完成联机迁移需要额外执行一个步骤，即需要用户执行直接转换操作。完成基本数据的复制/克隆后，迁移会进入 WaitingForUserAction 状态和 WaitingForCutoverTrigger 子状态。在此状态下，用户可选择迁移，在门户中触发直接转换。

在启动直接转换之前，必须确保：

停止对源的写入 -Latency (minutes) 参数为 0 或接近 0。可以从迁移详细信息屏幕中获取 Latency (minutes) 信息，如下所示：

Latency (minutes) 参数指示目标上次与源同步的时间。例如，对于上述订单数据库，它为 0.33333。这意味着，对于订单数据库，源中最近大约 0.3 分钟内发生的更改尚未同步到目标。此时，可以停止写入源并启动直接转换。如果源中存在大量流量，建议先停止写入，以便 Latency (minutes) 可以接近 0，然后启动直接转换。直接转换操作会将源中所有挂起的更改应用到目标，并完成迁移。如果触发“直接转换”，即使是非零延迟，复制也将停止，直到该时间点。然后会在目标上应用直接转换点之前源中的所有数据。假设直接转换点处的延迟为 15 分钟，则会向目标应用过去 15 分钟内的所有更改数据。所需时间则取决于过去 15 分钟内发生的更改积压工作。因此，建议在触发直接转换之前，延迟达到 0 或接近 0。

一旦进入 Migrating Data 子状态或直接转换（联机迁移中）成功完成，迁移就会进入 Succeeded 状态。如果 Migrating Data 子状态出现问题，迁移将进入 Failed 状态。

可能的迁移状态包括：

进行中：正在设置迁移基础结构，或者正在进行实际数据迁移。
已取消：迁移已被取消或删除。
Failed：迁移失败。
验证失败：验证失败。
Succeeded：迁移成功并已完成。

可能的迁移子状态包括：

PerformingPreRequisiteSteps：正在设置基础结构以进行数据迁移。
正在进行验证：验证正在进行。
正在迁移数据：数据迁移正在进行中。
正在完成迁移：迁移处于完成的最后阶段。
已完成：迁移已成功完成。

使用门户取消迁移

可以取消任何正在进行的验证或迁移。工作流必须处于 InProgress 状态才能取消。无法取消处于“成功”或“失败”状态的验证或迁移。

取消验证会停止任何进一步的验证活动，并且验证会进入“已取消”状态。取消迁移会停止目标服务器上的进一步迁移活动，并进入“已取消”状态。此操作不会删除或回滚目标服务器上的任何更改。请确保删除取消迁移所涉及的目标服务器上的数据库。

可以使用 Azure CLI 进行迁移。

Offline
联机（预览版）

先决条件（脱机）

在使用 Azure Database for PostgreSQL 中的迁移服务开始迁移之前，必须满足适用于脱机迁移方案的以下先决条件。

验证源版本

源 PostgreSQL 版本应该为 >= 9.5。如果源 PostgreSQL 版本低于 9.5，请在迁移之前将源 PostgreSQL 版本升级到 9.5 或更高版本。

目标设置

迁移之前，必须在 Azure 中设置 Azure Database for PostgreSQL。
为 Azure Database for PostgreSQL 选择的 SKU 应与源数据库的规范相对应，以确保兼容性和足够的性能。
有关创建新 Azure Database for PostgreSQL 的详细说明，请参阅以下链接：快速入门：创建服务器。

网络设置

正确的网络设置对于确保迁移期间源和目标之间的成功连接至关重要。以下指南可帮助你为不同的方案建立网络连接：

迁移的网络要求：

ExpressRoute/IPsec VPN/VPN 隧道：将本地/AWS 源连接到 Azure 时，可能需要设置 ExpressRoute、IPsec VPN 或 VPN 隧道，以促进安全的数据传输。
VNET 对等互连：在两个不同的 VNet 之间建立虚拟网络对等互连，以实现直接网络连接，这是在 Azure VM 与 Azure Database for PostgreSQL 之间进行迁移的先决条件。

连接方案：

下表可以帮助设置源和目标之间的网络。

Source	目标	连接提示
公用	公用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
专用	公用	不支持此配置；请使用 pg_dump/pg_restore 进行数据传输。
公用	专用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
Private	Private	在源与目标之间建立 ExpressRoute、IPsec VPN、VPN 隧道或虚拟网络对等互连。
Private	专用终结点	不支持此配置，请联系 Azure 支持。

其他网络注意事项：

pg_hba.conf 配置：为了促进源与目标 PostgreSQL 实例之间的连接，必须验证并可能需要修改 pg_hba.conf 文件。此文件包括客户端身份验证，必须配置为允许目标 PostgreSQL 连接到源。对 pg_hba.conf 文件的更改通常需要重启源 PostgreSQL 实例才能生效。

注意

有关网络设置的详细信息，请访问 Azure Database for PostgreSQL 灵活服务器中的迁移服务网络指南。

扩展

扩展是可以添加到 PostgreSQL 以增强其功能的额外功能。 Azure Database for PostgreSQL 支持扩展，但必须手动启用扩展。若要启用扩展，请执行以下步骤：

在源中使用 select 命令列出所有正在使用的扩展 - select extname,extversion from pg_extension;
在 Azure Database for PostgreSQL 的“服务器参数”页面上搜索 azure.extensions 服务器参数。启用在 PostgreSQL 内的源中找到的扩展。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。
检查列表中是否包含以下任一扩展：
- PG_CRON
- PG_HINT_PLAN
- PG_PARTMAN_BGW
- PG_PREWARM
- PG_STAT_STATEMENTS
- PG_AUDIT
- PGLOGICAL
- WAL2JSON

如果是，请在服务器参数页面中搜索 shared_preload_libraries 参数。此参数指示在服务器重启时预加载的扩展库集。

服务器参数

这些参数不会自动迁移到目标环境，必须手动进行配置。

通过访问 Microsoft Azure 门户中的“服务器参数”部分并相应地手动更新相关值，将源 PostgreSQL 数据库中的服务器参数值与 Azure Database for PostgreSQL 相匹配。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。

在目标中禁用高可用性（可靠性）和只读副本

在目标环境中禁用高可用性（可靠性）和只读副本至关重要。只有在迁移完成后才能启用这些功能。
遵循这些准则有助于避免因 HA 和只读副本而引入更多变量，确保迁移过程顺利进行。迁移完成并且数据库稳定后，可以继续启用这些功能，以提高 Azure 中数据库环境的可用性和可伸缩性。

开始使用

如果你不熟悉 Azure，请创建一个帐户来评估产品/服务。
从 Azure CLI 安装页安装适用于你的操作系统的最新 Azure CLI。

如果已安装 Azure CLI，请使用 az version 命令检查版本。要使用迁移 CLI 命令，版本应为 2.50.0 或更高版本。如果低于此版本，请更新 Azure CLI 版本。
运行 az login 命令：
```
az login
```
此时会打开一个包含 Azure 登录页的浏览器窗口。请提供你的 Azure 凭据以成功完成身份验证。有关使用 Azure CLI 登录的其他方法，请参阅此文。

迁移 CLI 命令（脱机）

迁移工具随附了易于使用的 CLI 命令，可用于执行迁移相关的任务。所有 CLI 命令都以 az postgres flexible-server migration 开头。在启动迁移之前，请务必将这些扩展加入允许列表。

如需帮助了解与某个命令关联的选项以及正确的语法，可以使用 help 参数：

az postgres flexible-server migration --help

上述命令提供以下输出：

输出列出了支持的迁移命令及其操作。让我们详细了解这些命令。

使用 Azure CLI 创建迁移

create 命令可帮助创建从源服务器到目标服务器的迁移：

az postgres flexible-server migration create -- help

上述命令提供以下结果：

它会列出所需的参数并提供用于成功创建从源服务器到目标服务器的迁移的示例语法。下面是用于创建新迁移的 CLI 命令：

az postgres flexible-server migration create [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]
                                            [--migration-mode]
                                            [--properties]

参数	说明
`subscription`	灵活服务器目标的订阅 ID。
`resource-group`	灵活服务器目标的资源组。
`name`	灵活服务器目标的名称。
`migration-name`	尝试到灵活服务器的迁移的唯一标识符。此字段仅接受字母数字字符，不接受除连字符（`-`）之外的任何特殊字符。该名称不能以 `-` 开头，不能有两个到灵活服务器目标的迁移同名。
`migration-mode`	这是一个可选参数。默认值：脱机。脱机迁移需要在某个时间点将源数据库复制到目标服务器。
`properties`	JSON 文件的绝对路径，其中包含有关单一服务器源的信息。

例如：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

create 命令中使用的 migration-name 参数可用于其他 CLI 命令，例如 update、delete 和 show.。在所有这些命令中，该参数可唯一标识相应操作中的迁移尝试。

最后，create 命令需要将 JSON 文件作为其 properties 参数的一部分传递。

JSON 的结构为：

{
"properties": {
 "sourceDbServerResourceId":"/subscriptions/<subscriptionid>/resourceGroups/<src_ rg_name>/providers/Microsoft.DBforPostgreSQL/servers/<source server name>",
"secretParameters": {
    "adminCredentials":
    {
      "sourceServerPassword": "<password>",
      "targetServerPassword": "<password>"
    },
   "sourceServerUserName": "<username>@<servername>",
   "targetServerUserName": "<username>"
},

"dbsToMigrate":
   [
   "<db1>","<db2>"
   ],

"overwriteDbsInTarget":"true"

}
}

采用 JSON 文件格式的 create 参数如下所示：

参数	类型	描述
`sourceDbServerResourceId`	必需	此参数是单一服务器源的资源 ID，它是必需的。
`adminCredentials`	必需	此参数列出单一服务器和灵活服务器目标的管理员用户的密码。这些密码有助于对源服务器和目标服务器进行身份验证。
`sourceServerUserName`	必须	默认值是在创建单一服务器期间创建的管理员用户，所提供的密码将用于对此用户进行身份验证。如果使用的不是默认用户，则此参数是用于执行迁移的源服务器上的用户或角色。此用户应对迁移中涉及的数据库对象拥有必要的特权和所有权，并且应是 azure_pg_admin 角色的成员。
`targetServerUserName`	必须	默认值是在创建灵活服务器期间创建的管理员用户，所提供的密码将用于对此用户进行身份验证。如果未使用默认用户，则此参数是用于执行迁移的目标服务器上的用户或角色。此用户应是 azure_pg_admin、pg_read_all_settings、pg_read_all_stats、pg_stat_scan_tables 角色的成员，并且应具有创建角色、创建 DB 属性。
`dbsToMigrate`	必须	指定要迁移到灵活服务器的数据库的列表。仅迁移用户数据库。不会迁移系统数据库或模板数据库（如 template0、template1）。
`overwriteDbsInTarget`	必须	如果设置为 true，且目标服务器的现有数据库恰好与要迁移的数据库同名，则迁移服务会自动覆盖该数据库。
`SetupLogicalReplicationOnSourceDBIfNeeded`	可选	通过将此属性设置为 `true`，可以在源服务器上自动启用逻辑复制。对服务器设置进行的此项更改需要重启服务器，这会导致两到三分钟的故障时间。
`SourceDBServerFullyQualifiedDomainName`	可选	将自定义 DNS 服务器用于虚拟网络的名称解析时使用该参数。根据自定义 DNS 服务器为此属性提供单一服务器的 FQDN。
`TargetDBServerFullyQualifiedDomainName`	可选	将自定义 DNS 服务器用于虚拟网络内部的名称解析时使用该参数。根据自定义 DNS 服务器提供灵活服务器目标的 FQDN。仅当为名称解析使用自定义 DNS 服务器而不是 Azure 提供的 DNS 时（这种情况极少见），才应包含 `SourceDBServerFullyQualifiedDomainName` 和 `TargetDBServerFullyQualifiedDomainName` 作为 JSON 的一部分。否则，请勿在 JSON 文件中包括这些参数。

请注意命令响应的以下要点：

触发 create 命令后，迁移将会进入 InProgress 状态和 PerformingPreRequisiteSteps 子状态。迁移工作流需要几分钟的时间来部署迁移基础结构，并在源和目标之间建立连接。
完成 PerformingPreRequisiteSteps 子状态后，迁移将进入 Migrating Data, 子状态，此时会执行数据库的克隆/复制。
迁移的每个数据库都有自己的部分，其中包含所有迁移详细信息，例如表计数、增量插入、删除和挂起字节数。
完成 Migrating Data 子状态所需的时间取决于所迁移数据库的大小。
一旦 Migrating Data 子状态成功完成，迁移就会进入 Succeeded 状态。如果 Migrating Data 子状态出现问题，迁移将进入 Failed 状态。

设置复制

如果选择“联机”迁移预览，则必须在源单一服务器中启用逻辑复制。如果未启用，则迁移服务会在使用随附 JSON 文件中的值 true 传递 SetupLogicalReplicationOnSourceDBIfNeeded 参数时自动在源单一服务器上启用逻辑复制。启动迁移后，还可以使用以下命令在源上手动设置复制。任何启用逻辑复制的方法都会重启源单一服务器。

例如：

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

当灵活服务器处于等待 WaitingForLogicalReplicationSetupRequestOnSourceDB 状态时，需要运行此命令才能推进迁移。

要在上述任何区域中执行联机迁移，请使用：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode online

列出迁移

list 命令列出对灵活服务器目标进行的所有迁移尝试。

az postgres flexible-server migration list [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--filter]

filter 参数具有两个选项：

Active：列出当前（正在进行的）到目标服务器的活动迁移尝试。它不包括已失败、取消或成功的迁移。
All：列出对目标服务器进行的所有迁移尝试。这包括活动迁移和以往的迁移，不管其状态如何。

若要了解此命令的详细信息，请使用 help 参数：

az postgres flexible-server migration list -- help

监视迁移

show 命令可帮助监视正在进行的迁移，并提供迁移的当前状态和子状态。这些详细信息包括有关迁移的当前状态和子状态的信息。

az postgres flexible-server migration show [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

migration_name 参数是在运行 create 命令期间分配给迁移的名称。下面是用于显示详细信息的 CLI 命令的示例响应快照：

若要了解此命令的详细信息，请使用 help 参数：

 az postgres flexible-server migration show -- help

下表描述了迁移状态和子状态。

迁移状态	说明
`InProgress`	迁移基础结构已设置，或者正在进行实际数据迁移。
`Canceled`	迁移已被取消或删除。
`Failed`	迁移失败。
`Succeeded`	迁移成功并已完成。

迁移子状态	说明
`PerformingPreRequisiteSteps`	基础结构已设置，并且已为数据迁移做好准备。
`MigratingData`	数据迁移正在进行中。
`CompletingMigration`	正在进行迁移切换。
`Completed`	直接转换已成功，迁移完成。

先决条件（联机）

在使用 Azure Database for PostgreSQL 中的迁移服务开始迁移之前，必须满足适用于脱机迁移方案的以下先决条件。

验证源版本

源 PostgreSQL 版本应该为 >= 9.5。如果源 PostgreSQL 版本低于 9.5，请在迁移之前将源 PostgreSQL 版本升级到 9.5 或更高版本。

目标设置

迁移之前，必须在 Azure 中设置 Azure Database for PostgreSQL。
为 Azure Database for PostgreSQL 选择的 SKU 应与源数据库的规范相对应，以确保兼容性和足够的性能。
有关创建新 Azure Database for PostgreSQL 的详细说明，请参阅以下链接：快速入门：创建服务器。

设置联机迁移参数

ALTER SYSTEM SET wal_level = logical;
ALTER SYSTEM SET max_wal_senders = number of databases to migrate;
ALTER SYSTEM SET max_replication_slots = number of databases to migrate;

完成所有联机迁移先决条件后，需要重启源 PostgreSQL 服务器。

注意

要使用 Azure Database for PostgreSQL 单一服务器进行联机迁移，可在 Azure 门户中单一服务器页的“复制设置”下将 Azure 复制支持设置为“逻辑”。

网络设置

正确的网络设置对于确保迁移期间源和目标之间的成功连接至关重要。以下指南可帮助你为不同的方案建立网络连接：

迁移的网络要求：

ExpressRoute/IPsec VPN/VPN 隧道：将本地/AWS 源连接到 Azure 时，可能需要设置 ExpressRoute、IPsec VPN 或 VPN 隧道，以促进安全的数据传输。
VNET 对等互连：在两个不同的 VNet 之间建立虚拟网络对等互连，以实现直接网络连接，这是在 Azure VM 与 Azure Database for PostgreSQL 之间进行迁移的先决条件。

连接方案：

下表可以帮助设置源和目标之间的网络。

Source	目标	连接提示
公用	公用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
专用	公用	不支持此配置；请使用 pg_dump/pg_restore 进行数据传输。
公用	专用	如果源已列入目标防火墙规则的允许列表，则无需执行其他操作。
Private	Private	在源与目标之间建立 ExpressRoute、IPsec VPN、VPN 隧道或虚拟网络对等互连。
Private	专用终结点	不支持此配置，请联系 Azure 支持。

其他网络注意事项：

pg_hba.conf 配置：为了促进源与目标 PostgreSQL 实例之间的连接，必须验证 pg_hba.conf 文件并对其进行可能的修改。此文件包括客户端身份验证，必须配置为允许目标 PostgreSQL 连接到源。对 pg_hba.conf 文件的更改通常需要重启源 PostgreSQL 实例才能生效。

注意

有关网络设置的详细信息，请访问 Azure Database for PostgreSQL 灵活服务器中的迁移服务网络指南。

扩展

扩展是可以添加到 PostgreSQL 以增强其功能的额外功能。 Azure Database for PostgreSQL 支持扩展，但必须手动启用扩展。若要启用扩展，请执行以下步骤：

在源中使用 select 命令列出所有正在使用的扩展 - select extname,extversion from pg_extension;
在 Azure Database for PostgreSQL 的“服务器参数”页面上搜索 azure.extensions 服务器参数。启用在 PostgreSQL 内的源中找到的扩展。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。
检查列表中是否包含以下任一扩展：
- PG_CRON
- PG_HINT_PLAN
- PG_PARTMAN_BGW
- PG_PREWARM
- PG_STAT_STATEMENTS
- PG_AUDIT
- PGLOGICAL
- WAL2JSON

如果是，请在服务器参数页面中搜索 shared_preload_libraries 参数。此参数指示在服务器重启时预加载的扩展库集。

服务器参数

这些参数不会自动迁移到目标环境，必须手动进行配置。

通过访问 Microsoft Azure 门户中的“服务器参数”部分并相应地手动更新相关值，将源 PostgreSQL 数据库中的服务器参数值与 Azure Database for PostgreSQL 相匹配。
保存参数更改并重启 Azure Database for PostgreSQL 以应用新配置（如果需要）。

在目标中禁用高可用性（可靠性）和只读副本

在目标环境中禁用高可用性（可靠性）和只读副本至关重要。只有在迁移完成后才能启用这些功能。
遵循这些准则有助于避免因 HA 和只读副本而引入更多变量，确保迁移过程顺利进行。迁移完成并且数据库稳定后，可以继续启用这些功能，以提高 Azure 中数据库环境的可用性和可伸缩性。

开始使用

如果你不熟悉 Azure，请创建一个帐户来评估产品/服务。
从 Azure CLI 安装页安装适用于你的操作系统的最新 Azure CLI。

如果已安装 Azure CLI，请使用 az version 命令检查版本。要使用迁移 CLI 命令，版本应为 2.50.0 或更高版本。如果低于此版本，请更新 Azure CLI 版本。
运行 az login 命令：
```
az login
```
此时会打开一个包含 Azure 登录页的浏览器窗口。请提供你的 Azure 凭据以成功完成身份验证。有关使用 Azure CLI 登录的其他方法，请参阅此文。

迁移 CLI 命令（联机）

如需帮助了解与某个命令关联的选项以及正确的语法，可以使用 help 参数：

az postgres flexible-server migration --help

上述命令提供以下输出：

输出列出了支持的迁移命令及其操作。让我们详细了解这些命令。

使用 Azure CLI 创建迁移

create 命令可帮助创建从源服务器到目标服务器的迁移：

az postgres flexible-server migration create -- help

上述命令提供以下结果：

它会列出所需的参数并提供用于成功创建从源服务器到目标服务器的迁移的示例语法。下面是用于创建新迁移的 CLI 命令：

az postgres flexible-server migration create [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]
                                            [--migration-mode]
                                            [--properties]

参数	说明
`subscription`	灵活服务器目标的订阅 ID。
`resource-group`	灵活服务器目标的资源组。
`name`	灵活服务器目标的名称。
`migration-name`	尝试到灵活服务器的迁移的唯一标识符。此字段仅接受字母数字字符，不接受除连字符（`-`）之外的任何特殊字符。该名称不能以 `-` 开头，不能有两个到灵活服务器目标的迁移同名。
`migration-mode`	这是一个可选参数。默认值：脱机。脱机迁移需要在某个时间点将源数据库复制到目标服务器。
`properties`	JSON 文件的绝对路径，其中包含有关单一服务器源的信息。

例如：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

最后，create 命令需要将 JSON 文件作为其 properties 参数的一部分传递。

JSON 的结构为：

{
"properties": {
 "sourceDbServerResourceId":"/subscriptions/<subscriptionid>/resourceGroups/<src_ rg_name>/providers/Microsoft.DBforPostgreSQL/servers/<source server name>",
"secretParameters": {
    "adminCredentials":
    {
      "sourceServerPassword": "<password>",
      "targetServerPassword": "<password>"
    },
   "sourceServerUserName": "<username>@<servername>",
   "targetServerUserName": "<username>"
},

"dbsToMigrate":
   [
   "<db1>","<db2>"
   ],

"overwriteDbsInTarget":"true"

}
}

采用 JSON 文件格式的 create 参数如下所示：

参数	类型	描述
`sourceDbServerResourceId`	必需	此参数是单一服务器源的资源 ID，它是必需的。
`adminCredentials`	必需	此参数列出单一服务器和灵活服务器目标的管理员用户的密码。这些密码有助于对源服务器和目标服务器进行身份验证。
`sourceServerUserName`	必须	默认值是在创建单一服务器期间创建的管理员用户，所提供的密码将用于对此用户进行身份验证。如果使用的不是默认用户，则此参数是用于执行迁移的源服务器上的用户或角色。此用户应对迁移中涉及的数据库对象拥有必要的特权和所有权，并且应是 azure_pg_admin 角色的成员。
`targetServerUserName`	必须	默认值是在创建灵活服务器期间创建的管理员用户，所提供的密码将用于对此用户进行身份验证。如果未使用默认用户，则此参数是用于执行迁移的目标服务器上的用户或角色。此用户应是 azure_pg_admin、pg_read_all_settings、pg_read_all_stats、pg_stat_scan_tables 角色的成员，并且应具有创建角色、创建 DB 属性。
`dbsToMigrate`	必须	指定要迁移到灵活服务器的数据库的列表。仅迁移用户数据库。不会迁移系统数据库或模板数据库（如 template0、template1）。
`overwriteDbsInTarget`	必须	如果设置为 true，且目标服务器的现有数据库恰好与要迁移的数据库同名，则迁移服务会自动覆盖该数据库。
`SetupLogicalReplicationOnSourceDBIfNeeded`	可选	通过将此属性设置为 `true`，可以在源服务器上自动启用逻辑复制。对服务器设置进行的此项更改需要重启服务器，这会导致两到三分钟的故障时间。
`SourceDBServerFullyQualifiedDomainName`	可选	将自定义 DNS 服务器用于虚拟网络的名称解析时使用该参数。根据自定义 DNS 服务器为此属性提供单一服务器的 FQDN。
`TargetDBServerFullyQualifiedDomainName`	可选	将自定义 DNS 服务器用于虚拟网络内部的名称解析时使用该参数。根据自定义 DNS 服务器提供灵活服务器目标的 FQDN。仅当为名称解析使用自定义 DNS 服务器而不是 Azure 提供的 DNS 时（这种情况极少见），才应包含 `SourceDBServerFullyQualifiedDomainName` 和 `TargetDBServerFullyQualifiedDomainName` 作为 JSON 的一部分。否则，请勿在 JSON 文件中包括这些参数。

请注意命令响应的以下要点：

触发 create 命令后，迁移将会进入 InProgress 状态和 PerformingPreRequisiteSteps 子状态。迁移工作流需要几分钟的时间来部署迁移基础结构，并在源和目标之间建立连接。
完成 PerformingPreRequisiteSteps 子状态后，迁移将进入 Migrating Data, 子状态，此时会执行数据库的克隆/复制。
迁移的每个数据库都有自己的部分，其中包含所有迁移详细信息，例如表计数、增量插入、删除和挂起字节数。
完成 Migrating Data 子状态所需的时间取决于所迁移数据库的大小。
一旦 Migrating Data 子状态成功完成，迁移就会进入 Succeeded 状态。如果 Migrating Data 子状态出现问题，迁移将进入 Failed 状态。

设置复制

例如：

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

当灵活服务器处于等待 WaitingForLogicalReplicationSetupRequestOnSourceDB 状态时，需要运行此命令才能推进迁移。

要在上述任何区域中执行联机迁移，请使用：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode online

列出迁移

list 命令列出对灵活服务器目标进行的所有迁移尝试。

az postgres flexible-server migration list [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--filter]

filter 参数具有两个选项：

Active：列出当前（正在进行的）到目标服务器的活动迁移尝试。它不包括已失败、取消或成功的迁移。
All：列出对目标服务器进行的所有迁移尝试。这包括活动迁移和以往的迁移，不管其状态如何。

若要了解此命令的详细信息，请使用 help 参数：

az postgres flexible-server migration list -- help

监视迁移

show 命令可帮助监视正在进行的迁移，并提供迁移的当前状态和子状态。这些详细信息包括有关迁移的当前状态和子状态的信息。

az postgres flexible-server migration show [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

migration_name 参数是在运行 create 命令期间分配给迁移的名称。下面是用于显示详细信息的 CLI 命令的示例响应快照：

若要了解此命令的详细信息，请使用 help 参数：

 az postgres flexible-server migration show -- help

下表描述了迁移状态和子状态。

迁移状态	说明
`InProgress`	迁移基础结构已设置，或者正在进行实际数据迁移。
`Canceled`	迁移已被取消或删除。
`Failed`	迁移失败。
`Succeeded`	迁移成功并已完成。

迁移子状态	说明
`PerformingPreRequisiteSteps`	基础结构已设置，并且已为数据迁移做好准备。
`MigratingData`	数据迁移正在进行中。
`CompletingMigration`	正在进行迁移切换。
`Completed`	直接转换已成功，迁移完成。

直接转换迁移

在联机迁移中，完成基本数据迁移后，迁移任务将移动到 WaitingForCutoverTrigger 子状态。在此状态下，用户可以使用以下命令通过 CLI 触发直接转换。还可以通过选择迁移网格中的迁移名称从门户触发直接转换。

例如：

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --cutover

在启动直接转换之前，请务必确保：

停止对源的写入 -latency 参数减少到 0 或接近 0

latency 参数指示目标上次与源同步的时间。例如，下面是两个数据库的 201 和 202 值，如下图所示。这意味着尚未将源上最近大约 200 秒内发生的更改同步到目标。此时，可以停止写入源并启动直接转换。如果源中存在大量流量，建议先停止写入，以便 Latency 可以接近 0，然后启动直接转换。直接转换操作会将源中所有挂起的更改应用到目标，并完成迁移。如果触发“直接转换”，则即使 Latency 非零，复制也会在该时间点之前停止。然后会在目标上应用直接转换点之前源中的所有数据。假设直接转换点处的延迟为 15 分钟，则会向目标应用过去 15 分钟内的所有更改数据。所需时间则取决于过去 15 分钟内发生的更改积压工作。因此，建议在触发直接转换之前，延迟应达到零或接近零。可以使用前一显示命令获取 latency 信息。下面是启动直接转换之前迁移的快照：

启动直接转换后，基础复制期间发生的所有事务将会按顺序复制到目标，并完成迁移。

如果直接转换未成功，迁移将会进入 Failed 状态。

若要了解此命令的详细信息，请使用 help 参数：

 az postgres flexible-server migration update -- help

使用 CLI 取消迁移

可以使用 cancel 命令取消任何正在进行的迁移尝试。此命令会停止特定迁移尝试，但不会删除或回滚目标服务器上的任何更改。下面是用于删除迁移的 CLI 命令：

az postgres flexible-server migration update cancel [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

例如：

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1"

若要了解此命令的详细信息，请使用 help 参数：

 az postgres flexible-server migration update cancel -- help

该命令提供以下输出：

迁移之后

完成数据库后，需要人工在源和目标之间验证数据，并确认目标数据库中的所有对象都已成功创建。

迁移后，可以执行以下任务：

验证灵活服务器上的数据，并确保它是源实例的确切副本。
验证后，根据需要在灵活服务器上启用高可用性选项。
根据应用程序的需求更改灵活服务器的 SKU。需要重启数据库服务器才能使此更改生效。
如果更改了源实例中任何服务器参数的默认值，请将这些服务器参数值复制到灵活服务器中。
将标记、警报和防火墙规则（如果适用）等其他服务器设置从源实例复制到灵活服务器。
更改应用程序以将连接字符串指向灵活服务器。
密切监视数据库性能，以查看是否需要进行性能优化。

教程：使用迁移服务从 Azure Database for PostgreSQL - 单一服务器迁移到 Azure Database for PostgreSQL - 灵活服务器

先决条件（脱机）

验证源版本

目标设置

网络设置

扩展

服务器参数

在目标中禁用高可用性（可靠性）和只读副本

配置你的 Azure Database for PostgreSQL 灵活服务器

配置迁移任务

“设置”选项卡

“源”选项卡

“目标”选项卡

为“迁移”选项卡选择“数据库”

总结

监视迁移门户

验证

Migrate

验证和迁移

使用门户取消迁移

迁移之后

相关内容

其他资源