最近在研究物聯(lián)網(wǎng)數(shù)據(jù)庫選型時(shí)，了解到 KaiwuDB 是一款面向 AIoT 場景的分布式多模數(shù)據(jù)庫，支持在同一實(shí)例中同時(shí)處理時(shí)序數(shù)據(jù)和關(guān)系數(shù)據(jù)，并能進(jìn)行跨模查詢。這個(gè)特性非常吸引我。

本次實(shí)操我選擇了 CentOS Stream 9 云服務(wù)器，采用 Docker 方式部署 KaiwuDB，并基于智能電表場景，完整實(shí)踐了時(shí)序表與關(guān)系表的創(chuàng)建以及跨模查詢。本文將記錄從環(huán)境準(zhǔn)備、部署踩坑到實(shí)戰(zhàn)應(yīng)用的全過程。

環(huán)境信息如下。操作系統(tǒng)為 CentOS Stream 9 x86_64 架構(gòu)，Docker 版本 29.0 以上，KaiwuDB 版本為 3.1.0 官方最新版，服務(wù)器配置為 16 核 32G 內(nèi)存。

一、環(huán)境準(zhǔn)備

首先檢查 CentOS 系統(tǒng)版本。

cat /etc/centos-release

然后檢查 Docker 是否已安裝。

docker --version
docker compose version

檢查端口是否被占用。KaiwuDB 默認(rèn)使用 8080 端口提供 Web 界面，26257 端口提供數(shù)據(jù)庫服務(wù)。

netstat -tlnp | grep 8080
netstat -tlnp | grep 26257

如果有端口被占用，需要先停止相應(yīng)進(jìn)程或修改端口映射。

