你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
FHIR 服务入门
本文概述了在 Azure Health Data Services 中 开始使用 FHIR 服务的基本步骤。
作为先决条件,需要一个 Azure 订阅,并已获得适当的权限来创建 Azure 资源组并部署 Azure 资源。 可以执行所有步骤,或者如果已有环境,可以跳过某些步骤。 此外,可以组合所有步骤并在 PowerShell、Azure CLI 和 REST API 脚本中完成这些步骤。
在 Azure 订阅中创建工作区
可以从Azure 门户或使用 PowerShell、Azure CLI 和 REST API 创建工作区。 可以从 Azure Health Data Services 示例中找到脚本。
注意
可以在每个 Azure 订阅中创建的工作区数和 FHIR 服务实例数有限制。
在工作区中创建 FHIR 服务
可以从Azure 门户或使用 PowerShell、Azure CLI 和 REST API 创建 FHIR 服务实例。 可以从 Azure Health Data Services 示例中找到脚本。
(可选)可以在工作区中创建 DICOM 服务和MedTech 服务 。
访问 FHIR 服务
FHIR 服务受无法禁用的 Microsoft Entra ID 保护。 若要访问服务 API,必须创建一个客户端应用程序,该应用程序也称为 Microsoft Entra ID 中的服务主体,并向其授予适当的权限。
注册客户端应用程序
可以从Azure 门户或使用 PowerShell 和 Azure CLI 脚本创建或注册客户端应用程序。 此客户端应用程序可用于一个或多个 FHIR 服务实例。 它还可用于 Azure Health Data Services 中的其他服务。
如果客户端应用程序是使用证书或客户端密码创建的,请确保在过期之前续订证书或客户端密码,并替换应用程序中的客户端凭据。
可以删除客户端应用程序。 在删除客户端应用程序之前,请确保它不在生产、开发、测试或质量保证(QA)环境中使用。
授予访问权限
可以从Azure 门户或使用 PowerShell 和 Azure CLI 脚本授予访问权限或分配角色。
执行创建、读取、更新和删除 (CRUD) 事务
可以对应用程序中的 FHIR 服务执行创建、读取(搜索)、更新和删除(CRUD)事务或使用 Postman、REST 客户端和 cURL 等工具。 由于 FHIR 服务默认受到保护,因此必须获取访问令牌并将其包含在事务请求中。
获取访问令牌
可以使用 PowerShell、Azure CLI、REST CCI 或 .NET SDK 获取 Microsoft Entra 访问令牌。 有关详细信息,请参阅 “获取访问令牌”。
使用现有工具进行访问
加载数据
可以直接使用 POST 或 PUT 方法对 FHIR 服务加载数据。 若要批量加载数据,可以使用下面列出的开源工具之一。
- FHIR 加载程序 这是一个 .NET 控制台应用,并将存储在 Azure 存储中的数据加载到 FHIR 服务。 它是单个线程应用,但可以在本地或 Docker 容器中运行多个副本。
- FHIR 大容量加载程序 此工具是一个 Azure 函数应用(微服务),在并行线程中运行。
- 批量导入 此工具仅适用于开源 FHIR 服务器。 但是,它将来将可用于 Azure Health Data Services。
CMS、搜索、配置文件验证和重新编制索引
可以在 FHIR 服务文档中找到有关互操作性和患者访问、搜索、配置文件验证和重新编制索引的更多详细信息。
导出数据
(可选)可以将($export)数据导出到Azure 存储并在分析或机器学习项目中使用它。 可以按格式导出数据“原样”或 de-idndjson
。
还可以使用开源项目将数据导出到 Synapse 。 将来,此功能将集成到托管服务。
转换数据
(可选)可以将 HL7 v2 和其他格式数据转换为 FHIR。
在 Power BI 仪表板中使用 FHIR 数据
(可选)可以使用 FHIR 数据创建 Power BI 仪表板报表。
后续步骤
本文介绍了开始使用 FHIR 服务的基本步骤。 有关在 Azure Health Data Services 工作区中部署 FHIR 服务的信息,请参阅
FHIR® 是 HL7 的注册商标,经 HL7 许可使用。