SiriDB 服务器
SiriDB 是一个高度可扩展、稳定可靠且超快的时间序列数据库。
安装
Ubuntu
对于 Ubuntu,我们提供了可以在这里下载的 deb 软件包。
注意:SiriDB 需要 libexpat1、libuv1、libpcre2-8-0 和 libcleri0 这些库,可以使用 apt 轻松安装:
apt install libexpat1 libuv1 libpcre2-8-0 libcleri0
从 Ubuntu 18.04 开始提供
libcleri0
库,对于旧版本,可以在这里找到 deb 软件包: https://github.com/cesbit/libcleri/releases/latest
.deb 软件包会在 /etc/siridb/siridb.conf
安装一个配置文件。在启动 SiriDB 之前,您可能需要查看或更改此文件。
从源代码编译
从 2.0.19 版本开始,libcleri 不再作为此源代码的一部分包含在内, 需要单独安装。libcleri 可以在这里找到: https://github.com/cesbit/libcleri 或者可以使用
apt
安装。
Linux
安装以下依赖:(Ubuntu 18.04)
sudo apt install libcleri-dev
sudo apt install libpcre2-dev
sudo apt install libuv1-dev
sudo apt install libyajl-dev
sudo apt install uuid-dev
编译(将 Release 替换为 Debug 以进行调试构建):
cd ./Release
make clean
make test
make
安装
sudo make install
OSX
确保已安装 libcleri!
安装以下依赖:
brew install pcre2
brew install libuv
brew install yajl
brew install ossp-uuid
编译(将 Release 替换为 Debug 以进行调试构建):
cd ./Release
export CFLAGS="-I/usr/local/include"
export LDFLAGS="-L/usr/local/lib"
make clean
make test
make
安装
sudo make install
Docker
docker run \
-d \
-p 9000:9000 \
-p 9080:9080 \
-p 8080:8080 \
-v ~/siridb-data:/var/lib/siridb \
ghcr.io/siridb/siridb-server:latest
配置
SiriDB接受配置文件或环境变量作为配置。默认情况下,SiriDB会在/etc/siridb/siridb.conf
中搜索配置文件,但你也可以使用-c/--config
参数指定自定义路径或使用环境变量。
示例配置文件可以在这里找到: https://github.com/SiriDB/siridb-server/blob/master/siridb.conf
构建Debian软件包:
安装所需的包(运行测试需要autopkgtest)
apt-get install devscripts lintian help2man autopkgtest
创建归档文件
git archive -o ../siridb-server_2.0.31.orig.tar.gz master
运行测试
autopkgtest -B -- null
构建软件包
debuild -us -uc
运行集成测试
运行集成测试最简单的方法是使用docker。
构建集成测试镜像
docker build -t siridb/itest -f itest/Dockerfile .
运行集成测试
docker run siridb/itest:latest
创建或扩展数据库
SiriDB Admin可用于创建新数据库或使用新服务器扩展现有数据库。有关如何安装和使用管理工具的文档可以在siridb-admin GitHub项目中找到。大多数平台都可以从这里下载二进制文件。或者,也可以使用简单的HTTP API来创建或扩展SiriDB数据库。
使用SiriDB
SiriDB提供了多种工具来连接SiriDB数据库。
SiriDB连接器
以下是可用的原生连接器:
如果不使用以上连接器,你仍然可以使用SiriDB HTTP与SiriDB通信。
SiriDB HTTP
SiriDB HTTP为SiriDB提供了HTTP API,支持JSON、MsgPack、Qpack、CSV和Socket.io。SiriDB HTTP还提供可选的Web界面和SSL支持。
SiriDB Prompt
SiriDB Prompt可以作为具有自动完成支持的命令行SiriDB客户端,用于将json或csv数据加载到SiriDB数据库中。点击这里了解更多关于SiriDB Prompt的信息。
Grafana
SiriDB Grafana数据源是Grafana的一个插件。有关如何配置和使用此插件的信息,请参阅以下博客文章:https://github.com/SiriDB/grafana-siridb-http-example。
查询语言
查询语言的文档可以在https://siridb.net/documentation找到。