通过

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

发行说明：Azure API for FHIR

  • 项目

重要

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 的演化版本，可让客户管理 FHIR、DICOM 和医疗技术服务，并集成到其他 Azure 服务。

Azure API for FHIR® 提供适用于 Azure 的 Microsoft FHIR 服务器的完全托管部署。 该服务器是 FHIR 标准的一种实现。 本文档提供有关 Azure API for FHIR 的功能和增强功能的详细信息。

2024 年 11 月

FHIR 服务

Bug 修复

  • 导出验证改进：尽管搜索参数无效，但发现导出继续进行的问题。 实施新的更改以防止在这些条件下导出。 此选项为默认行为。 客户可以使用宽大标志替代它。 此更改上个月传达给客户。
  • 捆绑性能增强：捆绑包执行期间的配置文件刷新过程已简化。 如果捆绑包包含对 ValueSetStructureDefinition/> 和/或 CodeSystem的更改，则在捆绑包完全完成之前不会进行配置文件刷新。 此更改通过减少处理这些资源类型的更改时多次刷新导致的延迟来提高捆绑包的性能。
  • 内容类型标头分析：已解决并解决与分析 application/x-www-form-urlencoded 内容类型标头相关的问题。
  • 通过删除以前限制处理大型历史数据集或客户请求有限查询大小的事例的人为限制，改进了重新编制索引增强功能。 此外，在处理具有默认查询大小的许多连续历史或删除资源时，重新编制索引过程将错误地报告为“已完成”。 此问题已得到解决，以确保重新编制索引过程正确完成并报告相应的状态。

2024 年 10 月

FHIR 服务

Bug 修复

  • 导出验证：尽管搜索参数无效，但已确定导出继续进行的问题。 我们正在引入一项更改，防止在这些条件下导出。 此功能目前落后于严格的验证标志，并将成为 10 月 30 日或之后的默认行为。
  • 搜索参数包含：我们解决了其他搜索参数（例如， _include） _has未返回所有预期结果的问题，有时省略下一个链接。
  • 导出作业执行：通过防止过早退出来解决导出作业完成期间很少出现 System.ObjectDisposedException 的情况。
  • HTTP 状态代码更新：作业创建期间 $reindex 无效参数的 HTTP 状态代码现已更新为 400，确保更好地处理错误。
  • 搜索参数清理：已实施修复，以确保在通过删除 API 调用触发时，在数据库中完成搜索参数的清理，解决与不完整删除相关的问题。

2024 年 8 月

FHIR 服务

修复了 Bug 修复 ：修复了解决大型导出错误地显示“已完成”状态的问题，而子任务仍在处理。 该解决方案包含延迟来缓解这些状态错误的发生，从而提高导出可靠性。

2024 年 7 月

FHIR 服务

Bug 修复

已修复：将数据导出为 SMART 用户 ，因为 SMART 用户不再需要写入范围。 以前，有必要向 SMART 用户授予“写入”权限，以导出数据，这意味着更高的特权级别。 若要以 SMART 用户身份启动导出作业，请确保该用户是 RBAC 中的 FHIR 导出角色的成员，并请求“读取”SMART 临床范围。

已修复：在修补操作期间，如果有效负载请求更新参数以外的资源类型，则最初引发内部服务器错误（HTTP 500），将状态代码从 HTTP 500 更新为 HTTP 400。 这已更新为改为引发 HTTP 400 错误。

2024 年 5 月

FHIR 服务

清除历史记录操作 的增强功能：清除历史记录操作允许使用查询参数“allowPartialSuccess”执行部分删除。 默认情况下，清除历史记录操作在删除资源之前等待成功完成。 但是，如果在执行过程中发生错误，则会回滚资源删除。 通过使用“allowPartialSuccess”查询参数，可以防止发生错误时回滚事务。

Bug 修复

  • 已修复：长时间运行的请求的 HTTP 状态代码。 执行时间超过 100 秒的 FHIR 请求返回 HTTP 408 状态代码，而不是 HTTP 500。
  • 已修复：捆绑包中的历史记录请求。 在修复之前，捆绑包中的历史记录请求返回了 HTTP 状态代码 404。

