intel/intel-optimized-clickhouse

Intel优化的ClickHouse® Docker镜像文档

镜像概述和主要用途

ClickHouse®是一个面向列的数据库管理系统(DBMS)，专为在线分析处理查询(OLAP)设计。本Docker镜像（clickhouse-iaa-base）包含最新的ClickHouse服务器，特别优化以利用Intel内存分析加速器(IAA)通过硬件辅助编解码器提升数据处理性能。该镜像支持通过Docker或Kubernetes作为后端部署ClickHouse服务器，当主机未正确配置IAA时会自动回退到软件编解码器。

核心功能和特性

• 列导向存储：针对OLAP场景优化，适合大规模数据分析和查询
• IAA硬件加速：利用Intel内存分析加速器实现硬件辅助编解码，提升处理性能
• 自动回退机制：当主机IAA配置不完整时，自动切换至软件编解码器
• 灵活部署：支持Docker或Kubernetes部署，满足不同环境需求

使用场景和适用范围

• 大规模数据分析与查询场景
• 需要高性能OLAP处理的业务系统
• 已配置Intel IAA硬件加速的服务器环境
• 对数据处理效率有较高要求的企业级应用

使用方法和配置说明

Docker部署示例

在已配置IAA的主机上，通过以下命令启动ClickHouse服务器：

bash
docker run --rm --detach --privileged --network host docker.xuanyuan.run/intel/intel-optimized-clickhouse

参数说明：

• --privileged：授予容器特权模式，以便访问IAA设备
• --network host：使用主机网络模式
• --rm：容器停止后自动删除
• --detach：后台运行容器

主机IAA设备配置

BIOS配置

需在BIOS中启用以下选项：

1. EDKII Menu → Socket Configuration → IIO Configuration → Intel VT for directed IO (VT-d) → Intel VT for directed IO → Enable
2. EDKII Menu → Socket Configuration → IIO Configuration → PCI ENQCMD/ENQCMDS → Yes

内核参数配置

需在内核命令行启用VT-d，可通过以下步骤配置：

1. 检查当前内核参数：

   bash
   cat /proc/cmdline
   

2. 更新内核参数：

   bash
   sudo grubby --update-kernel=DEFAULT --args="intel_iommu=on,sm_on iommu=pt"
   

3. 重启系统使配置生效：

   bash
   sudo reboot
   

启用IAA设备

需在主机上启用IAA设备，或集成到Docker镜像中。若通过Docker启用，需添加-v /dev:/dev挂载选项。以下命令启用4个IAA设备：

bash
# 加载配置
accel-config load-config -c ./accel-iaa-4d1g8e.conf

# 启用设备和工作队列
accel-config enable-device iax1
accel-config enable-wq iax1/wq1.0
accel-config enable-device iax3
accel-config enable-wq iax3/wq3.0
accel-config enable-device iax5
accel-config enable-wq iax5/wq5.0
accel-config enable-device iax7
accel-config enable-wq iax7/wq7.0