[TSDB] OpenGemini 使用指南

0 序

1 使用指南

安装部署

关键操作

安装、并连接 ts-cli

go install github.com/openGemini/openGemini-cli/cmd/ts-cli@latest
ts-cli --host 127.0.0.1 --port 8086

建库、建表、写读数据

-- 建库并切换
create database sensordb;
use sensordb;

-- 显式建表(可指定分区键 shardkey)
create measurement sensor;
create measurement sensor with shardkey farmID;

-- 写入数据(InfluxDB Line Protocol)
insert sensor,farmID=f1,deviceID=d0 sensorID="s20",value=50.98;

-- 查询数据
select * from sensor;

高基数列存引擎建表

CREATE MEASUREMENT rtt (deviceIp STRING, deviceName STRING, campus STRING, rtt INT64)
WITH ENGINETYPE = COLUMNSTORE
SHARDKEY deviceIp
PRIMARYKEY deviceIp,campus
SORTKEY deviceIp,campus,time;

启用【列协议写入】(openGemini.conf 配置):开启 [http] flight-enabled=true,端口 8087。

端口参考

组件 端口 说明
ts-sql 8086 对外统一服务入口(可变更)
ts-sql 6061 pprof 调试端口(不可变更)

Z FAQ for OpenGemini 使用

Q: openGemini 与华为云 GeminiDB 有什么关系?

openGemini 是华为云数据库 GeminiDB 的对应开源产品,由华为云数据库创新 Lab孵化开源,核心能力同源。

Q: openGemini 支持哪些协议/生态?

支持 InfluxDB v1.x Line Protocol、InfluxQL 与读写 API,兼容现有 InfluxDB 工具链;支持 Prometheus Remote Read/Write 与 PromQL;支持 OpenTelemetry 后端存储;提供 Grafana 数据源插件。

Q: 高基数存储引擎与默认存储引擎有何区别?

高基数(列存)引擎不受时间线数量限制,解决索引膨胀与内存占用问题;但当前只支持部分聚合算子(count/sum/min/max/mean/first/last/percentile),暂不支持正则匹配、复合表达式,且 Prometheus remote read/write、OpenTelemetry、数据订阅、连续查询、降采样等特性尚未支持。需按业务选型。

Q: 部署是否需要依赖第三方组件?

不需要。openGemini 部署不依赖任何第三方组件和应用,运维成本低;内置 ts-monitor 提供 260+ 项监控指标。

Q: 空闲时内存占用高吗?

不高。openGemini 启动后业务空闲时内存占用约 100–200MB,相比 InfluxDB 对资源占用做了显著优化,边缘/嵌入式设备可参考。

Q: 数据复制会影响写入性能吗?

在高写入密度场景下,基于 Raft 的数据复制可能影响写性能;官方表示后续将优化复制协议与副本分布。

Q: 支持 32 位系统吗?

官方暂不支持 X86-32 位系统;支持 X86-64 与 ARM-64。内核由 Golang 开发,可在 32 位系统尝试自行编译。

Q: 如何快速上手体验?

推荐使用 ts-cli 连接本地 ts-server(端口 8086),执行 create database → use → insert → select 即可体验完整读写流程。

Y 推荐文献

  • OpenGemini

X 参考文献

posted @ 2026-10-12 23:07  千千寰宇  阅读(19)  评论(0)    收藏  举报