通过

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

版本控制策略和历史记录管理

  • 项目

Azure Health Data Services FHIR 服务中的版本控制策略是一种配置，它通过资源特定的配置选项确定每种资源类型的历史记录的存储方式。 此策略与管理 FHIR 资源的历史记录的概念直接相关。

FHIR 中的历史记录

FHIR 中的历史记录使你能够查看资源的所有以前版本。 可以在资源级别、类型级别或系统级别查询 FHIR 中的历史记录。 HL7 FHIR 文档提供了有关 历史记录交互的详细信息。 如果想要查看 FHIR 中资源的发展情况，或者想要查看特定时间点的资源信息，历史记录非常有用。

资源的所有过去版本都被视为已过时，资源的当前版本应用于正常的业务工作流操作。 但是，将资源的状态视为做出过去决策的时间点可能很有用。

版本控制策略

通过 FHIR 服务中的版本控制策略，可以决定如何在 FHIR 服务级别或特定资源级别存储历史记录。

版本控制策略有三个不同的级别：

  • versioned：存储历史记录，以便对资源执行操作。 资源版本递增。 这是默认值。
  • version-update：存储历史记录，以便对资源执行操作。 资源版本递增。 汇报需要有效的If-Match标头。 有关详细信息，请参阅 VersionedUpdateExample.http。
  • no-version：不会为资源创建历史记录。 资源版本递增。

版本控制策略可作为系统范围的设置进行配置，也可在资源级别替代。 系统范围的设置用于 FHIR 服务中的所有资源，除非已添加特定的资源级别版本控制策略。

版本控制策略比较

策略值 历史记录行为 meta.versionId 更新行为 默认
versioned 存储历史记录 不需要If-Match 是
version-update 存储历史记录 需要If-Match 否
no-version 未存储历史记录 不需要If-Match 否

注意

将版本控制策略更改为 no-version 不会影响现有资源历史记录。 如果需要删除资源的历史记录，请使用 $purge历史记录 操作。

配置版本控制策略

若要配置版本控制策略，请在 FHIR 服务中选择“ 版本控制策略配置” 边栏选项卡。

Azure 门户版本控制策略配置的屏幕截图。

浏览到版本控制策略配置后，你将能够在系统级别和资源级别配置设置， (作为系统级别) 的替代。 系统级别配置 (注释为 1) 将应用于 FHIR 服务中的每个资源，除非配置了在 2) 批注的资源特定替代 (。

Azure 门户版本控制策略配置的屏幕截图，其中显示了系统级别与资源级别配置。

配置资源级别配置时，你将能够选择 (批注为 1) 的 FHIR 资源类型，并且此特定资源的特定版本控制策略 (注释为 2) 。 请确保选择“ 添加 ”按钮 (批注为 3) ，以便将此设置排队保存。

显示资源级别配置的Azure 门户版本控制策略配置的屏幕截图。

请确保 在完成版本控制策略配置后选择“ 保存 ”。

Azure 门户版本控制策略配置配置的屏幕截图，其中显示了“保存”按钮。

历史记录管理

对于最终用户来说，FHIR 中的历史记录对于查看资源随时间变化的方式非常重要。 它还有助于与审核日志协调，以查看资源在用户修改之前和之后的状态。 通常，除非知道不需要历史记录，否则建议保留资源的历史记录。 频繁更新资源可能会导致数据存储量很大，在包含大量数据的 FHIR 服务中，这种存储可能是不需要的。

在系统级别或资源级别更改版本控制策略不会删除 FHIR 服务中任何资源的现有历史记录。 如果要减少 FHIR 服务中的历史记录数据大小，则必须使用 $purge历史记录 操作。

后续步骤

本文介绍了如何清除 FHIR 服务中资源的历史记录。 有关如何禁用历史记录的详细信息以及有关历史记录管理的一些概念，请参阅

清除历史记录操作

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