KWDB一键部署全攻略

于 2025-07-25 14:59:08 发布
阅读量6 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： KWDB 2025 创作者计划 文章标签： 数据库
原文链接：https://mp.weixin.qq.com/s/DdLyvMVZO8Ttq0BT-3uqNg

作者：青学会会长

原文链接：https://mp.weixin.qq.com/s/DdLyvMVZO8Ttq0BT-3uqNg

在当前国产化替代的大背景下，国产数据库的应用越来越广泛。今天，我们将为大家介绍一款面向AIoT场景的国产开源分布式多模数据库——KWDB，并详细讲解如何在麒麟操作系统上一键安装KWDB单机版数据库。

在这里插入图片描述

KWDB数据库简介

KWDB（KaiwuDB社区版）是由开放原子开源基金会孵化及运营的开源项目，是一款面向AIoT（人工智能物联网）场景的分布式多模数据库产品。作为国产自主研发的多模数据库，KWDB以其强大的性能和灵活的功能，正逐渐成为国内数据库领域的新星。

KWDB的核心定位

KWDB是一款开源的多模数据库，由浪潮集团控股的数据库企业主导开发。它以多模架构、时序数据处理为核心，主要面向工业物联网、数字能源、交通车联网、智慧城市、数字政务等多种场景提供专业的数据存储和处理解决方案。自2024年8月由KaiwuDB 2.0 正式开源而来，经过近一年的孵化，目前最新版本已经发展到2.2.0，可以说已经是一款比较成熟的数据库了。

KWDB的技术特点

KWDB具备以下几个突出的技术特点：

  • 多模数据融合处理：支持在同一实例同时建立时序库和关系库，并能够融合处理多种模型的数据，满足复杂业务场景需求。

  • 高性能数据处理能力：具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，适合大规模IoT应用场景。

  • 稳定安全：提供完善的安全机制，支持TLS安全模式连接和认证方式，保障数据安全。

  • 高可用性：具备完善的集群部署和故障恢复机制，确保业务连续性。

  • 易于运维：提供简单直观的部署和管理工具，降低运维复杂度。

  • 丰富的接口支持：提供JDBC、ODBC、RESTful API等多种接口，方便与各类应用系统集成。

KWDB的应用场景

KWDB特别适合以下应用场景：

  • 工业物联网：处理大量传感器数据，支持实时监控和分析。

  • 数字能源：能源设备监控、能耗分析和预测。

  • 交通车联网：车辆数据采集、路况分析和智能调度。

  • 智慧城市：城市基础设施监控、环境数据分析。

  • 数字政务：政务数据整合、分析和共享。

KWDB的部署方式

KWDB支持多种部署方式，包括：

  • 单节点裸机部署：适合测试环境或小规模应用场景。

  • 集群部署：适合生产环境，提供高可用性和扩展性。

  • 容器部署：支持Docker容器化部署，便于云环境使用。

对于初次接触KWDB的用户，单节点裸机部署是最简单直接的方式，特别是在麒麟操作系统环境下，KWDB提供了一键安装脚本，大大简化了部署过程。

麒麟系统一键安装KWDB单机数据库

介绍如何在麒麟操作系统上一键安装KWDB单机版数据库。通过以下步骤，您可以快速部署并开始使用这款强大的国产时序数据库。

环境准备

硬件要求

在安装KWDB之前，请确保您的服务器满足以下基本硬件要求：

  • CPU：建议4核及以上

  • 内存：建议16GB及以上

  • 磁盘：建议150GB及以上（根据实际数据量调整）

操作系统要求

KWDB支持多种国产操作系统，本文以麒麟操作系统为例：

  • 推荐使用：KylinOS V10 SP3 2403版本

系统配置

在安装KWDB之前，需要进行以下系统配置：

1. 关闭防火墙

systemctl stop firewalld.service
systemctl disable firewalld.service

2. 关闭SELinux

sed -i 's/^SELINUX=enforcing$/SELINUX=disabled/' /etc/selinux/config
setenforce 0
# 需要重启系统使配置生效

3. 配置hosts文件

假设您的服务器IP为10.10.10.190，主机名为kwdb：

cat >>/etc/hosts<<EOF
192.168.70.222 kwtest
EOF

