CentOS Stream 9 服務器 Docker 部署 KaiwuDB 實戰(zhàn)指南
最近在研究物聯網數據庫選型時，了解到 KaiwuDB 是一款面向 AIoT 場景的分布式多模數據庫，支持在同一實例中同時處理時序數據和關系數據，并能進行跨模查詢。這個特性非常吸引我。
本次實操我選擇了 CentOS Stream 9 云服務器，采用 Docker 方式部署 KaiwuDB，并基于智能電表場景，完整實踐了時序表與關系表的創(chuàng)建以及跨模查詢。本文將記錄從環(huán)境準備、部署踩坑到實戰(zhàn)應用的全過程。
環(huán)境信息如下。操作系統為 CentOS Stream 9 x86_64 架構，Docker 版本 29.0 以上，KaiwuDB 版本為 3.1.0 官方最新版，服務器配置為 16 核 32G 內存。
一、環(huán)境準備
首先檢查 CentOS 系統版本。
cat /etc/centos-release
然后檢查 Docker 是否已安裝。
docker --version docker compose version
檢查端口是否被占用。KaiwuDB 默認使用 8080 端口提供 Web 界面，26257 端口提供數據庫服務。
netstat -tlnp | grep 8080 netstat -tlnp | grep 26257
如果有端口被占用，需要先停止相應進程或修改端口映射。
創(chuàng)建部署目錄。
mkdir -p ~/kwdb-docker && cd ~/kwdb-docker
二、Docker 部署 KaiwuDB
官方提供了兩種 Docker 部署方式，我選擇了更清晰的 docker compose 方式。
首先拉取 KaiwuDB 鏡像。
docker pull registry.cn-hangzhou.aliyuncs.com/kwdb/kwdb:latest
然后創(chuàng)建 docker-compose.yml 文件。
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
驗證容器運行狀態(tài)。
docker ps
三、連接 KaiwuDB 驗證
進入容器。
bash
docker exec -it kaiwudb-experience /bin/bash
使用 kwbase CLI 連接數據庫。
./kwbase sql --insecure --host=localhost
查看數據庫版本。
SELECT VERSION();
四、核心實戰(zhàn)：雙模建表與跨模查詢
參考官方文檔和社區(qū)實踐，我模擬了一個智能電表場景。
4.1 創(chuàng)建關系數據庫和關系表
關系表用于存儲電表檔案信息。
-- 創(chuàng)建關系數據庫
CREATE DATABASE db1;
-- 切換到關系數據庫
SET DATABASE = db1;
-- 創(chuàng)建關系表，存儲電表基礎信息
CREATE TABLE accounts (
meter_id STRING PRIMARY KEY,
location STRING,
customer_name STRING,
install_date DATE
);
-- 插入測試數據
INSERT INTO accounts VALUES
('M1001', '北京市朝陽區(qū)', '王先生', '2026-01-15'),
('M1002', '上海市浦東新區(qū)', '李女士', '2026-02-20'),
('M1003', '深圳市南山區(qū)', '張先生', '2026-03-10');
-- 查詢驗證
SELECT * FROM accounts;4.2 創(chuàng)建時序數據庫和時序表
時序表用于存儲電表讀數。
-- 創(chuàng)建時序數據庫
CREATE TS DATABASE ts_db;
-- 切換到時序數據庫
SET DATABASE = ts_db;
-- 創(chuàng)建時序表，存儲實時讀數
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');4.3 跨模查詢實戰(zhàn)
跨模查詢是多模數據庫的核心亮點。場景需求是查看每個用戶的實時用電情況，并顯示用戶姓名和所在區(qū)域。
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 完成了原本需要兩套數據庫加代碼聯動才能實現的復雜操作，這就是多模融合的核心價值。
4.4 進階聚合查詢
統計每個用戶最近一小時的總用電量。
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;五、踩坑與解決記錄
以下是實際部署過程中遇到的幾個典型問題。
坑一：啟動容器時報錯 bash: docker-compose: command not found
原因是新版 Docker 已不再默認包含獨立的 docker-compose 命令，應使用 docker compose 子命令。解決方法是將 docker-compose up -d 改為 docker compose up -d。
坑二：跨模查詢時報錯 relation db1.accounts does not exist
原因是 KWDB 默認在當前數據庫查找表，如果沒有指定數據庫名稱，就會報表不存在。解決方法是使用數據庫名.表名的完整寫法，如 db1.accounts。
坑三：時序表插入數據時報錯 unsupported input type BinaryOperator
原因是 KWDB 不支持 now() + interval 這種二元運算符寫法。時間戳可以使用 NOW() 函數，但不支持加法運算。解決方法是直接使用具體的時間字符串進行插入。
坑四：時序表中標簽列不支持 STRING 類型
根據官方文檔，時序表的標簽列不支持 TIMESTAMP、NVARCHAR、GEOMETRY 等數據類型。解決方法是將 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
);六、總結與心得
從部署體驗來看，Docker 方式的便捷度非常高，十五分鐘左右就能完成部署，比裸機安裝省事很多。官方文檔資料齊全，但部分內容散落在不同平臺，查找時需要一些耐心。
本次實操成功驗證了 KaiwuDB 的兩大核心能力。多模數據統一管理的能力，讓同一個實例可以同時存儲關系數據和時序數據?？缒２樵兊哪芰Γㄟ^ SQL 直接關聯分析兩類數據，無需中間件進行數據拼裝。
結合官方介紹，KaiwuDB 特別適合工業(yè)物聯網、能源電力和車聯網等場景。設備檔案作為關系數據，實時監(jiān)控數據作為時序數據，兩類數據在同一數據庫中統一管理，查詢和分析都非常便捷。
后續(xù)計劃申請試用 KAT 智能體工具，或者嘗試 Smart Meter Web 可視化項目，做更深入的應用探索。
到此這篇關于CentOS Stream 9 服務器 Docker 部署 KaiwuDB 實戰(zhàn)指南的文章就介紹到這了,更多相關Docker 部署 KaiwuDB內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
zabbix監(jiān)控docker容器狀態(tài)【推薦】
這篇文章主要介紹了zabbix監(jiān)控docker容器狀態(tài)的相關資料,非常不錯，具有一定的參考借鑒價值，需要的朋友可以參考下2018-06-06
在處理Docker容器的過程中,經常需要查看容器的日志輸出來排查問題或者進行系統監(jiān)控,本文主要介紹了Docker容器日志查看和清理的實現步驟,感興趣的可以了解一下2023-11-11
這篇文章主要介紹了Docker部署Xinference的教程,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
本文主要介紹了Docker鏡像構建速度優(yōu)化實現,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2024-12-12
本文給大家分享的是Docker v1.13.0 正式版發(fā)布的信息，最近一直在學習docker中，所以關注的比較多，這里分享給大家2017-01-01
使用Docker構建開發(fā)環(huán)境的方法步驟(?Windows和mac)
利用Docker,我們可以做很多事情。所以本文就詳細介紹了使用Docker構建開發(fā)環(huán)境的方法步驟，分為?Windows和mac版本，具有一定的參考價值，感興趣的可以了解一下2021-12-12
在日常使用?Docker?的過程中,可能會遇到在容器內修改了某個配置文件并保存,隨后重啟容器時發(fā)現容器無法正常啟動的情況,下面我們來看看如何解決吧2026-01-01
Docker如何打包本地環(huán)境為tar包給別人使用
這篇文章主要介紹了Docker如何打包本地環(huán)境為tar包給別人使用問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-11-11
這篇文章主要介紹了Centos7下安裝Docker Engine的相關資料，非常不錯，具有參考借鑒價值，需要的朋友參考下2016-12-12
Docker安裝的默認數據目錄為/var/lib/docker,但是如果/目錄掛載的磁盤空間不夠,就需要遷移docker數據到其他目錄,接下來本就給大家介紹遷移變更Docker默認數據存儲目錄的操作步驟,需要的朋友可以參考下2023-12-12