记录了在 CentOS Stream 9 服务器上通过 Docker 部署 KaiwuDB 社区版的全过程。内容包括环境检查、Docker Compose 配置、容器启动验证以及核心功能实战。重点演示了如何在同一实例中创建关系型与时序型数据库，并通过 SQL 实现跨模查询，解决了传统架构需多库联动的问题。文章还总结了部署过程中遇到的常见错误及解决方案，如命令版本差异、表引用路径、时间戳语法限制及标签类型约束等，为 IoT 场景下的多模数据库应用提供参考。
最近在研究物联网数据库选型时，了解到 KWDB 是一款面向 AIoT 场景的分布式多模数据库，支持在同一实例中同时处理时序数据和关系数据，并能进行跨模查询。这个特性非常吸引我。
本次实操我选择了 CentOS Stream 9 云服务器，采用 Docker 方式部署 KWDB，并基于智能电表场景，完整实践了'时序表 + 关系表'的创建与跨模查询。本文将记录从环境准备、部署踩坑到实战应用的全过程。
环境信息：
cat /etc/centos-release
docker --version && docker compose version
KWDB 默认使用 8080（Web 界面）和 26257（数据库服务端口）。
netstat -tlnp | grep 8080
netstat -tlnp | grep 26257
如有占用，需要先停止相应进程或修改端口映射。
mkdir -p ~/kwdb-docker && cd ~/kwdb-docker
（官方提供了两种 Docker 部署方式，我选择了更清晰的 docker-compose 方式）
docker pull registry.cn-hangzhou.aliyuncs.com/kwdb/kwdb:latest
vim docker-compose.yml
写入以下内容：
services:
kaiwudb-container:
image: "registry.cn-hangzhou.aliyuncs.com/kwdb/kwdb:latest"
container_name: kaiwudb-experience
hostname: kaiwudb-experience
ports:
- 8080:8080
- 26257:26257
ulimits:
memlock: -1
volumes:
- /dev:/dev
restart: on-failure
ipc: shareable
privileged: true
environment:
- LD_LIBRARY_PATH=/kaiwudb/lib
- tty=true
working_dir: /kaiwudb/bin
command:
- /bin/bash
- -c
- |
./kwbase start-single-node --insecure --listen-addr=0.0.0.0:26257 --advertise-addr=222.*.*.130:26257 --http-addr=0.0.0.0:8080 --store=/kaiwudb/deploy/kaiwudb
docker compose up -d
docker ps
docker exec -it kaiwudb-experience /bin/bash
./kwbase sql --insecure --host=localhost
SELECT VERSION();
（参考官方文档和社区实践，我模拟一个智能电表场景）
-- 创建关系数据库
CREATE DATABASE db1;
-- 切换到关系数据库
SET DATABASE = db1;
-- 创建关系表：存储电表基础信息
CREATE TABLE accounts (
meter_id STRING PRIMARY KEY,
location STRING,
customer_name STRING,
install_date DATE
);
-- 插入测试数据
INSERT INTO accounts VALUES
('M1001','北京市朝阳区','王先生','2024-01-15'),
('M1002','上海市浦东新区','李女士','2024-02-20'),
('M1003','深圳市南山区','张先生','2024-03-10');
-- 查询验证
SELECT * FROM accounts;
-- 创建时序数据库
CREATE TS DATABASE ts_db;
-- 切换到时序数据库
SET DATABASE = ts_db;
-- 创建时序表：存储实时读数
-- 注意：时序表需要指定时间戳列和标签列
CREATE TABLE readings (
ts TIMESTAMP NOT NULL,
voltage FLOAT,
current FLOAT,
power FLOAT
) TAGS (
meter_id VARCHAR(64) NOT NULL
) PRIMARY TAGS (meter_id);
-- 插入模拟时序数据
INSERT INTO readings VALUES
('2026-02-27 14:30:00',220.5,5.2,1146.6,'M1001'),
('2026-02-27 14:31:00',221.3,6.1,1350.9,'M1001'),
('2026-02-27 14:30:00',219.8,4.8,1055.0,'M1002'),
('2026-02-27 14:31:00',220.1,7.2,1584.7,'M1002'),
('2026-02-27 14:30:00',221.0,3.9,861.9,'M1003');
场景需求：查看'每个用户的实时用电情况，并显示用户姓名和所在区域'
-- 跨库跨模查询：关联关系库的 accounts 表和时序库的 readings 表
SELECT a.customer_name, a.location, r.ts, r.voltage, r.power
FROM ts_db.readings r
JOIN db1.accounts a ON r.meter_id = a.meter_id
WHERE r.ts >= now() - interval '5 minutes'
ORDER BY r.ts;
结果分析：可以看到，时序表的实时读数成功关联上了关系表的用户信息，一条 SQL 搞定原本需要两套数据库 + 代码联动的复杂操作，这就是 KWDB 多模融合的价值所在！
-- 统计每个用户最近 1 小时的总用电量
SELECT a.customer_name, SUM(r.power) as total_power
FROM ts_db.readings r
JOIN db1.accounts a ON r.meter_id = a.meter_id
WHERE r.ts >= now() - interval '1 hour'
GROUP BY a.customer_name;
docker-compose up -d 提示 bash: docker-compose: command not found
docker compose up -d解决：
docker compose up -d
数据库名。表名 的完整写法，如 db1.accounts
now() + interval '1 minute' 这种二元运算符写法。根据官方文档，时间戳可以使用 NOW() 函数，但不支持这种加法运算。INSERT INTO readings VALUES
('2026-02-27 14:30:00',220.5,5.2,1146.6,'M1001'),
('2026-02-27 14:31:00',221.3,6.1,1350.9,'M1001'),
('2026-02-27 14:30:00',219.8,4.8,1055.0,'M1002'),
('2026-02-27 14:31:00',220.1,7.2,1584.7,'M1002'),
('2026-02-27 14:30:00',221.0,3.9,861.9,'M1003');
现象
原因：在 KWDB 时序表中，标签列不支持 STRING 类型。根据官方文档，时序表的标签列不支持以下数据类型：
解决: 将 STRING 改为 VARCHAR
CREATE TABLE readings (
ts TIMESTAMP NOT NULL,
voltage FLOAT,
current FLOAT,
power FLOAT
) TAGS (
meter_id VARCHAR(64) NOT NULL
) PRIMARY TAGS (meter_id);
本次实操成功验证了 KWDB 的两大核心能力：
结合官方介绍，我认为 KWDB 特别适合以下场景：
下一步打算申请试用 KAT（KWDB 智能体工具）或尝试 Smart Meter Web 可视化项目，做更深入的应用探索。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
在线格式化和美化您的 SQL 查询（它支持各种 SQL 方言）。 在线工具，SQL 美化和格式化在线工具，online
解析 INSERT 等受限 SQL，导出为 CSV、JSON、XML、YAML、HTML 表格（见页内语法说明）。 在线工具，SQL 转 CSV/JSON/XML在线工具，online
CSV 与 JSON/XML/HTML/TSV/SQL 等互转，单页多 Tab。 在线工具，CSV 工具包在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online