2024 年 3 月

默认情况下，Batch 捆绑并行化 Batch 捆绑包在 FHIR 服务中串行执行。 为了提高捆绑包调用的吞吐量，我们启用了批处理捆绑包的并行处理。

了解详细信息：

Bug 修复

  • 已修复：提高捆绑处理的性能。 对任务执行方法进行了更新，导致捆绑处理性能改进。 请参阅 PR#3727。

2024 年 2 月

启用对资源 的所有版本（历史删除和软删除）进行计数。可将查询参数 _summary=count 和 _count=0 添加到_history终结点以获取所有版本控制的资源计数。 此计数包括软删除的资源。 有关详细信息，请参阅 历史记录管理。

提高导出操作 的吞吐量：可以将“_isparallel”查询参数添加到导出操作以提高其吞吐量。 请务必注意，使用此参数可能会导致在导出生命周期内请求单位消耗增加。 有关详细信息，请参阅 导出操作查询参数。

注意

$export操作存在一个已知问题，可能会导致状态成功导出不完整。 使用is_parallel标志时出现问题。 从 2024 年 2 月 13 日开始，使用 _isparallel 查询参数执行的导出作业将受到此问题的影响。

更改导出的文件名和默认存储帐户 的名称命名名称。更改此更改后，导出的文件名采用“{FHIR 资源名称}-{Number}-{Number}.ndjson”格式。 不保证文件的顺序与数据库中资源的任何排序相对应。 默认存储帐户名称将更新为“Export-{Number}”。 不会更改单个导出文件中添加的资源数。

可以使用 HTTP 标头“x-ms-query-latency-over-efficiency”启用 FHIR 查询的性能增强 并行优化。 此值需要设置为 true 才能在执行查询期间实现最大并发性。 有关详细信息，请参阅 Batch 捆绑包。

2024 年 1 月

使用条件交互 并发执行查询时，条件交互可能比较复杂且性能密集型。 若要增强涉及条件交互的查询延迟，可以选择使用请求标头 x-conditionalquery-processing-logic。 有关详细信息，请参阅 条件 API 交互的性能注意事项。

2023 年 12 月

添加到导出操作 的其他功能$export操作现在支持导出版本控制的资源和软删除的资源。 有关详细信息，请参阅 导出查询参数。

2023 年 11 月

批量删除功能现在以预览版 “$bulk-delete”提供，允许异步从 FHIR 服务器中删除资源。 可在系统级别或单个资源类型执行批量删除操作。 有关详细信息，请参阅 大容量删除操作。

批量删除操作目前以公共预览版提供。 查看免责声明以了解详细信息。 [!包括公共预览版免责声明]

Bug 修复：使用分页和重新验证的 FHIR 查询导致使用下一个链接时出错

现在解决了问题，并且 FHIR 查询使用包含/重新排除的延续令牌，不再报告异常。 有关修复的详细信息，请访问 #3525。

2023 年 6 月

Bug 修复：功能语句中的元数据终结点 URL 是每个 FHIR 规范的相对 URL ，功能语句中的元数据终结点 URL 必须是绝对 URL。 有关 FHIR 规范的详细信息，请访问 Capability 语句。 此扇区解决了此问题，有关详细信息，请访问 3265。

2023 年 5 月

SMART on FHIR：固定应用程序的临床范围映射

此 bug 修复了未正确解释后端应用程序临床范围的问题。 有关更多详细信息，请访问 #3250

2023 年 4 月

修复了与加载自定义搜索参数 相关的暂时性问题。此 bug 修复了该问题，其中 FHIR 服务在发生故障时不会加载最新的 SearchParameter 状态。 有关更多详细信息，请访问 #3222

2022 年 11 月

修复了使用 if-match 标头和 PATCH 更新资源时生成的错误

Bug 现已修复，如果资源与 Etag 标头匹配，则会更新资源。 有关详细信息，请参阅 #2877|。

2022 年 5 月

增强

