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

有关 Azure API for FHIR 的常见问题

Azure API for FHIR:基础知识

什么是 FHIR?

快速医疗保健互操作性资源(FHIR - 发音为“fire”)是一个互操作性标准,旨在允许在不同的健康状况系统之间交换医疗保健数据。 此标准由 HL7 组织开发。如今,世界各地的医疗保健组织均正在采用此标准。 FHIR 的最新可用版本为 R4(版本 4)。 适用于 FHIR 的 Azure API 支持 R4 和以前的 STU3 (标准版,用于试用使用 3) 。 如需获取 FHIR 的详细信息,请访问 HL7.org

FHIR API 数据是否存储在 Azure 中?

是的,这些数据存储在 Azure 中的托管数据库内。 Azure API for FHIR 不提供对底层数据存储的直接访问。

如何获取对基础数据的访问权限?

在托管服务中,无法访问基础数据。 这是为了确保 Azure API for FHIR 提供医疗保健数据所需的隐私和合规性认证。 如果需要访问基础数据,可以使用 开源 FHIR 服务器

支持哪些标识提供者?

支持Microsoft Azure Active Directory作为标识提供者。

是否可以将 Azure AD B2C 与 Azure API for FHIR 配合使用?

否,我们不支持 Azure API for FHIR 中的 B2C。 如果需要更精细的访问控制,建议查看 开源 FHIR 代理

Azure API for FHIR 的备份和恢复策略是什么?

托管服务的数据每 4 小时自动备份一次,两个备份会维护。 因此,保留期为 8 小时。 数据恢复由支持团队完成,恢复点目标 (RPO) 不到 240 分钟。

客户可以通过支持票证请求还原数据或更改默认数据备份策略。

支持哪些 FHIR 版本?

支持版本 4.0.0 和 3.0.1。 有关详细信息,请参阅 FHIR 支持的功能。 还可以阅读 HL7 FHIR 的版本历史记录中 FHIR 版本 (STU3 到 R4) 之间发生的变化。

Azure IoT连接器 for FHIR (预览版) 目前仅支持 FHIR 版本 R4,在 Azure API for FHIR 的 R4 实例上可见。

Azure Health Data Services 与 Azure API for FHIR 之间的区别是什么?

Azure API for FHIR 是一项正式版托管的 FHIR 服务。 Azure Health Data Services 允许在同一工作区中部署 FHIR 服务和 DICOM 服务。 Azure Health Data Services 概述提供了更多详细信息。

适用于 Azure 的 Microsoft FHIR 服务器与 Azure API for FHIR 之间的区别是什么?

Azure API for FHIR 是适用于 Azure 的开源 Microsoft FHIR 服务器的托管和管理版本。 Microsoft 会在托管服务中提供所有维护和更新。

运行适用于 Azure 的 FHIR 服务器时,你可以直接访问基础服务,但如果存储 PHI 数据,我们负责维护和更新服务器和所有必需的符合性工作。

Azure API for FHIR 在哪些区域中可用?

我们在 多个地理区域为公共和政府提供正式发布。 有关 Microsoft 政府云服务的信息,请参阅 FedRAMP 提供的 Azure 服务

在何处可以查看 Azure API for FHIR 中的发布内容?

发行说明页概述了上月已寄送到托管服务的所有内容。

有关 Azure API for FHIR 中发布的内容的详细信息,请参阅开源 FHIR 服务器的 发布 。 我们已使用 Azure-API for-FHIR 标记项目(如果他们将发布到托管服务),并且通常在开放源代码的发布页上发布两周后可用。 如果想要在自己的环境中进行测试,我们还介绍了 如何测试生成

若要查看托管服务中当前有哪些发布包,可以在属性下 software.version 查看 Azure API for FHIR 的功能语句。 你将看到部署了哪个包。

