HL7中国批量数据导出服务实施指南 - Local Development build (v2026.01.23) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

首页

官方URL: http://hl7.org.cn/fhir-ig/bulkdata/ImplementationGuide/hl7cn.fhir.bulkdata				版本: 2026.01.23
Draft as of 2026-02-08				机读名称: HL7CN_FHIR_BulkData

概述

定义了一套标准化的、基于FHIR的异步操作，用于从资源服务器向授权客户端高效导出大规模医疗数据集。它旨在解决传统FHIR API在处理海量数据时面临的性能瓶颈，并简化跨系统的批量数据交换流程。

传统的医疗数据批量交换流程繁琐，涉及数据提取、格式转换和文件传输等多个步骤，成本高昂。现有的FHIR API适合处理实时、小规模的数据交互，但对于需要导出数十万条记录的场景（如用于研究或质量评估的患者队列数据），发起大量请求是不现实的。本实施指南通过定义标准的$export操作，使客户端能够以异步方式一次性请求并获取特定群体（如所有患者、一组患者或系统全部数据）的大量资源，服务器会将结果生成为NDJSON格式的文件供客户端下载。

本实施指南是在Bulk Data Access IG v3.0.0的基础上进行剪裁，以适应中国医疗卫生领域的数据交换环境以及HL7中国的FHIR Connectathon评估要求。

本实施指南是为HL7中国2026年FHIR Connectathon测评新增的主题。

使用场景

本实施指南旨在支持共享任何可在FHIR中表示的数据。这意味着本实施指南应适用于如下系统：

• 存储FHIR资源的FHIR服务器；
• 使用FHIR实现作为互操作层的电子病历系统、人群健康系统、公共卫生系统等。

用例

• 术语数据：从术语服务器导出 CodeSystem 和 ValueSet 资源
• 服务提供者数据：导出系统中的医护从业者、地点和医疗卫生机构列表
• 公共卫生数据：用于非实时的大规模公共卫生监测、电子病历报告等
• 财务数据：导出患者的理赔、承保和福利说明等资源，用于财务分析
• 临床与互操作性数据：定期从电子病历系统中导出资源，用于研究数据或人口健康管理
• 传染病上报数据

授权与安全

为确保数据安全，Bulk Data Access IG v3.0.0推荐使用 SMART Backend Services授权框架来管理客户端应用的访问权限。在本实施指南中，暂时省略了这一过程，待App Launch Implementation Guide进行本地化剪裁后会增补该部分内容。

技术内容

模板

本实施指南由 HL7 IG Publisher 发布。目前包括以下模板：

模板 ID	GitHub 代码库	描述
fhir.base.template	https://github.com/HL7/ig-template-base	此模板包含了生成HL7风格实施指南所需的所有脚本、布局文件等。但是，它不包含HL7或FHIR的徽标。它旨在作为大多数非HL7的实施指南的基础。
fhir.hl7cn.template	https://github.com/hl7cn/ig-template-fhir-cn	此此模板继承自 fhir.base.template，并加入了HL7中国徽标、通用的HL7配色方案以及一些HL7中国特定的规则。

章节

本实施指南包含以下章节：

• 首页： 本页面。
• 服务与交易： 描述批量数据导出服务的详细技术要求和四个服务交易说明。
• 最佳实践： 关于创建易于理解和使用的实现指南的建议。
• 下载与支持： 提供本实施指南的下载链接。

依赖关系

本实施指南基于FHIR R5 标准的FHIR 异步请求模式实现。

贡献者

本实施指南由叶大虾🦐翻译、裁剪、整理，如果发现本指南的任何问题，欢迎通过本邮件进行沟通。