KaiwuDB V3.0 环境部署与快速上手:安装、配置与性能测试指南

KaiwuDB V3.0 环境部署与快速上手:安装、配置与性能测试指南

前言

物联网时代数据呈指数级增长、场景复杂多变,对数据库的适应与进化能力提出高要求。全新发布的KaiwuDB V3.0集时序处理、多模融合等核心能力于一体,为企业提供高性能、高可靠、低成本的一站式数据管理解决方案,助力应对物联网数据管理挑战、实现降本增效与业务创新。

KWDB 环境部署(前置依赖与配置)

搭建 KWDB 基础环境的标准化操作步骤,包含命令说明、执行注意事项及验证方式,确保环境配置准确可复现
1、更新本地的软件包索引列表(同步系统软件源的最新包信息,确保后续安装的软件为最新稳定版)

bash 复制代码
sudo apt update

2、安装 CMake 构建工具(安装跨平台的项目构建工具 CMake,用于编译 KWDB 相关源码)

bash 复制代码
sudo apt install cmake
  • 验证安装
bash 复制代码
cmake --version  # 输出cmake版本号表示成功

3、安装 Go 语言运行环境(通过 Snap 包管理器安装最新版 Go 语言,满足 KWDB 的 Go 代码运行需求)

bash 复制代码
sudo snap install go --classic
  • 验证安装
bash 复制代码
go version  # 输出go版本号表示成功

4、安装 Protobuf 开发库(安装 Protobuf协议缓冲区C/C++ 开发库,支持 KWDB 的序列化、反序列化功能)

bash 复制代码
apt install libprotobuf-dev

KWDB源码下载

1、查看系统Ubuntu版本

bash 复制代码
lsb_release -a

2、进入kwdb的gitee下载列表页面

kwdb 发行版 - Gitee.com

bash 复制代码
wget https://gitee.com/kwdb/kwdb/releases/download/V3.0.0/KWDB-3.0.0-ubuntu22.04-x86_64-debs.tar.gz

3、weget下载编译好的kwdb压缩包

复制代码
wget https://gitee.com/kwdb/kwdb/releases/download/V3.0.0/KWDB-3.0.0-ubuntu22.04-x86_64-debs.tar.gz

4、查看是否下载成功

bash 复制代码
ls

5、解压压缩包

bash 复制代码
tar zxvf KWDB-3.0.0-ubuntu22.04-x86_64-debs.tar.gz

6、进入到kwdb

bash 复制代码
cd kwdb_install/

7、修改deploy.cfg配置文件

bash 复制代码
vi deploy.cfg
  • node_addr修改成自己的公网ip地址
  • secure_mode=off
bash 复制代码
[global]
# Whether to turn on secure mode
secure_mode=tls
# Management KaiwuDB user
management_user=kaiwudb
# KaiwuDB cluster http port
rest_port=8080
# KaiwuDB service port
kaiwudb_port=26257
# KaiwuDB brpc port
brpc_port=27257
# KaiwuDB data directory
data_root=/var/lib/kaiwudb
# CPU usage[0-1]
# cpu=1
[local]
# local node configuration
node_addr=120.55.72.198
# section cluster is optional
#[cluster]
# remote node addr,split by ','
#node_addr=127.0.0.2,127.0.0.3
# ssh info
#ssh_port=22
#ssh_user=admin

8、配置go环境变量,避免依赖冲突(关闭 Go 语言的 Module 模块功能,强制 Go 回到传统的 GOPATH 模式下工作)

bash 复制代码
vi ~/.bashrc
bash 复制代码
export GO111MODULE=off

9、/etc/profile关闭go版本冲突

bash 复制代码
vi /etc/profile
复制代码
export GO111MODULE=off

10、使变量设置立即生效

  • 个人用户设置:

    bash 复制代码
    source ~/.bashrc                           
  • 系统全局设置:

    bash 复制代码
    source /etc/profile   

KWDB 安装与服务管理

1、安装kwdb

复制代码
./deploy.sh install --single
  • 报错一:KWDB 安装包 kwdb-server 依赖 libgflags2.2 库但该库未安装,导致 dpkg 配置失败

2、安装libgflags2.2

bash 复制代码
sudo apt install -y libgflags2.2

3、重新安装

bash 复制代码
./deploy.sh install --single

4、重新加载配置文件

bash 复制代码
systemctl daemon-reload

5、启动 KWDB 系统服务

复制代码
systemctl start kaiwudb.service

6、查看 KWDB 服务的运行状态

bash 复制代码
systemctl status kaiwudb.service

7、ECS服务器开启端口26257

8、启动数据库

bash 复制代码
/usr/local/kaiwudb/bin/kwbase sql --host=120.55.72.198:26257 --certs-dir=/etc/kaiwudb/certs

KWDB SQL Shell 常用命令

