你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
重要
Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略，在指定日期之前迁移到 Azure Health Data Services FHIR® 服务。 由于 Azure API for FHIR 停用，从 2025 年 4 月 1 日开始，不允许使用新的客户部署。 Azure Health Data Services FHIR 服务 是 Azure API for FHIR 的不断发展版本，客户可以通过集成到其他 Azure 服务来管理 FHIR 和 DICOM 服务。
Azure Health Data Services FHIR® 服务是用于健康数据集成的下一代平台。 它为各种健康数据交换提供托管的企业级 FHIR 和 DICOM 服务。
将 FHIR 数据从 Azure API for FHIR 迁移到 Azure Health Data Services FHIR 服务时，你的组织可享受到更强的性能、可伸缩性、安全性与合规性。 此外，组织还可以访问 Azure API for FHIR 中不提供的新功能。
Azure API for FHIR 将于 2026 年 9 月 30 日停用，因此需要尽快将 FHIR 数据迁移到 Azure Health Data Services FHIR 服务。 为了简化此过程，我们创建了一些工具和提示，帮助评估准备情况、准备数据、迁移应用程序，以及直接转换到新服务。
推荐的方法
若要迁移数据，请执行以下步骤。
- 步骤1：评估准备情况
- 步骤 2：准备进行迁移
- 步骤 3：迁移数据和应用程序工作负载
- 步骤 4：从 Azure API for FHIR 直接转换到 Azure Health Data Services
步骤1：评估准备情况
比较 Azure API for FHIR 与 Azure Health Data Services 之间的差异。 另请查看体系结构并评估是否需要进行任何更改。
| 功能 | Azure API for FHIR | Azure Health Data Services |
|---|---|---|
| 设置 | 随服务停用（2026 年 9 月 30 日）而被弃用： • 本地 RBAC • SMART on FHIR 代理 |
计划弃用： • SMART on FHIR 代理 (2026/9/21) |
| 数据存储卷 | 超过 4 TB | 当前支持为 4 TB。 如果需要超过 4 TB，请提交 Azure 支持请求 |
| 数据输入 | OSS 中提供的工具 |
$import 运算 |
| 自动缩放 | 根据要求提供支持，需支付费用 | 默认启用，无需额外付费 |
| 搜索参数 | 支持的捆绑类型：批处理 • 不支持 Include、revinclude、iterate 修饰符 • 支持按名字、姓氏、出生日期和临床日期排序 |
支持的捆绑类型：批处理和事务 • 可选择的搜索参数 • 支持 Include、Revinclude 和 Iterate 修饰符 • 支持按字符串和日期/时间字段排序 |
| 事件 | 不支持 | 支持 |
| 基础结构 | 受支持： • 客户管理的密钥 • 跨区域灾难恢复 (DR) |
受支持： • 时点恢复 (PITR) • 客户管理的密钥 • 可用性区支持 |
重要
如果你的 Azure API for FHIR 实例包含超过 2 TB 的数据，请在开始迁移之前提交Azure 支持请求。 在支持票证中，包括 Azure API for FHIR 实例名称和Azure Health Data Services FHIR 服务实例名称，以便团队可以帮助进行迁移规划。
需要考虑到可能会影响体系结构的事项
同步代理即将弃用。 如果你目前在使用同步代理连接到 Dataverse，请参阅数据集成工具包概述
FHIR 代理即将弃用。 如果你目前在使用 FHIR 代理处理事件，请参阅内置的事件处理功能。 可以使用 Azure Health Data Services 工具包自定义和构建替代方法。
SMART on FHIR 代理即将弃用。 需要使用新的 SMART on FHIR 功能。 详细信息请参阅 SMART on FHIR
Azure Health Data Services FHIR 服务不支持本地 RBAC 和自定义权限。 令牌颁发机构需要是其中正在运行 FHIR 服务的租户的身份验证终结点。
IoT 连接器仅支持通过 Azure FHIR 服务 API 使用。 如果要将 Azure API for FHIR 服务中现有的 IoT 连接器设备 FHIR 数据迁移到 Azure Health Data Services FHIR 服务，请使用迁移工具中的批量导出和导入功能。
步骤 2：准备进行迁移
首先，创建迁移计划。 建议使用下表中所述的迁移模式。 根据组织对停机时间的容忍度，你可能会决定使用某些模式和工具来帮助促进迁移。
| 迁移模式 | 详细信息 | 如何？ |
|---|---|---|
| 直接迁移 | 最简单的模式。 如果数据管道可以承受较长时间的停机，这是理想选择。 | 选择最适合你组织的选项： • 配置工作流以在 Azure API for FHIR 上导出数据，然后将其导入到 Azure Health Data Services FHIR 服务中。 • GitHub 存储库提供了有关运行这些命令的提示，以及帮助自动创建 $import 有效负载的脚本。 • 创建你自己的工具以使用 $export 和 $import 迁移数据。 |
| 增量复制 | 持续版本的直接迁移，但停机时间更少。 理想用于需要较长时间复制的大量数据或在迁移期间希望继续运行 Azure API for FHIR 的情况。 | 选择最适合你的组织的方式。 • 我们创建了 OSS 迁移工具来帮助实现此迁移模式。 • 创建你自己的工具，以增量迁移数据。 |
OSS 迁移工具注意事项
如果决定使用 OSS 迁移工具，请查看并了解该迁移工具的功能和限制。
准备 Azure API for FHIR 服务器
确定要迁移的数据。
利用此机会清理不再使用的数据或 FHIR 服务器。
确定是否要迁移历史版本。
部署新的 Azure Health Data Services FHIR 服务服务器。
首先，部署 Azure Health Data Services 工作区。
然后部署 Azure Health Data Services FHIR 服务服务器。 可在此处找到更多信息：在 Azure Health Data Services 中部署 FHIR 服务。
配置新的 Azure Health Data Services FHIR 服务服务器。 如果需要对新服务器使用与 Azure API for FHIR 相同的配置，请参阅迁移工具文档中建议的检查内容列表。 在迁移之前配置设置。
步骤 3：迁移数据
选择最适合组织的迁移模式。 如果使用 OSS 迁移工具，请按照 GitHub 上的说明操作。
步骤 4：迁移应用程序并重新配置设置
迁移指向旧 FHIR 服务器的应用程序。
更改应用程序上的终结点，使其指向新 FHIR 服务器的 URL。
重新设置这些应用的权限。
迁移后，重新配置新的 Azure Health Data Services FHIR 服务服务器中的其余任何设置。
如果想要仔细检查 Azure Health Data Services FHIR 服务和 Azure API for FHIR 服务器是否具有相同的配置，则可以检查两个元数据终结点，以比较这两个服务器。
为 FHIR 服务器设置以前在旧 Azure API 中运行的任何作业（例如，
$export作业）
步骤 5：直接转换到 Azure Health Data Services FHIR 服务
确信 Azure Health Data Services FHIR 服务服务器稳定后，可以开始使用 Azure Health Data Services FHIR 服务来满足业务方案。 关闭在 Azure API for FHIR 上运行的任何剩余管道。 如有必要，从迁移工具中使用的中间存储帐户中删除数据。 从 Azure API for FHIR 服务器中删除数据，并停用 Azure API for FHIR 帐户。
注意
FHIR® 是 HL7 的注册商标，经 HL7 许可使用。