安装部署

openGemini大约 6 分钟约 1796 字

本指南介绍如何快速上手体验 openGemini时序数据库。

openGemini开源相关地址：

主仓: https://github.com/openGeminiopen in new window

备份仓: https://gitee.com/mirrors/opengeminiopen in new window

国内二进制下载: https://gitee.com/opengemini/Releases/releasesopen in new window ( 自v1.1.1版本开始支持)

安装

架构是否支持说明
X86-64✔-
X86-32✖32bit暂不支持，但由于openGemini内核为Go语言开发，
可以尝试在32bit系统上进行编译
ARM-64✔-
ARM-32✖32bit暂不支持，但由于openGemini内核为Go语言开发，
可以尝试在32bit系统上进行编译
其他，如龙芯✖暂不支持

连接数据库 (ts-cli)

为便于执行数据库（Database）的各种查询，openGemini 提供了一个命令行客户端应用程序ts-cli，用于连接openGemini。ts-cli随版本一同发布，解压后在usr/bin目录下，亦或者在源码编译后的build目录中。

如果openGemini ts-server或者ts-sql启动后的监听地址为127.0.0.1:8086，可不带任何参数，直接执行ts-cli，默认会连接127.0.0.1和8086端口。

> ./ts-cli

提示

指定IP地址和端口连接

> ./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. 如果启动过程中发现端口已占用，可以修改配置文件中的默认端口。所有端口用途请参考管理-端口矩阵章节。