有关 Azure API for FHIR 的常见问题解答

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

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

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

支持将 entra ID 作为标识提供者Microsoft。

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

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

支持版本 4.0.0 和 3.0.1。 有关详细信息，请参阅 FHIR 支持的功能。 还可以在 HL7 FHIR 的版本历史记录中查看各个 FHIR 版本（STU3 到 R4）的变化。

适用于 FHIR 的 Azure IoT 连接器（预览版）目前仅支持 FHIR 版本 R4，在 Azure API for FHIR 的 R4 实例上可见。

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

发行说明页中概述了过去一个月在该托管服务中随附的所有功能。

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

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

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

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

不是。 无法更改 Azure API for FHIR 的 URL。

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

是的，使用 AHDS 示例支持 SMART on FHIR 功能。 这称为 SMART on FHIR（增强）。 SMART on FHIR（增强版）可被视为满足 SMART on FHIR 实施指南 (v 1.0.0) 和 §170.315(g)(10) 用于患者和人群服务标准的标准化 API 的要求。 有关详细信息，请访问 SMART on FHIR（增强）文档。

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

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

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

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

当前对 _count 的限制为 1000 条。 如果将_count设置为 1000 个以上，则会在捆绑包中收到一条警告，指出只会显示 1000 条记录。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

我们在 运行状况体系结构 GitHub 页上提供了一系列参考体系结构。

若要对 FHIR 服务执行运行状况检查，请在 GET 请求中输入 {{fhirurl}}/health/check 。 应能够看到 FHIR 服务的状态。 HTTP 状态代码响应，200 和 OverallStatus 作为响应中的“正常”，表示运行状况检查成功。 如果出现错误，你将收到 HTTP 状态代码 404（未找到）或状态代码 500（内部服务器错误）的错误响应，以及在某些情况下响应正文中的详细信息。

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

检查是否为 FHIR 资源启用了灾难恢复。 如果是，请禁用灾难恢复功能。

检查与 FHIR 实例关联的 RU 消耗量。 如果 RU 消耗量较高（约 100%），请检查限制错误是否对应于高 RU 使用率的时间。 如果这样做，请考虑为服务启用自动缩放，并增加分配给服务的 RU。 有关更多详细信息 ，请参阅自动缩放 Azure API for FHIR 。