在知识库中专注阅读，并随时返回相关工具与课程
大家好，这里是 DBA学习之路，专注于提升数据库运维效率。 @TOC目录 今天无意间在墨天轮看到一个征文活动 征文大赛 「码」上数据库—— KWDB 2025 创作者计划启动https://www.modb.pro/db/1907050732440797184，想着参与一下支持开源，顺便了解一下新的开源时序数据库 KWDB。 写了一篇时序数据库 KWDB 的简单安装和使用，分享给大家一起看看~ K
大家好，这里是 DBA学习之路，专注于提升数据库运维效率。
本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟
今天无意间在墨天轮看到一个征文活动 征文大赛 |「码」上数据库—— KWDB 2025 创作者计划启动，想着参与一下支持开源，顺便了解一下新的开源时序数据库 KWDB。
写了一篇时序数据库 KWDB 的简单安装和使用，分享给大家一起看看~
KWDB（KaiwuDB）是一款开源的时序数据库，是浪潮集团控股的数据库企业，以多模数据库为核心，主要面向工业物联网、数字能源、交通车联网、智慧城市、数字政务等多种场景。
早在 2023.01.10 KWDB 1.0 就已经正式发布，经过一年多的孵化，目前最新版已经来到 2.1.0，可以说已经是一款比较成熟的数据库了。
KWDB 为不同角色开发者提供以下支持（包括但不限于）：
KWDB 官方资源参考：
KWDB 支持用户根据需求选择二进制安装包、容器和源码安装与试用 KWDB 数据库：
可以看到二进制安装包的方式支持的架构比较多，所以本文选择用二进制安装的方式进行部署。
本文介绍如何使用 KWDB 二进制安装包在单个节点上安装部署 KWDB。
这里本着国产数据库用国产系统，所以选择麒麟 V10 系统进行测试：
参考官方手册给出的部署 KWDB 所需的硬件规格：
实际部署时，用户可以根据实际的业务规模和性能要求规划硬件资源。
KWDB 官方已经认证的服务器操作系统：
KWDB 在安装时会对依赖进行检查，如果缺少依赖会退出安装并提示依赖缺失。不同操作系统及安装包的依赖略有不同，需要根据实际安装包类型及操作系统，在部署前安装好相应的依赖。
下表列出需要在目标机器安装的依赖：
配置本地软件源：
1## 挂载本地镜像源2[root@kwdb ~]# mount /dev/cdrom /mnt/3mount: /mnt: WARNING: source write-protected, mounted read-only.4## 备份系统初始配置文件5[root@kwdb ~]# mkdir -p /etc/yum.repos.d/bak6[root@kwdb ~]# mv /etc/yum.repos.d/* /etc/yum.repos.d/bak7## 一键配置软件源，默认 ISO 安装镜像挂载在 /mnt 目录下8[root@kwdb ~]# cat<<-EOF>/etc/yum.repos.d/local.repo9[server]10name=server11baseurl=file:///mnt12enabled=113gpgcheck=014EOF手动安装依赖：
1yum install -y protobuf2## 手动下载上传3rpm -ivh geos-3.6.1-12.ky10.x86_64.rpm检查操作系统是否已安装对应依赖：
1[root@kwdb soft]# rpm -q openssl protobuf geos xz-libs squashfs-tools libgcc util-linux2openssl-1.1.1f-31.p23.ky10.x86_643protobuf-3.14.0-7.ky10.x86_644geos-3.6.1-12.ky10.x86_645xz-libs-5.2.5-3.ky10.x86_646squashfs-tools-4.5-4.ky10.x86_647libgcc-7.3.0-2020033101.58.p01.ky10.x86_648util-linux-2.35.2-14.p03.ky10.x86_64确保所有的依赖都已成功安装。
在安装部署前，确保目标机器的以下端口没有被占用且没有被防火墙拦截。在安装部署时，用户可以修改 deploy.cfg 文件中的端口配置参数。
下表列出 KWDB 服务需要映射的端口：
建议关闭防火墙：
1[root@kwdb ~]# systemctl stop firewalld.service 2[root@kwdb ~]# systemctl disable firewalld.service 3Removed /etc/systemd/system/multi-user.target.wants/firewalld.service.4Removed /etc/systemd/system/dbus-org.fedoraproject.FirewallD1.service.在 gitee 上下载对应的二进制安装包：
将安装包复制到待安装 KWDB 的目标机器上，然后解压缩安装包：
1[root@kwdb soft]# ll2总用量 279563-rw-r--r-- 1 root root 28625639 3月 18 13:35 KWDB-2.1.0-kylinV10_2403-x86_64-rpms.tar.gz4[root@kwdb soft]# tar -xf KWDB-2.1.0-kylinV10_2403-x86_64-rpms.tar.gz 5[root@kwdb soft]# cd kwdb_install/解压后生成的目录包含以下文件：
1[root@kwdb kwdb_install]# tree -N2.3├── add_user.sh ## 安装、启动 KWDB 后，为 KWDB 数据库创建用户4├── deploy.cfg ## 安装部署配置文件，用于配置部署节点的 IP 地址、端口等配置信息5├── deploy.sh ## 安装部署脚本，用于安装、卸载、启动、状态获取、关停和重启等操作6├── packages ## 存放 DEB、RPM 和镜像包7│ ├── kwdb-libcommon-2.1.0-kylin.ky10.x86_64.rpm8│ └── kwdb-server-2.1.0-kylin.ky10.x86_64.rpm9└── utils ## 存放工具类脚本10 ├── container_shell.sh11 ├── kaiwudb_cluster.sh12 ├── kaiwudb_common.sh13 ├── kaiwudb_hardware.sh14 ├── kaiwudb_install.sh15 ├── kaiwudb_log.sh16 ├── kaiwudb_operate.sh17 ├── kaiwudb_uninstall.sh18 ├── kaiwudb_upgrade.sh19 ├── process_bar.sh20 └── utils.sh21222 directories, 16 files至此，环境准备完成，接下来可以开始部署 KWDB。
部署 KWDB 时，系统将对配置文件、运行环境、硬件配置和软件依赖进行检查。
在部署过程中，系统会自动生成相关日志。如果部署时出现错误，用户可以通过查看终端输出或 KWDB 安装目录中 log 目录里的日志文件，获取详细的错误信息。
部署完成后，系统会将 KWDB 封装成系统服务（名称为 kaiwudb），并生成以下文件：
kaiwudb.service：配置 KWDB 的 CPU 资源占用率。kaiwudb_env：配置 KWDB 启动参数。安装用户为 root 用户或者拥有 sudo 权限的普通用户。
登录待部署节点，编辑安装包目录下的 deploy.cfg 配置文件，设置安全模式、管理用户、服务端口等信息：
1## 默认情况下，deploy.cfg 配置文件中包含集群配置参数，需要删除或注释 [cluster] 集群配置项。2[root@kwdb kwdb_install]# cat<<-EOF>/soft/kwdb_install/deploy.cfg3[global]4secure_mode=insecure5management_user=kaiwudb6rest_port=80807kaiwudb_port=262578data_root=/var/lib/kaiwudb9cpu=110[local]11node_addr=192.168.6.7912EOF参数说明：
global：全局配置
secure_mode：是否开启安全模式，支持以下两种取值：
insecure：使用非安全模式。tls：（默认选项）开启 TLS 安全模式。开启安全模式后，KaiwuDB 生成 TLS 证书，作为客户端或应用程序连接数据库的凭证，生成的客户端相关证书存放在 /etc/kaiwudb/certs 目录。management_user：KaiwuDB 的管理用户，默认为 kaiwudb。安装部署后，KaiwuDB 创建相应的管理用户以及和管理用户同名的用户组。rest_port：KaiwuDB Web 服务端口，默认为 8080。kaiwudb_port：KaiwuDB 服务端口，默认为 26257。data_root：数据目录，默认为 /var/lib/kaiwudb。cpu: 可选参数，用于指定 KaiwuDB 服务占用当前节点服务器 CPU 资源的比例，默认无限制。取值范围为 [0,1]，最大精度为小数点后两位。local：本地节点配置
node_addr：本地节点对外提供服务的 IP 地址，监听地址为 0.0.0.0，端口为 KaiwuDB 服务端口。为 deploy.sh 脚本添加运行权限：
1[root@kwdb kwdb_install]# chmod +x deploy.sh安装过程中需要输入 kaiwudb 用户密码，复杂度参考操作系统，不符合复杂度会报错退出安装。如果没有密码复杂性要求，不想设置密码太复杂的话，可以取消密码复杂度：
1[root@kwdb kwdb_install]# sed -i 's/^password\+[[:space:]]\+requisite[[:space:]]\+pam_pwquality.so/#&/g' /etc/pam.d/system-auth2[root@kwdb kwdb_install]# sed -i 's/use_authtok$//' /etc/pam.d/system-auth执行单机部署安装命令：
1[root@kwdb kwdb_install]# ./deploy.sh install --single2## 这里需要输入 kaiwudb 用户的密码，输完之后记得保留密码执行成功后，控制台输出以下信息：
1[INSTALL COMPLETED]:KaiwuDB has been installed successfully! To start KaiwuDB, please execute the command 'systemctl daemon-reload'.根据系统提示重新加载 systemd 守护进程的配置文件：
1[root@kwdb kwdb_install]# systemctl daemon-reload启动 KWDB 节点：
1[root@kwdb kwdb_install]# ./deploy.sh start2[START COMPLETED]:KaiwuDB start successfully.执行成功后，控制台输出以上信息。
查看 KWDB 节点状态：
1[root@kwdb kwdb_install]# ./deploy.sh status2[STATUS COMPLETED]:KaiwuDB is runnning now.34[root@kwdb kwdb_install]# systemctl status kaiwudb5● kaiwudb.service - KaiwuDB Service6 Loaded: loaded (/etc/systemd/system/kaiwudb.service; disabled; vendor preset: disabled)7 Active: active (running) since Tue 2025-03-18 14:21:11 CST; 49s ago8 Process: 40587 ExecStartPre=/usr/bin/sudo /usr/sbin/sysctl -w vm.max_map_count=10000000 (code=exited, status=0/SUCCESS)9 Main PID: 40598 (kwbase)10 Tasks: 4111 Memory: 477.1M12 CGroup: /system.slice/kaiwudb.service13 └─40598 /usr/local/kaiwudb/bin/kwbase start-single-node --insecure --listen-addr=0.0.0.0:26257 --advertise-addr=192.168.6.79:26257 --http-addr=0.0.0.0:8080 --store=/var/lib/kaiwudb14153月 18 14:21:13 kwdb kwbase[40598]: sql: postgresql://root@192.168.6.79:26257?sslmode=disable163月 18 14:21:13 kwdb kwbase[40598]: RPC client flags: /usr/local/kaiwudb/bin/kwbase <client cmd> --host=192.168.6.79:26257 --insecure173月 18 14:21:13 kwdb kwbase[40598]: logs: /var/lib/kaiwudb/logs183月 18 14:21:13 kwdb kwbase[40598]: temp dir: /var/lib/kaiwudb/kwbase-temp492528165193月 18 14:21:13 kwdb kwbase[40598]: external I/O path: /var/lib/kaiwudb/extern203月 18 14:21:13 kwdb kwbase[40598]: store[0]: path=/var/lib/kaiwudb213月 18 14:21:13 kwdb kwbase[40598]: storage engine: rocksdb223月 18 14:21:13 kwdb kwbase[40598]: status: initialized new cluster233月 18 14:21:13 kwdb kwbase[40598]: clusterID: 532f74b0-03a7-4921-839b-5132f10644cf243月 18 14:21:13 kwdb kwbase[40598]: nodeID: 1配置 KWDB 开机自启动：
1[root@kwdb kwdb_install]# systemctl enable kaiwudb2Created symlink /etc/systemd/system/multi-user.target.wants/kaiwudb.service → /etc/systemd/system/kaiwudb.service.配置 KWDB 开机自启动后，如果系统重启，则自动启动 KWDB。
1[kaiwudb@kwdb ~]$ kwbase sql --insecure --host=192.168.6.792#3# Welcome to the KWDB SQL shell.4# All statements must be terminated by a semicolon.5# To exit, type: \q.6#7# Server version: KaiwuDB 2.1.0 (x86_64-linux-gnu, built 2024/11/22 12:14:25, go1.16.15, gcc 7.3.0) (same version as client)8# Cluster ID: 532f74b0-03a7-4921-839b-5132f10644cf9#10# Enter \? for a brief introduction.11#12root@192.168.6.79:26257/defaultdb> show database;13 database14-------------15 defaultdb16(1 row)1718Time: 795.282µs1-- 创建一个名称为 tsdb 的时序库，数据保存周期为 90 天2root@192.168.6.79:26257/defaultdb> CREATE TS DATABASE tsdb RETENTIONS 90d;3CREATE TS DATABASE45Time: 8.576464ms67root@192.168.6.79:26257/defaultdb> SHOW DATABASES;8 database_name | engine_type9----------------+--------------10 defaultdb | RELATIONAL11 postgres | RELATIONAL12 system | RELATIONAL13 tsdb | TIME SERIES14(4 rows)1516Time: 1.913474ms1718root@192.168.6.79:26257/defaultdb> USE tsdb;1920SET2122Time: 1.011287ms1-- 创建一个名称为 testu 的用户，授予其 tsdb 数据库的所有权限2CREATE USER testu;3GRANT ALL ON DATABASE tsdb to testu;4SHOW USERS;在 tsdb 数据库中创建名为 readings 的时序表，存储温度和湿度数据，并使用传感器 ID 和位置作为标签：
1root@192.168.6.79:26257/defaultdb> use tsdb;2SET34Time: 990.008µs56root@192.168.6.79:26257/tsdb> CREATE TABLE tsdb.readings (7 ts timestamp NOT NULL, -- 数据读取时间戳8 temperature FLOAT, -- 温度（摄氏度）9 humidity FLOAT -- 湿度（百分比）10) TAGS (11 sensor_id INT NOT NULL, -- 传感器 ID12 location CHAR(256) NOT NULL -- 传感器位置（如 "Room 101"）13) PRIMARY TAGS(sensor_id);14CREATE TABLE1516Time: 69.114769ms向 readings 时序表中写入数据：
1root@192.168.6.79:26257/tsdb> INSERT INTO tsdb.readings 2VALUES 3(NOW(), 23.0, 59.5, 101, 'Room 101'),4(NOW(), 23.5, 58.9, 102, 'Room 102'),5(NOW(), 19.8, 65.5, 103, 'Room 103');6INSERT 378Time: 18.171494ms查询 readings 时序表中的数据：
1root@192.168.6.79:26257/tsdb> SELECT * FROM readings;2 ts | temperature | humidity | sensor_id | location3-------------------------------+-------------+----------+-----------+-----------4 2025-03-18 07:13:53.75+00:00 | 23 | 59.5 | 101 | Room 1015 2025-03-18 07:13:53.75+00:00 | 23.5 | 58.9 | 102 | Room 1026 2025-03-18 07:13:53.75+00:00 | 19.8 | 65.5 | 103 | Room 1037(3 rows)89Time: 2.194378ms查看已创建的表结构：
1root@192.168.6.79:26257/tsdb> SHOW CREATE TABLE readings;2 table_name | create_statement3-------------+------------------------------------------------------------4 readings | CREATE TABLE readings (5 | ts TIMESTAMPTZ NOT NULL,6 | temperature FLOAT8 NULL,7 | humidity FLOAT8 NULL8 | ) TAGS (9 | sensor_id INT4 NOT NULL,10 | location CHAR(256) NOT NULL ) PRIMARY TAGS(sensor_id)11(1 row)1213Time: 236.503887ms到这， KaiwuDB 的单机安装就完成了。