本文资源均来自互联网，仅供学习交流使用，请于24小时内删除

项目介绍

KWDB 是一款面向 【AIoT 场景】的【分布式多模数据库】，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。

项目详情

KWDB

简体中文 | English

了解 KWDB

KWDB 是开放原子开源基金会孵化及运营的面向 AIoT 物联网场景的分布式多模数据库项目。基于浪潮 KaiwuDB 开源，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。典型应用场景包括但不限于物联网、能源电力、交通车联网等，旨在为各行业领域提供一站式数据存储、管理与分析的基座，助力企业数智化建设，以更低的成本挖掘更大的数据价值。

KWDB 适配多种场景，为开发者提供：

• 多种通用连接接口，具备高速写入、极速查询、SQL 支持、随需压缩、数据生命周期管理、集群部署等特性，与第三方工具无缝集成，降低开发及学习难度，提升开发使用效率。
• 快速安装部署、升级、迁移、监控等能力，提升数据库运维效率，降低数据库运维管理成本。
• 数据库可视化管理工具、时序数据库基准测试工具、监控指标模板等多种生态工具。

• MCP Server、AI 智能助手和 AI 智能体等多种 AI 赋能工具，帮助用户更高效、更智能的开发和维护 KWDB。

  关键词：物联网（IoT）、多模数据库、分布式、时序数据处理、云边端协同

快速开始

推荐使用 Docker 快速体验 KWDB：

docker run -d --privileged --name kwdb \
  -p 26257:26257 \
  -p 8080:8080 \
  -v /var/lib/kaiwudb:/kaiwudb/deploy/kaiwudb-container \
  --ipc shareable \
  -w /kaiwudb/bin \
  kwdb/kwdb \
  ./kwbase start-single-node \
--insecure \
--listen-addr=0.0.0.0:26257 \
--http-addr=0.0.0.0:8080 \
--store=/kaiwudb/deploy/kaiwudb-container

kwbase 是 KWDB 提供的内置命令行工具，用户可以通过 kwbase 连接 KaiwuDB，进行数据库操作和维护。

使用 Docker 连接 KWDB 并开启交互式 SQL Shell：

docker exec -it kwdb ./kwbase sql --insecure --host=127.0.0.1

编译和安装

KWDB 支持用户根据需求选择二进制安装包、容器和源码安装 KWDB 数据库：

• 二进制安装包：前往KaiwuDB 官网下载二进制安装包，支持单机和集群以及安全和非安全部署模式，更多信息见快速部署和集群部署。

• 容器镜像：KWDB 提供了多种容器镜像下载渠道，用户可以根据当前网络环境选择合适的镜像。

  • 官方仓库：kwdb/kwdb
  • 国内镜像：crpi-9ix5pwqh4t79xf4r.cn-shanghai.personal.cr.aliyuncs.com/kaiwudb/kwdb
  • Github 容器镜像：ghcr.io/kwdb/kwdb
• 源码：源码编译目前支持单节点非安全模式部署。

以下指南以 Ubuntu 22.04 操作系统为例说明如何编译源码和安装 KWDB。

操作系统和软件依赖

KWDB 支持在 Linux 操作系统进行安装部署，下表列出了编译和运行 KWDB 所需的软件依赖。

编译依赖：

运行依赖：

环境准备

1. 下载和解压 CMake 安装包。

tar -C /usr/local/ -xvf cmake-3.23.4-linux-x86_64.tar.gz 
mv /usr/local/cmake-3.23.4-linux-x86_64 /usr/local/cmake

2. 下载和解压 Go 安装包。

tar -C /usr/local -xvf go1.22.5.linux-amd64.tar.gz

3. 创建用于存放项目代码的代码目录。

mkdir -p /home/go/src/gitee.com

4. 设置 Go 和 CMake 的环境变量。

   • 个人用户设置：修改~/.bashrc 文件
   • 系统全局设置（需要 root 权限）：修改/etc/profile文件

export GOROOT=/usr/local/go
export GOPATH=/home/go      #请以实际代码下载存放路径为准，在此以home/go目录为例
export PATH=$PATH:/usr/local/go/bin:/usr/local/cmake/bin

5. 使变量设置立即生效：

   • 个人用户设置：

source ~/.bashrc                           