創(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

寫入以下內(nèi)容。

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

啟動(dòng)容器。

docker compose up -d

驗(yàn)證容器運(yùn)行狀態(tài)。

docker ps

三、連接 KaiwuDB 驗(yàn)證

進(jìn)入容器。

bash

docker exec -it kaiwudb-experience /bin/bash

使用 kwbase CLI 連接數(shù)據(jù)庫。

./kwbase sql --insecure --host=localhost

查看數(shù)據(jù)庫版本。

SELECT VERSION();

四、核心實(shí)戰(zhàn)：雙模建表與跨模查詢

參考官方文檔和社區(qū)實(shí)踐，我模擬了一個(gè)智能電表場景。

4.1 創(chuàng)建關(guān)系數(shù)據(jù)庫和關(guān)系表

關(guān)系表用于存儲(chǔ)電表檔案信息。

-- 創(chuàng)建關(guān)系數(shù)據(jù)庫
CREATE DATABASE db1;
-- 切換到關(guān)系數(shù)據(jù)庫
SET DATABASE = db1;
-- 創(chuàng)建關(guān)系表，存儲(chǔ)電表基礎(chǔ)信息
CREATE TABLE accounts (
    meter_id STRING PRIMARY KEY,
    location STRING,
    customer_name STRING,
    install_date DATE
);
-- 插入測試數(shù)據(jù)
INSERT INTO accounts VALUES 
('M1001', '北京市朝陽區(qū)', '王先生', '2026-01-15'),
('M1002', '上海市浦東新區(qū)', '李女士', '2026-02-20'),
('M1003', '深圳市南山區(qū)', '張先生', '2026-03-10');
-- 查詢驗(yàn)證
SELECT * FROM accounts;

4.2 創(chuàng)建時(shí)序數(shù)據(jù)庫和時(shí)序表

時(shí)序表用于存儲(chǔ)電表讀數(shù)。

-- 創(chuàng)建時(shí)序數(shù)據(jù)庫
CREATE TS DATABASE ts_db;
-- 切換到時(shí)序數(shù)據(jù)庫
SET DATABASE = ts_db;
-- 創(chuàng)建時(shí)序表，存儲(chǔ)實(shí)時(shí)讀數(shù)
CREATE TABLE readings (
    ts TIMESTAMP NOT NULL,
    voltage FLOAT,
    current FLOAT,
    power FLOAT
) TAGS (
    meter_id VARCHAR(64) NOT NULL
) PRIMARY TAGS (
    meter_id
);
-- 插入模擬時(shí)序數(shù)據(jù)
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 跨模查詢實(shí)戰(zhàn)

跨模查詢是多模數(shù)據(jù)庫的核心亮點(diǎn)。場景需求是查看每個(gè)用戶的實(shí)時(shí)用電情況，并顯示用戶姓名和所在區(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;

從結(jié)果可以看到，時(shí)序表的實(shí)時(shí)讀數(shù)成功關(guān)聯(lián)上了關(guān)系表的用戶信息。一條 SQL 完成了原本需要兩套數(shù)據(jù)庫加代碼聯(lián)動(dòng)才能實(shí)現(xiàn)的復(fù)雜操作，這就是多模融合的核心價(jià)值。

4.4 進(jìn)階聚合查詢

統(tǒng)計(jì)每個(gè)用戶最近一小時(shí)的總用電量。

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;

五、踩坑與解決記錄

以下是實(shí)際部署過程中遇到的幾個(gè)典型問題。

坑一：啟動(dòng)容器時(shí)報(bào)錯(cuò) bash: docker-compose: command not found

原因是新版 Docker 已不再默認(rèn)包含獨(dú)立的 docker-compose 命令，應(yīng)使用 docker compose 子命令。解決方法是將 docker-compose up -d 改為 docker compose up -d。

坑二：跨模查詢時(shí)報(bào)錯(cuò) relation db1.accounts does not exist

原因是 KWDB 默認(rèn)在當(dāng)前數(shù)據(jù)庫查找表，如果沒有指定數(shù)據(jù)庫名稱，就會(huì)報(bào)表不存在。解決方法是使用數(shù)據(jù)庫名.表名的完整寫法，如 db1.accounts。

坑三：時(shí)序表插入數(shù)據(jù)時(shí)報(bào)錯(cuò) unsupported input type BinaryOperator

原因是 KWDB 不支持 now() + interval 這種二元運(yùn)算符寫法。時(shí)間戳可以使用 NOW() 函數(shù)，但不支持加法運(yùn)算。解決方法是直接使用具體的時(shí)間字符串進(jìn)行插入。

坑四：時(shí)序表中標(biāo)簽列不支持 STRING 類型

根據(jù)官方文檔，時(shí)序表的標(biāo)簽列不支持 TIMESTAMP、NVARCHAR、GEOMETRY 等數(shù)據(jù)類型。解決方法是將 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
);

六、總結(jié)與心得

從部署體驗(yàn)來看，Docker 方式的便捷度非常高，十五分鐘左右就能完成部署，比裸機(jī)安裝省事很多。官方文檔資料齊全，但部分內(nèi)容散落在不同平臺(tái)，查找時(shí)需要一些耐心。

本次實(shí)操成功驗(yàn)證了 KaiwuDB 的兩大核心能力。多模數(shù)據(jù)統(tǒng)一管理的能力，讓同一個(gè)實(shí)例可以同時(shí)存儲(chǔ)關(guān)系數(shù)據(jù)和時(shí)序數(shù)據(jù)?？缒２樵兊哪芰?，通過 SQL 直接關(guān)聯(lián)分析兩類數(shù)據(jù)，無需中間件進(jìn)行數(shù)據(jù)拼裝。

結(jié)合官方介紹，KaiwuDB 特別適合工業(yè)物聯(lián)網(wǎng)、能源電力和車聯(lián)網(wǎng)等場景。設(shè)備檔案作為關(guān)系數(shù)據(jù)，實(shí)時(shí)監(jiān)控?cái)?shù)據(jù)作為時(shí)序數(shù)據(jù)，兩類數(shù)據(jù)在同一數(shù)據(jù)庫中統(tǒng)一管理，查詢和分析都非常便捷。

后續(xù)計(jì)劃申請(qǐng)?jiān)囉?KAT 智能體工具，或者嘗試 Smart Meter Web 可視化項(xiàng)目，做更深入的應(yīng)用探索。

到此這篇關(guān)于CentOS Stream 9 服務(wù)器 Docker 部署 KaiwuDB 實(shí)戰(zhàn)指南的文章就介紹到這了,更多相關(guān)Docker 部署 KaiwuDB內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論