4. 创建数据库管理用户

useradd kaiwudb
echo "kaiwudb" | passwd --stdin kaiwudb

5. 安装依赖包

在麒麟操作系统上，KWDB依赖以下软件包：

yum -y install protobuf geos

下载与安装KWDB

1. 获取安装包

您可以从KWDB的官方Gitee仓库下载适合麒麟操作系统的安装包： https://gitee.com/kwdb/kwdb

对于KylinOS V10 SP3 2403版本 ，请下载对应的安装包：KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz

2. 解压安装包

将下载好的安装包上传到服务器后，执行以下命令解压：

mkdir -p /soft
--上传文件，解压
tar -xvf KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz

3. 修改配置文件

进入解压后的安装目录，修改配置文件：

cd kwdb_install/
vi ./deploy.cfg

[global]
secure_mode=tls
management_user=kaiwudb
rest_port=8080
kaiwudb_port=26257
data_root=/var/lib/kaiwudb

[local]
node_addr=192.168.70.222

请根据实际情况修改以下参数：

  • secure_mode：安全模式，可选值为tls或insecure

  • management_user：管理用户名

  • rest_port：REST API端口

  • kaiwudb_port：数据库服务端口

  • data_root：数据存储根目录

  • node_addr：节点IP地址（您的服务器IP）

4. 一键安装KWDB

执行以下命令开始安装：

./deploy.sh install --single

安装过程中，系统会提示输入kaiwudb用户的密码，请输入之前设置的密码。

5. 启动数据库服务

安装完成后，执行以下命令启动数据库服务：

./deploy.sh start

6. 检查数据库运行状态

执行以下命令检查数据库是否正常运行：

./deploy.sh status

或者使用systemctl命令查看服务状态：

systemctl status kaiwudb

如果看到类似以下输出，说明数据库已成功启动：

