SiriDB 服务器

SiriDB 是一个高度可扩展、稳定可靠且超快的时间序列数据库。

---

• 安装
  • Ubuntu
  • 从源代码编译
    • Linux
    • OSX
    • Docker
    • 配置
  • 构建 Debian 软件包
  • 运行集成测试
• 创建或扩展数据库
• 使用 SiriDB
  • SiriDB 连接器
  • SiriDB HTTP
  • SiriDB 命令行工具
  • Grafana
• API/查询语言

---

安装

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连接器

以下是可用的原生连接器：

• C/C++
• Python
• Go
• Node.js

如果不使用以上连接器，你仍然可以使用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找到。