lsilvest/ztsdb

镜像概述

ztsdb是一款快速、轻量的多用户NoSQL列存储数据库管理系统，专为时间序列数据的更新、存储和处理优化。其查询与操作语言基于R编程语言，支持单时间序列或跨多时间序列的复杂数据选择，采用GPLv3开源许可。本镜像包含ztsdb数据库本身、append负载测试工具、R语言环境及rztsdb库，后者实现了数据库与R的无缝连接。

核心功能

• 快速轻量的时间序列数据存储与处理能力
• 基于R语言的查询与操作语法，降低学习成本
• 多用户支持，满足协作需求
• 与R语言环境无缝集成，便于数据分析
• append工具可模拟实时数据追加场景

使用场景

• 单实例ztsdb数据库部署与测试
• 多实例集群测试与实时数据流转模拟
• 通过R语言进行时间序列数据的交互分析

配置说明

运行容器并启动ztsdb

bash
docker run -it docker.xuanyuan.run/lsilvest/ztsdb ztsdb

输入q()命令可随时终止ztsdb实例。

运行多实例（端口映射）

若需从容器外部访问实例，启动时需发布监听端口：

bash
docker run -it -p 19300:19300 docker.xuanyuan.run/lsilvest/ztsdb ztsdb -p 19300

获取容器IP地址的方式：

bash
system("ip addr show")

假设容器IP为172.17.0.2。

从其他ztsdb实例连接

启动另一个ztsdb实例后，在命令行建立连接：

bash
docker run -it docker.xuanyuan.run/lsilvest/ztsdb ztsdb
c1 <- connection("172.17.0.2", 19300)

使用append工具

append工具用于按指定频率生成时间序列追加消息，用法：

bash
append <ip> <port> <rate> <varname[,name1,...]> <ncols> [max-msgs]

首先在ztsdb服务器实例创建时间序列：

r
data <- matrix(0, 0, 3, dimnames=list(NULL, c("a","b","c")))
idx <- as.time(NULL)
a <<- zts(idx, data)

从另一容器启动append工具（向IP为172.17.0.2、端口***的实例，以每秒10万条消息速度追加到名为a的3列时间序列）：

bash
append 172.17.0.2 19300 100000 a 3

运行R并连接数据库

启动R环境：

bash
docker run -it docker.xuanyuan.run/lsilvest/ztsdb R

加载rztsdb库并连接实例：

r
library(rztsdb)
con <- connection("172.17.0.2", 19300)

交互示例：

r
con ? 2*2  # 远程实例执行乘法运算
con ? matrix(1:10,5,2)  # 远程实例创建矩阵
con ? (a <<- matrix(1:10,5,2))  # 远程实例创建全局变量a

更多信息

• ztsdb主页：[***]
• 运行指南：[***]
• 参考文档：[***]
• 项目仓库：https://gitlab.com/lsilvest/ztsdb
• rztsdb库仓库：https://gitlab.com/lsilvest/rztsdb
• Docker镜像地址：https://hub.docker.com/r/lsilvest/ztsdb/