安装部署

openGemini大约 4 分钟约 1053 字

本指南介绍如何快速上手体验 openGemini时序数据库。对于非生产环境,你可以选择以下任意一种方式部署openGemini时序数据库。

本指南以单机部署为例,如需了解集群部署,请点击集群部署查看详细步骤。

安装

  1. 可以到GitHub Releaseopen in new window页面复制最新版本链接

    请将 <version> 替换为下载的安装包版本

    wget https://github.com/openGemini/openGemini/releases/download/v<version>/openGemini-<version>-linux-amd64.tar.gz
    

    也可以通过手动下载对应的安装包。

  2. 进入到安装包所在目录,使用 tar 解压安装包;

    mkdir openGemini
    tar -zxvf openGemini-<version>-linux-amd64.tar.gz -C openGemini
    

    ts-server就是单机版本的二进制,openGemini.singlenode.conf是适用于ts-server的配置文件。

启动

进入 ts-server 所在文件夹后,执行

> ./ts-server

注意

v1.0.1及以前版本,运行ts-server需要指定配置文件启动:

> ./ts-server -config /path/to/openGemini.singlenode.conf

如需后台启动:

> nohup ./ts-server > server_extra.log 2>&1 &

命令行 (ts-cli)

为便于执行数据库(Database)的各种查询,openGemini 提供一命令行应用程序(以下简称为 openGemini CLI)ts-cli。要进入 openGemini 命令行,您只要进入ts-cli所在目录,在终端执行ts-cli 即可。

> ./ts-cli

提示

默认连接127.0.0.1:8086,可通过以下命令连接其他主机

> ./ts-cli -host 192.168.0.1 -port 8086

更多帮助请使用如下命令

> ./ts-cli -h

基本操作(ts-cli)

创建数据库

> create database db0

查看数据库

> show databases

运行效果

> create database db0
Elapsed: 1.446074ms
> show databases
name: databases
+------+
| name |
+------+
| db0  |
+------+
1 columns, 1 rows in set

Elapsed: 2.178147ms

使用数据库

> use db0

写数据

> insert cpu_load,host="server-01",region="west_cn" value=75.3

查看表

> show measurements

查询数据

> select * from cpu_load

运行效果

> use db0
Elapsed: 251ns
> insert cpu_load,host="server-01",region="west_cn" value=75.3
Elapsed: 162.328339ms
> show measurements
name: measurements
+----------+
| name     |
+----------+
| cpu_load |
| mst      |
+----------+
1 columns, 2 rows in set

Elapsed: 13.374945ms
> select * from cpu_load
name: cpu_load
+---------------------+-------------+-----------+-------+
| time                | host        | region    | value |
+---------------------+-------------+-----------+-------+
| 1681483835745490423 | "server-01" | "west_cn" | 75.3  |
+---------------------+-------------+-----------+-------+
4 columns, 1 rows in set

Elapsed: 3.259995ms

注意事项

ts-server为openGemini的单机版二进制文件,可简单理解为ts-server由一个ts-sql、一个ts-meta和一个ts-store组成。 注意事项:

  1. 如果默认配置不能满足需求,需要使用配置文件openGemini.singlenode.conf启动,完整的配置项和含义参考管理-配置项章节。
  2. 默认配置文件中数据、日志等默认保存在/tmp/openGemini目录下,建议替换为其他目录,确保有足够的存储空间。如果使用的scripts/install.sh脚本启动,还需要对应修改脚本中的/tmp/目录。
  3. 如果启动过程中发现端口已占用,可以修改配置文件中的默认端口。所有端口用途请参考管理-端口矩阵章节。