142 lines
4.1 KiB
Markdown
142 lines
4.1 KiB
Markdown
# STVM 高效缓存数据库
|
||
|
||
STVM（truck of Virtual memory table）是一个开源的使用ANSI C语言编写、支持本地API调用和网络调用，全表数据基于IPC共享内存方式存储，基于C语言struck结构定义记录行，RB-Tree和hash作为主要算法的内存数据库，是一款介于SQL和NOSQL之间的一款高速缓存数据库。
|
||
|
||
* 支持SQL基础语法(insert、update、delete、select、group order、count，first)功能。
|
||
* 支持序列
|
||
* 拥有百万级别队列(gcc版本 >= 4.12)
|
||
* 支持唯一索引、查询索引和组合索引
|
||
* 支持多字动态查询
|
||
* 内置记录点击量(热点数据)
|
||
* 集群、主-子同步。
|
||
* 事务功能（假性事务）
|
||
* 基于IPC，进程异常退出，不会导致数据丢失，除非系统宕机。
|
||
* 支持网络API同步、异步和本地API直接调用
|
||
* 内置数据版本，维护数据一致安全
|
||
* 数据导入、导出接口
|
||
|
||
***使用须知***
|
||
* 表空间大小在创建时已经确定, 一旦创建不能随意修改大小。
|
||
* 多机集群无法使用事务。
|
||
* 数据无法持久化(宕机情况)。
|
||
* 索引长度限制（默认64字节），修改需编译项目。
|
||
* 启动后不能修改表字段，但可以修改字段别名
|
||
* 单机模式下，进程要设置退出接口，避免kill -9将正在操作内存表的进程杀死造成死锁(可用stvm -l table来重置锁)
|
||
|
||
建议使用场景：***数据库缓存、数据缓存、事件驱动***
|
||
|
||
不定时更新 https://my.oschina.net/deffpuzzl/blog/1627626
|
||
|
||
## 1、编译
|
||
**编译项目**
|
||
|
||
cd src目录 **./make**
|
||
|
||
在../lib下生成
|
||
* libstvm.a
|
||
* libstvm.so
|
||
* libstvm.so.1.2 -> ../lib/libstvm.so
|
||
|
||
在../bin下生成
|
||
* stvm
|
||
* detvm
|
||
|
||
## 2、启动
|
||
新建stvm工作目录 **mkdir tvmdb**
|
||
* **TVMDBD=/home/stvm/tvmdb** 指向stvm工作目录
|
||
* **TVMCFG=$(TVMDBD)/.tvm.run** 启动参数
|
||
|
||
使用方法:
|
||
如果不使用多机集群，无需配置域文件，缺省本地启动。
|
||
|
||
启动系统
|
||
> stvm -w
|
||
|
||
停止系统
|
||
> stvm -s
|
||
|
||
STVM也提供一个类型sqlpuls类型简单工具。
|
||
进入SQL界面, 该工具主要用来运维调试使用
|
||
> stvm SQL
|
||
|
||
域的维护
|
||
> stvm DOM
|
||
|
||
关于域的配置，请参见:
|
||
> vi stvm.conf
|
||
|
||
配置域完成后，可以配置编译到$TVMCFG下
|
||
> stvm -c stvm.conf
|
||
|
||
然后在stvm -w启动即可
|
||
|
||
建议以单机模式64位下运行，将性能发挥在极致。
|
||
|
||
**作者：Savens Liu**
|
||
|
||
**邮箱：deffpuzzl@qq.com**
|
||
|
||
## 3、更新
|
||
====***更新日期:20180312***====
|
||
|
||
>* 1、支持动态创建表语句
|
||
|
||
>* 2、新增对表结构导出功能
|
||
|
||
用法:
|
||
表创建语法示例: tbl_acct_base.def
|
||
|
||
在stvm SQL中，利用 create $file来创建表
|
||
|
||
====***更新日期:20180314***====
|
||
|
||
>* 1、新增表数据结构化导出、导入功能
|
||
|
||
>* 2、新增热点数据点击量api
|
||
|
||
====***更新日期:20180430***====
|
||
|
||
>* 1、修复create脚本sizeof算法问题。
|
||
>* 2、新增异步操作(网络插入、删除、更新）异步接口支持。
|
||
|
||
====***更新日期:20180515***====
|
||
|
||
>* 1、新增脚本msql来批量执行M-SQL语句。
|
||
>* 2、对表字段新增别名，暂用一些场景字段映射。
|
||
>* 3、新增comment关键字，在创建脚本文件或M-SQL中本地使用
|
||
>* 4、修复char字符拷贝和M-SQL界面非人性化操作。
|
||
|
||
====***更新日期:20180531***====
|
||
|
||
>* 1、新增replace功能(有则更新，无则新增), 包括同、异步接口
|
||
>* 2、在M-SQL支持查询索引 show index from tablename
|
||
>* 3、新增用户M-SQL用户体验(TAB补全、查询展示showmode、showsize)
|
||
|
||
====***更新日期:20180610***====
|
||
|
||
>* 1、新增queue网络同步异步接口
|
||
>* 1、新增将表中长时间无用数据导出备份接口
|
||
|
||
队列的创建与表类似:
|
||
队列不支持创建索引，队列创建有2种类型，基于表队列和字符串队列，详见API。
|
||
创建队列语法示例:
|
||
在M-SQL中执行 create que_user_info.def
|
||
|
||
**下本版本：**
|
||
* 0、新增分布式锁
|
||
* 1、新增多机资源共享方式。
|
||
* 2、基于raft协议计算分布式集群
|
||
* 3、JAVA接口开发
|
||
|
||
|
||
**不定时更新**
|
||
|
||
|
||
|
||
---
|
||
#### *常见错误集合* ####
|
||
```
|
||
Q、failed to boot TVM, Invalid parameter or sem has disappeared
|
||
A：echo "500 X X X" > /proc/sys/kernel/sem
|
||
```
|