1、查看所有数据库

SQL 复制代码
SHOW DATABASES;

2、查看当前正在使用的数据库

SQL 复制代码
SELECT current_database();

常用 DDL/DML 示例(表结构与 CRUD)

创建基础表
sql 复制代码
-- 方式1:用SERIAL(KWDB 3.0.0最兼容,推荐)
CREATE TABLE user_info (
  id SERIAL PRIMARY KEY, 
  name VARCHAR(50) NOT NULL,         
  age INT,                            
  city VARCHAR(50)                    
);

-- 验证表创建成功
SHOW TABLES;
新增(INSERT)插入数据
sql 复制代码
-- 单条插入(id无需赋值,自动自增)
INSERT INTO user_info (name, age, city) VALUES ('张三', 25, '北京');

-- 批量插入
INSERT INTO user_info (name, age, city) 
VALUES 
  ('李四', 30, '上海'),
  ('王五', 28, '广州'),
  ('赵六', 32, '深圳');

-- 验证插入结果
SELECT * FROM user_info;
查询(SELECT)读取数据
sql 复制代码
-- 查所有数据
SELECT * FROM user_info;

-- 条件查询(年龄>28)
SELECT name, age FROM user_info WHERE age > 28;

-- 模糊查询(名字含"张")
SELECT * FROM user_info WHERE name LIKE '%张%';

-- 排序查询(按年龄降序)
SELECT * FROM user_info ORDER BY age DESC;
修改(UPDATE) 更新数据
sql 复制代码
-- 修改张三的年龄
UPDATE user_info SET age = 26 WHERE name = '张三';

-- 修改上海用户的年龄
UPDATE user_info SET age = age + 1 WHERE city = '上海';

-- 验证修改结果
SELECT * FROM user_info;
删除(DELETE)删除数据
sql 复制代码
-- 删除赵六的记录
DELETE FROM user_info WHERE name = '赵六';

-- 删除年龄<28的用户
DELETE FROM user_info WHERE age < 28;

-- 验证删除结果
SELECT * FROM user_info;

性能测试:批量写入与并发读取基准

批量插入性能:测试 KWDB 写入数据的吞吐量

并发查询性能:测试 KWDB 读取数据的响应能力;

基于已创建的 user_info表

准备工作:创建测试专用表
sql 复制代码
-- 创建性能测试表
CREATE TABLE perf_test (
  id SERIAL PRIMARY KEY,
  test_val VARCHAR(100),
  create_ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
插入数据测试
sql 复制代码
INSERT INTO perf_test (test_val)
SELECT 'test_' || CAST(generate_series(1, 1000) AS VARCHAR);
验证插入结果
sql 复制代码
SELECT COUNT(*) FROM perf_test;
批量插入10000条数据
sql 复制代码
INSERT INTO perf_test (test_val)
SELECT 'batch_' || CAST(generate_series(1, 10000) AS VARCHAR);
验证总数据量

执行的查询返回11000,且耗时仅 9.39ms,说明KWDB 的批量插入性能和基础查询性能都表现优秀

sql 复制代码
SELECT COUNT(*) FROM perf_test;

总结

本文为 KaiwuDB V3.0 在 Ubuntu 下的快速部署与使用指南,涵盖依赖安装、配置修改、单节点部署、服务启动、SQL 基础操作及批量读写性能测试,展示其部署简便、兼容标准 SQL、批量数据处理性能优异的特点,适合物联网时序数据场景快速落地。

相关推荐
想你依然心痛8 天前
深度实战:KWDB跨模查询在智能电网监控系统中的落地实践
时序数据库·智能电网·kwdb·跨模查询·数据库实战
banjin1 个月前
轻量化时序数据库新选择:KaiwuDB-Lite 实战体验
数据库·oracle·边缘计算·时序数据库·kaiwudb·kwdb
度假的小鱼9 个月前
【KWDB 创作者计划】_探秘浪潮KWDB数据库:从时间索引到前沿技术
数据库·kwdb
banjin9 个月前
【KWDB 2025 创作者计划】_KWDB时序数据库特性及跨模查询
数据库·时序数据库·kwdb
国服第二切图仔9 个月前
【KWDB 创作者计划】一文掌握KWDB的时序表管理
数据库·kwdb
度假的小鱼9 个月前
【KWDB 创作者计划】_Ubuntu 22.04系统KWDB数据库安装部署使用教程
kwdb
KaiwuDB9 个月前
KaiwuDB X 遨博智能 | 构建智能产线监测管理新系统
大数据·数据库·kaiwudb·分布式多模数据库
小黄人202510 个月前
【KWDB 创作者计划】一款面向 AIoT 的多模数据库实战体验
数据库·云计算·kwdb
倔强的石头10610 个月前
【KWDB 创作者计划】_本地化部署与使用KWDB 深度实践
kwdb