- 系统全局设置：

source /etc/profile                           

下载代码

在 KWDB 代码仓库下载代码，并将其存储到 GOPATH 声明的目录。

• 使用 git clone 命令：

git clone https://gitee.com/kwdb/kwdb.git /home/go/src/gitee.com/kwbasedb #请勿修改目录路径中的 src/gitee.com/kwbasedb
cd /home/go/src/gitee.com/kwbasedb 
git submodule update --init  #适用于首次拉取代码
git submodule update --remote

• 下载代码压缩包，并将其解压缩到指定目录。

构建和安装

1. 在项目目录下创建并切换到构建目录。

cd /home/go/src/gitee.com/kwbasedb
mkdir build && cd build

2. 运行 CMake 配置。

cmake .. -DCMAKE_BUILD_TYPE= [Release | Debug]

参数说明：
CMAKE_BUILD_TYPE：指定构建类型，默认为 Debug。可选值为 Debug 或 Release，首字母需大写。

3. 禁用Go模块功能。

   1. 设置环境变量

      • 个人用户设置：修改~/.bashrc 文件
      • 系统全局设置（需要 root 权限）：修改/etc/profile文件

export GO111MODULE=off

2. 使变量设置立即生效：

   • 个人用户设置：

source ~/.bashrc                           

• 系统全局设置：

source /etc/profile                           

4. 编译和安装项目。

   提示：

   • 如果编译时出现遗留的 protobuf 自动生成的文件导致报错，可使用make clean 清理编译目录。
   • 如果需要额外指定 protobuf 的文件路径，请使用 make PROTOBUF_DIR=。

make
make install

编译和安装成功后的文件清单如下：

/home/go/src/gitee.com/kwbasedb
├── install
│   ├── bin
│   │   ├── err_inject.sh
│   │   ├── query_kwbase_status.sh
│   │   ├── query_status.sh
│   │   ├── setup_cert_file.sh
│   │   ├── utils.sh
│   │   └── kwbase
│   └── lib
│       ├── libcommon.so
│       └── libkwdbts2.so

5. （可选）进入 kwbase 脚本所在目录，查看数据库版本，验证是否安装成功。

./kwbase version
KaiwuDB Version:  V2.0.3.2_RC3-3-gfe5eeb853e-dirty
Build Time:       2024/07/19 06:24:00
Distribution:
Platform:         linux amd64 (x86_64-linux-gnu)
Go Version:       go1.22.5
C Compiler:       gcc 11.4.0
Build SHA-1:      fe5eeb853e0884a963fd43b380a0b0057f88fb19

启动数据库

1. 进入 kwbase 脚本所在目录。

cd /home/go/src/gitee.com/kwbasedb/install/bin

2. 设置共享库的搜索路径。

export LD_LIBRARY_PATH=../lib

3. 启动数据库。

./kwbase start-single-node --insecure --listen-addr=:26257 --background

4. 数据库启动后即可通过 kwbase CLI 工具、KaiwuDB 开发者中心或 JDBC 等连接器连接和使用 KWDB，具体连接和使用内容见使用 kwbase CLI 工具连接 KWDB、使用 KaiwuDB 开发者中心连接 KWDB 和使用 JDBC 连接 KWDB。

社区

欢迎广大社区用户及开源爱好者 Star & Fork KWDB，并踊跃参与到我们的社区活动之中，携手共同建设社区。若需了解详情，请查阅我们的社区贡献相关内容。开发者可通过 Issue)、PR 以及技术交流群等方式展开沟通协作，助力社区实现更为良好的发展。

案例

KWDB 典型应用场景包括但不限于物联网、能源电力、交通车联网、智慧政务、IT 运维、金融证券等，更多信息请参见应用案例。

发版说明

请参见发版说明。

许可证

本项目根据 MulanPSL2 许可证授权。

声明

KWDB 是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目。

合作交流

如果你想和更多 KWDB 的用户互动交流，请扫下方二维码（备注：Gitee），KWDB 官方小助手将协助你加入官方技术交流群。

官方渠道

• 官网：https://www.kaiwudb.com
• 开源运营专区：https://kwdb.atomgit.com
• 公众号：KaiwuDB

⬇️ 下载地址

下载后请先检查文件完整性，如有问题请在评论区反馈