增强功能 相关信息
如果资源内容未更改，Azure API for FHIR 不会创建资源的新版本。 如果用户更新了现有资源，并且只有 meta.versionId 或 meta.lastUpdated 发生更改，则我们会返回“确定”以及现有资源信息，而不会更新 VersionId 和 lastUpdated。 有关详细信息，请参阅 #2519。

2022 年 4 月

增强功能

增强功能 相关信息
FHIRPath Patch FHIRPath Patch 已作为一项功能添加到 Azure API for FHIR。 这实现了 HL7 网站上定义的 FHIRPath Patch。
将捆绑包通知移动到核心 将 Resource.Bundle 命名空间引入核心后，对字符串资源文件的资源引用必须更加明确。 有关详细信息，请参阅 PR #2478。
在版本控制更新时处理无效标头 当版本控制策略设置为“版本控制更新”时，我们要求在更新时在请求的 if-match 标头中提供资源的最新版本。 指定的版本必须采用 ETag 格式。 以前，如果版本无效或格式不正确，将返回 500。 此更新现在返回“400 错误请求”。 有关详细信息，请参阅 PR #2467。

Bug 修复

Bug 修复 相关信息
将核心添加到资源路径 版本控制策略中意外删除了字符串资源的部分路径。 此修复会将其添加回去。 有关详细信息，请参阅 PR #2470。
SQL 超时返回 500 错误 修复了当 SQL 请求超时且请求返回 500 时的 bug。 在日志中，与收到来自前端的 429 错误相比，这是 SQL 超时。 有关详细信息，请参阅 PR #2497。

2022 年 3 月

功能

功能 相关信息
FHIRPath Patch 此新功能使你能够在 FHIR 资源上使用 FHIRPath Patch。 有关详细信息，请参阅适用于 Azure API for FHIR 的 FHIR REST API 功能。

Bug 修复

Bug 修复 相关信息
在包含 _include 的搜索中复制资源 修复了在包含 _include 的搜索中单个资源可以返回两次的问题。 有关详细信息，请参阅 PR #2448。
PUT 在版本控制更新时创建 已修复问题：当版本控制策略配置为 versioned-update时，使用 PUT 创建会导致错误。 有关详细信息，请参阅 PR #2457。
版本控制更新时标头处理无效 修复了无效的 if-match 标头会导致 HTTP 500 错误的问题。 现在将返回“HTTP 错误请求”。 有关详细信息，请参阅 PR #2467。

2022 年 2 月

功能和增强功能

增强功能 相关信息
在 BundleHandler 中添加了 429 重试和日志记录 在处理捆绑包时，我们有时会遇到 429 错误。 如果 FHIR 服务在 BundleHandler 层收到 429，我们将中止对捆绑包的处理，并跳过剩余的资源。 除了数据存储层中的重试之外，我们还添加了另一个重试，该重试将针对每个遇到 429 的资源执行一次。 有关此增强功能的详细信息，请参阅 PR #2400。
$convert-data 和 $de-id 的计费 Azure API for FHIR 的数据转换和去标识化导出功能现已正式发布。 已启用 Azure API for FHIR 中 $convert-data 和 $de-id 操作的计费。 计费仪表于 2022 年 3 月 1 日启用。

Bug 修复

Bug 修复 相关信息
更新分段搜索索引 存在一种极端情况，即未在资源上设置分段搜索索引。 现在，我们使用与主要搜索相同的索引进行分段搜索，以确保返回所有数据。 有关代码修复的详细信息，请参阅 PR #2430。

2021 年 12 月

功能和增强功能

增强功能 相关信息
将发布服务器添加到 CapabilityStatement.name 现在可以在 CapabilityStatement.name 的功能声明中找到发布服务器。 #2319
日志 FhirOperation 链接到对请求指标的匿名调用 我们没有记录不需要身份验证的操作。 我们扩展了在匿名调用的 RequestMetrics 中获取 FhirOperation 类型的功能。 #2295

Bug 修复

