samply/blaze

Blaze Docker镜像技术文档

1. 镜像概述和主要用途

Blaze是一个基于FHIR®标准的健康数据存储服务器（FHIR® Store），内置高性能CQL（Clinical Quality Language）评估引擎。其核心用途是提供FHIR资源的持久化存储、查询与聚合分析能力，尤其擅长处理群体范围的数据统计查询，支持交互式在线数据分析场景，满足临床研究、质量报告生成等实时数据访问需求。

2. 核心功能和特性

2.1 FHIR兼容性

• 支持FHIR® 4.0.1标准，通过Touchstone FHIR 4.0.1基础服务器测试套件（Basic Tests）。

2.2 CQL评估引擎

• 内置快速CQL评估引擎，支持***质量指标计算、患者群体筛选等复杂逻辑，通过绝大部分HL7 CQL官方测试用例。

2.3 高性能与可扩展性

• 优化的存储层设计，支持高并发数据读写与聚合查询，提供性能调优指南适配不同负载场景。

2.4 数据持久化

• 支持数据持久化存储，通过Docker数据卷或本地目录实现数据长期保留，服务重启后数据不丢失。

2.5 数据导入与管理

• 提供FHIR资源批量导入工具，支持标准FHIR格式数据的高效加载。

3. 使用场景和适用范围

3.1 ***健康信息系统

作为FHIR服务器集成到医院信息系统（HIS）、电子健康档案（EHR）系统，提供标准化数据存储与访问接口。

3.2 临床研究与数据分析

支持基于CQL的患者群体筛选、疗效分析、疾病趋势统计等临床研究场景，提供实时聚合查询结果。

3.3 ***质量报告

通过CQL评估引擎计算***质量指标（如患者再入院率、疫苗接种覆盖率），生成符合行业标准的质量报告。

3.4 交互式数据查询

满足***人员、研究人员对患者数据的即时查询需求，支持在线调整查询条件并快速获取结果。

4. 使用方法和配置说明

4.1 环境准备

• 安装Docker Engine（20.10+）及Docker Compose（可选）。
• 预留至少10GB磁盘空间用于数据存储（视数据量调整）。

4.2 Docker快速部署

4.2.1 创建数据卷

Blaze通过数据卷持久化存储FHIR资源、索引及配置文件，首次部署需创建专用数据卷：

bash
docker volume create blaze-data

4.2.2 启动容器

使用以下命令启动Blaze服务（默认端口8080）：

bash
docker run -d \
  --name blaze \
  -p 8080:8080 \
  -v blaze-data:/app/data \
  --restart unless-stopped \
  samply/blaze:0.10.3

• 参数说明：
  • -p 8080:8080：端口映射（宿主机端口:容器端口），如需修改访问端口可调整宿主机端口（如-p 9090:8080）。
  • -v blaze-data:/app/data：挂载数据卷至容器内/app/data目录，存储所有持久化数据。
  • --restart unless-stopped：服务异常退出后自动重启。

4.2.3 Docker Compose配置示例

创建docker-compose.yml实现更灵活的部署管理：

yaml
version: '3.8'
services:
  blaze:
    image: samply/blaze:0.10.3
    container_name: blaze
    ports:
      - "8080:8080"  # FHIR API端口
    volumes:
      - blaze-data:/app/data  # 数据持久化卷
    environment:
      - JAVA_OPTS="-Xmx4g"  # 调整JVM内存（根据主机配置修改，建议至少2GB）
    restart: unless-stopped

volumes:
  blaze-data:
    external: true  # 使用已创建的数据卷

启动服务：

bash
docker-compose up -d

4.3 数据目录结构

首次启动后，blaze-data卷内自动生成以下目录（无需手动干预）：

• fhir：存储FHIR资源原始数据。
• index：资源索引文件，加速查询性能。
• transaction-log：事务日志，确保数据一致性。
• config：默认配置文件（如需自定义，可通过挂载外部配置文件覆盖）。

4.4 服务验证

服务启动后，通过以下方式验证运行状态：

• 访问FHIR API根地址：http://<主机IP>:8080/fhir，返回FHIR服务器元数据（JSON格式）。
• 查看容器日志：docker logs -f blaze，无错误日志且显示“Blaze started successfully”即表示启动正常。

4.5 进阶配置

4.5.1 性能调优

• 内存配置：通过JAVA_OPTS调整JVM堆内存（如-Xmx8g -Xms4g），建议根据数据量和查询复杂度增加内存。
• 存储优化：参考官方调优指南调整RocksDB缓存大小、压缩策略等底层存储参数（需通过配置文件自定义）。

4.5.2 数据导入

通过官方工具导入FHIR数据（如JSON格式资源文件），具体步骤参见https://github.com/samply/blaze/blob/develop/docs/importing-data.md%E3%80%82

5. 版本与兼容性

• 最新稳定版本：v0.10.3
• 兼容性：仅支持FHIR 4.0.1版本资源，不兼容DSTU2或R5等其他FHIR版本。

6. 许可证

Blaze基于Apache License 2.0开源协议分发，版权归2020 The Samply Community所有。详细许可条款见Apache License 2.0。

参考文档

• 完整Docker部署指南：https://github.com/samply/blaze/blob/develop/docs/deployment/docker-deployment.md
• 性能调优指南：https://github.com/samply/blaze/blob/develop/docs/tuning-guide.md
• CQL查询使用说明：https://github.com/samply/blaze/blob/develop/docs/cql-queries.md