在何处可以找到 R4/STU3) 在数据库上运行的 FHIR (版本?

可以在属性下 fhirVersion 的功能语句中找到公开的确切 FHIR 版本。

是否可以将 Azure API for FHIR 从 STU3 切换到 R4?

否。 我们没有办法更改现有数据库的版本。 需要创建新的 Azure API for FHIR 并重新加载数据。 可以将 JSON 用作 将 STU3 数据转换为 R4 的位置。

是否可以自定义 Azure API for FHIR 的 URL?

否。 无法更改 Azure API for FHIR 的 URL。

FHIR 实现和规范

什么是 SMART on FHIR?

SMART(可替换式医疗应用程序和可重用技术)on FHIR 是一组开放式规范,用于将合作伙伴应用程序与 FHIR 服务器和其他健康 IT 系统(如电子健康记录和健康信息交换)集成。 通过创建 SMART on FHIR 应用程序,可确保多种不同系统能够访问和使用你的应用程序。 有关 SMART 的详细信息,请访问 SMART Health IT 网站。

Azure API for FHIR 是否支持 SMART on FHIR?

作为托管服务的一部分,我们有基本的 SMART on FHIR 代理。 如果这不符合你的需求,则可以将开源 FHIR 代理用于更高级的 SMART 方案。

能否创建自定义 FHIR 资源?

我们不允许用户创建自定义 FHIR 资源。 如需自定义 FHIR 资源,可在带有扩展的基本资源上生成自定义资源。

Azure API for FHIR 是否支持扩展?

允许将任何有效的 FHIR JSON 数据加载到服务器。 如果要存储定义扩展的结构定义,可以将它保存为结构定义资源。 若要搜索扩展,需要自定义搜索参数

我可以上传的资源的大小限制是多少?

资源必须不到 2 MB。 这是基础数据存储的限制,我们无法增加此值。

如何实现 XML 中查看 Azure API for FHIR?

在托管服务中,我们仅支持 JSON。 开源 FHIR 服务器支持 JSON 和 XML。 若要查看开源中的 XML 版本,请使用 _format= application/fhir+xml

对 _count 有何限制?

当前对 _count 的限制为 1000 条。 如果将 _count 的数量设置超过 1000 条,则捆绑包会显示一条警告,提示系统只会显示前 1000 条记录。

组导出功能是否有任何限制?

对于组导出,我们只从组导出包含的引用,而不是 组资源的所有特征。

是否可以将捆绑包帖子到 Azure API for FHIR?

我们目前支持发布 批处理捆绑包,但不支持在 Azure API for FHIR 中发布事务捆绑包。 如果需要事务捆绑包支持,可以在 Azure Health Data Services 中使用 FHIR 服务。

如何在 Azure API for FHIR 中获取单个患者的所有资源?

可以使用 患者$everything操作,也可以在 Azure API for FHIR 中使用 隔离舱搜索 。 这样,就可以获取与特定患者相关的所有资源。 请注意,患者舱包含与患者相关的所有资源,但不包括患者本身,因此,如果需要结果中的患者资源,还需要搜索以获取患者。

在 Azure API for FHIR 中搜索资源时,默认排序是什么?

支持按上次更新日期排序:_sort=_lastUpdated。 我们还支持对 FirstName、LastName、BirthDate 和 ClinicalDate 元素_sort。 有关其他受支持的搜索参数的详细信息,请参阅 FHIR 搜索概述

Azure API for FHIR 是否支持$everything?

是的,我们确实支持患者$everything。 有关详细信息,请参阅 患者$Everything操作指南

Azure API for FHIR 是否支持任何术语操作?

否,Azure API for FHIR 目前不支持术语操作。

$export的工作原理是什么?

$export是 FHIR 规范的一部分。 如果 FHIR 服务配置有托管标识和存储帐户,并且托管标识有权访问该存储帐户,则可以在 FHIR API 上调用$export,并将所有 FHIR 资源导出到存储帐户。 有关详细信息,请参阅文章 $export

是否有用于取消标识 EHR 数据的现用解决方案?

我们有一个开源工具来取消标识 FHIR 数据。 同一技术还以 取消标识的 导出形式集成到 Azure API for FHIR 中。

在患者和组级别是否也提供已取消标识的导出?

目前仅在完整系统导出 (/$export) 上支持匿名导出,而不支持患者导出 (/Patient/$export) 。 我们正在努力在患者级别提供它。

Azure API for FHIR 中的删除类型之间的区别是什么?

Azure API for FHIR 中支持两种基本删除类型。 这些是 “删除”和“条件删除”。

  • 使用 Delete,可以选择执行软删除 (最常见的类型) ,但仍能够恢复记录的历史版本。
  • 使用条件删除,可以传递搜索条件来一次删除一个资源或一次多个项。
  • 使用“删除”或“条件删除”时,如果传递 hardDelete 参数,将删除所有记录和历史记录,且不可恢复。

如何实现恢复 Azure API for FHIR 中的已删除记录?

如果不使用 hardDelete 参数,则可以恢复已删除的文件。 Azure API for FHIR 中的记录 () 仍应存在。 可以通过对资源执行历史记录搜索以及查找具有数据的最后一个版本来找到记录 () 。

使用 Azure API for FHIR

如何实现为 Azure API for FHIR 启用 Log Analytics?

有关启用审核日志和示例查询的详细信息,请参阅 Azure API for FHIR 中的“启用诊断日志记录”。 如果要在日志中包含其他信息,请参阅 使用自定义 HTTP 标头

加载和更新数据时,我收到了 429s。 如何解决此问题?

若要解决此问题,可以增加 吞吐量 或切换到 自动缩放 ,以确保有足够的计算来处理请求。 如果仍存在问题,请开具支持票证。

如何实现降低 RU,我无法和 RU 高于设置 RU?

最小 RU 值需要每 GB 至少为 40 RU。 加载数据时,如果低于此最小值,数据库上的 RU 将增加。

在何处可以看到在工作流中使用 Azure API for FHIR 的一些示例?

健康体系结构 GitHub 页面列有一系列参考体系结构。

Azure API for FHIR 功能和服务

是否有办法使用个人密钥加密数据,而不是默认密钥?

是的,Azure API for FHIR 允许配置客户管理的密钥,利用Cosmos DB 的支持。 有关使用个人密钥加密数据的详细信息,请参阅 在 REST 中配置客户管理的密钥

Azure API for FHIR:预览功能

是否可以为 Azure IoT Connector for FHIR (预览版) 配置缩放容量?

由于 Azure IoT Connector for FHIR 在公共预览版期间免费,因此其缩放容量固定且有限。 Azure IoT公共预览版中提供的 FHIR 连接器配置预计将每秒提供大约 200 条消息的吞吐量。 正式发布 (正式版) 中将提供某种形式的资源容量配置。

在 Azure API for FHIR 上启用专用链接时,为什么无法安装 Azure IoT Connector for FHIR (预览版) ?

Azure IoT连接器 for FHIR 目前不支持专用链接功能。 因此,如果在 Azure API for FHIR 上启用了专用链接,则无法安装 Azure IoT Connector for FHIR,反之亦然。 当 Azure IoT Connector for FHIR 可用于正式发布 (GA) 时,此限制将消失。