Bug 修复 相关信息
修复了 SearchParameter 代码为 null 时的 500 错误 修复了 SearchParameter 的以下问题：如果它的代码值为 null，则结果将为 500。 现在，它生成 InvalidResourceException 与其他值类似。 #2343
当输入 JSON 正文无效时，返回包含有效消息的 BadRequestException 对于无效的 JSON 正文请求，FHIR 服务器返回 500 错误。 现在，我们将返回 BadRequestException 包含有效消息而不是 500 的消息。 #2239
_sort 可能导致 ChainedSearch 返回错误的结果 以前，未清除链接搜索的 SearchOption 对象中的排序选项，导致排序选项被传递到链接子搜索，这是无效的。 当应有结果时，这可能会导致不生成任何结果。 此 bug 现已修复 #2347。 它解决了 GitHub bug #2344。

2021 年 11 月

功能和增强功能

增强功能 相关信息
处理 Patient-everything 链接 我们扩展了 Patient-everything 功能以处理患者链接 #2305。 有关详细信息，请参阅 FHIR 中的 Patient-everything 文档。
向功能声明中添加了软件名称和版本 在功能声明中，软件名称现在可以区分你使用的是 Azure API for FHIR 还是 Azure Health Data Services。 软件版本现在将指定托管服务中存在的开源发布包 #2294。 地址：#1778 和 #2241
将 500s 记录到 RequestMetric 以前，RequestMetric 中未记录 500 或任何未知/未处理的错误。 现在将记录它们 #2240。 有关详细信息，请参阅在 Azure API for FHIR 中启用诊断设置
压缩延续令牌 在某些情况下，延续令牌太长，无法跟踪搜索中的下一个链接，并且会导致 404。 为了解决此问题，我们对延续令牌进行了压缩，以确保其保持在大小限制以下 #2279。 解决了问题 #2250。

Bug 修复

Bug 修复 相关信息
解决了在传递带有时区的日期时的 500 错误。 这修复了在将带有时区的日期传递到日期/时间字段时的 500 错误 #2270。
解决了在发布具有错误媒体类型的捆绑包时返回 500 错误的问题。 以前，在通过包含特定字符的键发布搜索时，会返回 500 错误。 这修复了此问题 #2264，并解决了 #2148。

2021 年 10 月

Bug 修复

无限循环 bug 相关信息
修复了条件删除可能导致无限循环的问题。 #2269

2021 年 9 月

功能和增强功能

增强功能 相关信息
添加了对条件修补程序的支持 条件修补程序
条件修补程序 #2163
添加了条件修补程序审核事件。 #2213
允许捆绑包中的 JSON 修补程序 捆绑包中的 JSON 修补程序
允许通过修补程序请求搜索历史捆绑包。 #2156
使用二进制资源在捆绑包中启用了 JSON 修补程序。 #2143
新的审核事件子类型 相关信息
添加了新的审核 OperationName 子类型。 #2170
重新索引改进 相关信息
为重新索引参数添加了边界。 #2103
更新重新索引参数边界的错误消息。 #2109
添加了最终重新索引计数检查。 #2099

Bug 修复

Bug 修复 相关信息
应用修补程序时，更广泛地捕获异常。 #2192
使用 STU3 中的 PATCH 修复历史记录。 #2177
自定义搜索 bug 相关信息
解决自定义搜索参数失败的问题。 #2133
在删除搜索参数时添加了重试逻辑。 #2121
在 SearchParameterDefinitionManager 的搜索选项中设置最大项计数。 #2141
如果搜索参数中存在错误的表达式，则提供更好的异常。 #2157
解决了重试 503 错误 相关信息
Azure Cosmos DB 中的重试 503 错误。 #2106
修复了 StoreProcedures 中的 429 处理。 #2165
解决了 GitHub 问题 相关信息
无法为 CarePlan 医疗设备创建自定义搜索参数。 #2146
没有 ID 的条件创建的错误消息不明确。 #2168

适用于 FHIR 的 IoT 连接器（预览版）

Bug 修复 相关信息
修复了断开的链接。 更新了指向 Azure API for FHIR 门户中 IoT 连接器 Azure 文档的链接。

后续步骤

有关 Azure Health Data Services（FHIR 服务、DICOM 服务和医疗技术服务）中的功能和 bug 修复的信息，请参阅

发行说明：Azure Health Data Services

注意

FHIR® 是 HL7 的注册商标，经 HL7 许可使用。