原文链接：【KWDB创作者计划】_丝滑般的KWDB 2.2.0全流程单节点Ubuntu裸机部署 - OSCHINA - 中文开源技术交流社区

作者：osc_41045269

全面解析 Coco AI，一款开源、免费的智能搜索与知识库工具 

前言

在数据库技术不断迭代的当下，KaiwuDB 以其卓越性能与创新架构备受瞩目。此次 2.2.0 版本全新登场，为开发者带来更高效稳定的体验。对于想深入探索其奥秘的创作者而言，单节点 Ubuntu 裸机部署是解锁功能的关键第一步。本文将基于 KWDB 学习路线中对部署实操的重视，为大家呈现丝滑般的全流程部署指南，助你快速搭建专属环境，开启 KWDB 的创作与实践之旅。

环境需求列表

官方的仓库中给了 Ubuntu 22.04 操作系统为例说明如何编译源码和安装 KWDB，那么我们就按照这个为核心环境来搭建单节点的逻辑部署。

我这里在 https://gitee.com/kwdb/kwdb/releases/tag/V2.2.0 中找到了对应编译好的压缩包，我们可以直接的下载使用。

基础环境与服务器的准备

这个部分让我们有一个可以运行 KWDB 的环境。

基础环境

必备环境：cmake&go

环境依赖列表

以上是官网给出的列表，那么其中我们值得注意的是 libprotobuf 这个环境依赖，我们如果是 Ubuntu 裸机的话一定要升级一下这个环境，不然肯定是无法应用的。

对于基础环境的安装，官网已经给出了提示，这是环境包下载之后进行安装，我们使用 Ubuntu 也可以使用 apt 来直接安装，但是这里建议先进行 sudo apt 的 ｕｐｄａｔｅ 更新操作，到最新版本之后再去安装。

4 核 8G 服务器的准备

这里可以使用自己电脑来安装一个 VM 创建也可以使用网络云服务器，我这里使用的是阿里云，用起来还是挺方便的。

这里的镜像选择一定要是符合版本的：

有了服务器我们就可以开工了。

登录到服务器：

KWDB 基础服务环境安装

我们首先要更新一个 apt，安装完成后还给了个提示：apt list --upgradable 可以查看已经安装的内容。

sudo apt ｕｐｄａｔｅ

安装 cmake 与 go

当有了最新版本的 apt 之后就可以使用下面的两条命令来安装 cmake 与 go 的环境了。

sudo apt install cmake -y sudo snap install go --classic

我们先来安装 cmake，安装完毕之后可以使用【cmake --version】来查看是否安装成功，我们可以在下图中看到安装的版本是 3.22.1，这就代表我们安装成功了。

继续安装 go 环境。

go 语言查看版本号有点区别，使用的是：go version

升级 libprotobuf-dev 到最新版本

apt install libprotobuf-dev -y

这个步骤一定是在升级 apt 到最新版本后再升级啊。

下载编译好的 2.2.0KWDB 压缩包

下载地址：https://gitee.com/kwdb/kwdb/releases/tag/V2.2.0

找到对应的版本：

为了操作方便，我们使用 wget 来直接下载：

wget https://gitee.com/kwdb/kwdb/releases/download/V2.2.0/KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz

包还是很大的，需要下载一会，这里我们静待一会。

下载完毕：

我们使用下面的命令来解压一下：

tar -zxvf KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz

这里可以看到我们解压出了 kwdb_install 文件夹，我们可以 cd 进来看看文件夹里面的内容：

cd kwdb_install/

配置 deploy.cfg

修改配置文件 关闭集群，这里只对单机进行安装，填写一下 ip 地址即可、将 127.0.0.1 更换成你的服务器 IP 地址

vi deploy.cfg

修改环境配置文件

~/.bashrc 与 /etc/profile 需要添加 【export GO111MODULE=off】 避免依赖冲突

vi ~/.bashrc

vi /etc/profile

source ~/.bashrc

source /etc/profile

安装 KWDB

安装过程中让输入一个 pwd，我这里直接六一个 1，记得住。

./deploy.sh install --single

刷新一下服务：

systemctl daemon-reload

启动 KWDB

systemctl start kaiwudb.service

启动完毕查看一下状态：

systemctl status kaiwudb

可以看到，已经 running 了，我们可以直接连接测试一下。

连接 KWDB

/usr/local/kaiwudb/bin/kwbase sql --host=8.147.135.144:26257 --certs-dir=/etc/kaiwudb/certs

执行测试看看：

可以看到已经连接成功了。

KWDB 创建 database

在创建表时使用 SERIAL：

实现自增主键 ：SERIAL 是一种特殊的数据类型，它会自动为插入的每一行数据生成一个唯一的、自增长的数值。这非常适合作为表的主键，因为主键需要唯一标识表中的每一行数据，使用 SERIAL 可以确保主键值的唯一性和连续性，方便后续的数据查询、关联和管理。 

简化操作 ：使用 SERIAL 定义自增主键，在插入数据时，你不需要手动指定主键的值，数据库会自动为其赋值，这样可以减少编程的复杂性，避免因手动赋值可能导致的错误，例如重复赋值或赋值不连续等问题。

数据完整性：SERIAL 类型会自动维护数据的完整性，确保生成的主键值在表中是唯一的。数据库系统会在后台管理 SERIAL 列的数值生成和分配，防止出现重复或无效的值，从而保证了表中数据的一致性和准确性。

我这里留出了测试语句：

-- 1. 创建数据库CREATE DATABASE kwdb_demo;-- 2. 使用数据库USE kwdb_demo;-- 3. 创建用户表CREATE TABLE users (    id SERIAL PRIMARY KEY,    name VARCHAR(50) NOT NULL,
    age INT,
    email VARCHAR(100) UNIQUE);-- 4. 插入5条数据ｉｎｓｅｒｔ INTO users (name, age, email) VALUES('zhangSan', 25, 'alice@example.com'),
('liSi', 30, 'bob@example.com'),
('wangWu', 35, 'charlie@example.com'),
('zhaoLiu', 22, 'david@example.com'),
('xiaoQi', 28, 'eve@example.com');-- 5. 基础增删改查操作-- 增加数据ｉｎｓｅｒｔ INTO users (name, age, email) VALUES ('fensi', 40, 'fensi@example.com');-- 查询数据-- 查询所有用户ｓｅｌｅｃｔ * FROM users;-- 查询年龄大于25岁的用户ｓｅｌｅｃｔ * FROM users WHERE age > 25;-- 修改数据ｕｐｄａｔｅ users SET age = 26 WHERE name = 'lisi';-- 删除数据ｄｅｌｅｔｅ FROM users WHERE name = 'fensi';

注：

所有语句正常使用，说明数据库肯定是没有任何问题的，到此，我们就流畅的丝滑的配置完毕了哦。

总结

完整的搭建下来，我们没有遇到些许阻碍，让我们的搭建过程更加的流畅，顺心，这样才能更好的更顺利的学习下去，这里我再推荐一下官网的各类信息地址：

KWDB 开源库地址：https://gitee.com/kwdb/kwdb

KWDB 学习地址：https://www.kaiwudb.com/learning/

KWDB 活动地址：https://mp.weixin.qq.com/s/ZKQo7eQj_AtwamONCSl07A

希望本文能为大家带来一些价值，欢迎留言讨论。