● kaiwudb.service - KaiwuDB Service
   Loaded: loaded (/etc/systemd/system/kaiwudb.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2025-03-18 14:21:11 CST; 49s ago

7. 配置开机自启动

如果需要数据库在系统重启后自动启动，可以执行：

systemctl enable kaiwudb

创建数据库用户（可选）

默认情况下，系统使用root用户且无需密码访问数据库。如果需要创建新用户，可以执行：


./add_user.sh

按照提示输入用户名和密码即可。

连接数据库

使用命令行工具连接

安装完成后，可以使用以下命令连接数据库：

安全模式连接（如果配置了TLS）

kwbase sql --certs-dir=/etc/kaiwudb/certs --host=192.168.70.222 -u root

在这里插入图片描述

常见问题与解决方案

1. 安装过程中遇到依赖问题

如果安装过程中提示缺少依赖包，请使用以下命令安装：

yum -y install protobuf geos

2. 无法连接数据库

如果配置了TLS安全模式但使用非安全模式连接，会出现连接失败。请确认：

  • 使用正确的连接参数（安全模式或非安全模式）

  • 检查防火墙是否已关闭

  • 确认数据库服务是否正常运行

3. 权限问题

如果遇到权限相关错误，请检查：

  • kaiwudb用户是否正确创建

  • 数据目录权限是否正确

通过文章的介绍，我们了解了KWDB这款国产开源多模数据库的核心特点和应用场景，并详细讲解了如何在麒麟操作系统上一键安装KWDB单机版数据库。KWDB作为一款面向AIoT场景的分布式多模数据库，具有高性能、易部署、易使用的特点，非常适合各类物联网应用场景。

希望本文能够帮助您快速上手KWDB数据库，为您的国产化替代之路提供有力支持。如需了解更多高级功能，请参考KWDB官方文档。

参考资料

KWDB官方文档：https://www.kaiwudb.com/kaiwudb_docs/

KWDB官方代码仓库：https://gitee.com/kwdb/kwdb

博客
KaiwuDB 2.1.0 单节点裸机部署
07-25 23
KWDB（KaiwuDB）是一款开源的时序数据库，是浪潮集团控股的数据库企业，以多模数据库为核心，主要面向工业物联网、数字能源、交通车联网、智慧城市、数字政务等多种场景。为开发者提供通用连接接口，具备高速写入、极速查询、SQL 支持、随需压缩、数据生命周期管理、集群部署等特性，与第三方工具无缝集成，降低开发及学习难度，提升开发使用效率。早在 2023.01.10 KWDB 1.0 就已经正式发布，经过一年多的孵化，目前最新版已经来到 2.1.0，可以说已经是一款比较成熟的数据库了。
博客
开赛 | KWDB 核心贡献挑战赛，30万奖金池等你来瓜分！
07-25 173
我们希望通过对 KWDB 数据库的社区贡献、开源创新，推动数据库领域的技术发展与落地实践，为更多的用户赋能，打造更广泛的数据库生态。• 国内镜像：swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/kwdb/kwdb:latest。• 国内 Docker 镜像仓库：https://docker.aityp.com/r/docker.io/kwdb。• Github 镜像仓库：https://github.com/orgs/KWDB/packages。
博客
KWDB多副本集群保姆级部署
07-24 4
单节点异常：如果单个节点因网络断开、延迟、操作系统故障、磁盘故障等原因导致节点状态变为异常（is_available 和 is_live 均为 false），系统会开始迁移该节点的 leaseholder，迁移期间数据查询和 DML 操作可能受影响，DDL 操作可能会报错，生命周期会顺延至下一执行周期执行。如果剩余节点数量仍大于副本数，系统自动补足缺失的副本，确保数据的高可用性、副本补足期间，数据查询不受影响，DML 操作不受影响，DDL 操作可能会报错，副本补足后，DDL 操作恢复正常。
博客
直播预告 | KWDB 分布式架构探究
07-24 276
快动手预约直播，抢占技术高地！大咖专场来袭 图片图片图片。《KW 加油站》第五期。
博客
就在今天，来开源生态大会和 KWDB 一起「玩转开源」！
07-23 175
KWDB 自开源以来，已陆续牵手包括华师大、南开大学、重庆大学、天津大学等多所重点高校，把真实的数据库技术带进课堂，让学生们不再只学“课本知识”，而是动手参与真正的开源项目！我们不仅会有专业技术老师驻扎展台现场，同时也特地为大家准备了各种限量周边，数量有限，先冲先得 🙋~AI 不仅显著提升了数据库的智能运维水平，实现自动化管理的新突破，更对数据库系统的能力边界提出了全新挑战。以“开源赋能产业 生态共筑未来”为主题，大会将聚合全球开源智慧，联动政企产学研用多方力量，带来从技术实践到生态建设的全维度分享。
博客
KWDB 2.2.2 版本发布，修复产品典型问题，优化系统性能和稳定性
07-23 303
基于浪潮 KaiwuDB 开源，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。典型应用场景包括但不限于物联网、能源电力、交通车联网等，旨在为各行业领域提供一站式数据存储、管理与分析的基座，助力企业数智化建设，以更低的成本挖掘更大的数据价值。单副本集群：支持 KWDB 2.2.x 离线升级至 KWDB 2.2.2。修复 where 条件中公元前时间在不同条件下处理逻辑不一致问题。
博客
Ubuntu 22.04系统KWDB数据库安装部署使用教程_案例传感器
07-22 46
作者：度假的小鱼原文链接：https://blog.youkuaiyun.com/u014096024/article/details/147722433?spm=1001.2014.3001.5502KWDB 是由开放原子开源基金会孵化及运营的开源项目，是一款面向 AIoT 场景的分布式多模数据库产品，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。KWDB 基于浪潮 KaiwuDB 分布式多模
博客
KWDB单节点裸机试玩
07-18 35
经过对/etc/sysctl.conf（包含sysctl.d/下）和/etc/security/limits.conf（包含limits.d/下）均为变更，在生产环境中是否会对数据库运行造成影响，官方文档并没有明确说明，希望改进。这里无论是在Gitee还是官方文档中，都没有关于/etc/sysctl.conf和/etc/security/limits.conf，暂且把相关配置留下，看后面安装过程是否会遇到问题。官方文档小问题比较多，包括但不限于内容错误、表达不明确或未提醒等，希望检查并修正。
博客
浪潮 KWDB 初体验
07-18 47
KaiwuDB 提供强大的实时计算、事务处理、交互查询等能力，通过实时数据预测分析为企业提供准确的调峰调频等方案，通过实时数据的监测预警保障企业安全，实现能源数据的采集、存储、治理、计算分析与应用。车联网 KaiwuDB 具备构建时序数据引擎的能力，将车端采集的车传感器数据、车辆中控状态数据、发动机数据等时序类数据，通过 MQTT 和移动通信网络高速写入到 KaiwuDB，然后经过网关汇聚到 KaiwuDB 数据库后进行存储、管理、计算、分析，服务上层的业务系统。在部署过程中，系统会自动生成相关日志。
博客
KWDB时序数据库特性及跨模查询
07-18 38
当生命周期的取值小于分区时间范围的取值时，即使数据库的生命周期已到期，由于数据存储在当前分区中，用户仍然可以查询数据。数据库的类型多种多样，关系型数据库、时序型数据库、非关系型数据库、内存数据库、分布式数据库、图数据库等等，每种类型都有其特定的使用场景和优势，KaiwuDB 是一款面向 AIoT 场景的分布式、多模融合、支持原生 AI 的数据库产品，支持同一实例同时建立时序库和关系库并融合处理多模数据，具备时序数据高效处理能力，kwdb支持关系数据库和时序数据库之间跨模检索相关的数据。
博客
权威认可！KaiwuDB 连续三年入选信通院数据库产业图谱
07-17 572
同时，基于 KaiwuDB 在工业物联网、数字能源、智慧交管、数字政务等关键行业复杂场景中的应用探索、性能优化方案、高可用实践经验，精准反映当前数据库在迁移适配、生态建设、人才储备方面的共性挑战，及以开源社区建设、开源生态共荣为核心的应对策略。深入分析分布式、云原生、AI 融合、多模处理、存算分离等前沿技术方向，并提炼关键应用场景与最佳实践，为业务选型提供借鉴价值，因而被视为国内数据库产业的“风向标”与“白皮书”。围绕工业实时数据场景拓展深度应用，通过兼容认证、技术开源构建开放共赢的生态。
博客
实操体验 - KWDB分布式多模数据库深度探索：高效部署安装指南与TSBS性能压测技巧全攻略
07-15 34
将tsbs_load_kwdb生成的结果数据，刷选出每秒导入的数据量，可以看到实时的走势图，经过与Grafana 查看指标数据SQL Queries的走势是可以成正比的，另外，也可以参考其它的一些指标数据，这里温馨提示一下，如果使用大数据量测试时，先把硬盘扩冲一下，不过，ECS上扩容云硬盘也比较方便。TSBS作为一个性能基准测试平台，TSBS 具有便捷、易用、扩展灵活等特点，通常可以模拟处理海量、高频率、实时性强的时间序列数据，可以很好的针对数据库的性能和可靠性进行测试。”就是表示安装成功了。
博客
Python 语言连接并操作 KWDB 数据库
07-15 17
纯命令行操作数据还是非常的麻烦的，且没有办法进行各类批量操作，那么本文就围绕着 Python 语言对 KWDB 数据库做链接以及 CRUD 操作做一个具体的讲解，操作的前提是环境，故而还需要对环境做出妥当的部署，否则是无法正常运行我们的代码的。我这里操作的都是时序数据的操作，所以操作过程与传统的数据库区别还是很清晰的，竟然没有看到唯一的 id，其实唯一的 id 用的是时间戳来锚定的，在环境上我们对齐颗粒度，在操作上我们需要反复测试几回才能更好的适应时序数据库的具体代码操作。每条消耗还是有些许增加的。
博客
关于 KWDB 数据存储的几件事儿
07-15 13
从 关系引擎到专门的时序存储引擎，KWDB 为不同数据类型提供了强大的存储和查询能力，并创新性的提出了关系和时序的跨模查询。KWDB 基于浪潮 KaiwuDB 分布式多模数据库研发开源，典型应用场景包括但不限于物联网、能源电力、交通车联网、智慧政务、IT 运维、金融证券等，旨在为各行业领域提供一站式数据存储、管理与分析的基座，助力企业数智化建设，以更低的成本挖掘更大的数据价值。每个实体组包含一个用于识别和查找实体的标签表，管理用于组织实体的子组集合，基于时间处理数据分区，协调跨分区的数据操作。
博客
Oracle11g整库迁移至KaiwuDB
07-14 44
DataX 是阿里巴巴集团内被广泛使用的离线数据同步工具/平台，实现包括 MySQL、SQL Server、Oracle、PostgreSQL、HDFS、Hive、HBase、OTS、ODPS 等各种异构数据源之间高效的数据同步功能。DataX本身作为数据同步框架，将不同数据源的同步抽象为从源头数据源读取数据的Reader插件，以及向目标端写入数据的Writer插件，理论上DataX框架可以支持任意数据源类型的数据同步工作。
博客
MySQL数据库迁移至KWDB的完整实践指南
07-14 51
本次从 MySQL 到 KaiwuDB（KWDB）的数据迁移实践，整体过程平稳高效，充分体现了 KaiwuDB 在异构数据库兼容和性能方面的优势。KaiwuDB 基于 DataX 开发了数据库迁移工具 KaiwuDB DataX Utils，实现 KaiwuDB（2.0.3 及以上版本）与 MySQL、TDengine、MongoDB、InfluxDB、OpenTSDB、Oracle、PostgreSQL、ClickHouse、KaiwuDB（1.2.x）、KaiwuDB（2.x）等数据库的离线数据同步。
博客
Python语言——万数据插入测试
07-11 43
在 Python 实现的万条数据插入测试中，插入 10000 条数据耗时 496.45 秒，相对时间消耗较多，这表明在大规模数据插入场景下，KWDB 对关系型数据的操作性能还有待进一步优化。再后面使用时序型数据库做插入测试，效果为 10000 条数据插入的耗时为 164.43 秒，两者差异相当的明显，看来 KWDN 对时序型数据插入的能力还是相当的可以呢。总体而言，通过本次对 KWDB 的万数据插入测试，深入了解了其在数据插入方面的性能表现和适用场景，为后续的数据库选型优化和应用开发提供了重要参考。
博客
2025 可信数据库大会，KaiwuDB 邀你来赴约！
07-11 38
KaiwuDB 以高性能时序引擎为基础，以核心多模技术实现 AloT 数据库架构创新，并以 Al 加速赋能数据库预测分析及系统自主演进。）与大家近距离交流。此外，我们还精心准备了多款 KaiwuDB 定制周边礼品，只要来到展位参与互动就有机会获得，真诚欢迎各位新老朋友前来 B08 展位打卡交流！很开心将在下周的可信数据库大会和各位见面，本次想和大家聊聊在物联网高速发展引发传统能源设备数据爆炸式增长态势下，如何基于。7 月 17 日上午 10：00-10：20，能源行业数据库应用创新分论坛，我将在。
博客
6 月热搜精选
07-09 467
内蒙古自治区计量测试研究院为落实国家"双碳"战略目标建设碳达峰碳中和在线监测系统，面临多源异构数据整合、实时处理及安全存储等挑战，KaiwuDB 通过分布式多模数据库提供百万级/秒数据写入和毫秒级查询能力，实现电力、钢铁等重点行业及森林、湿地等碳汇领域数据的统一管理，系统稳定运行 6 个月接入千万级设备，不仅解决了省级碳数据分散管理难题，更为碳排放精准计量和碳交易提供了可靠的数据支撑，助力构建完善的碳计量体系。6 月底，中国移动通信联合会公告显示，由中国工业互联网研究院（CAII）牵头研制的团体标准。
博客
KaiwuDB 时序数据库深度解析：在物联网领域实战指南
07-08 73
KaiwuDB 时序数据库为物联网场景提供了高效、稳定、可扩展的数据管理解决方案。通过合理的生命周期配置（如数据保留策略、TTL 控制）、分区策略优化（按时间或设备维度划分）以及存储参数调优（副本数、压缩策略等），能够有效应对海量设备持续写入、高频查询与长期存储的典型挑战。本文介绍的建库建表规范、多租户隔离配置、冷热分层存储、异常处理流程和性能调优实践，已在多个大型物联网项目中落地验证，显著提升了系统的稳定性与资源利用率，同时降低了整体运维与存储成本。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值