[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 参考文献
- About openGemini - openGemini Docs
- 关于 openGemini - openGemini 中文文档
- Cluster architecture - openGemini Docs
- 性能测试 - openGemini 中文文档
- ROADMAP - openGemini Docs
- High-series cardinality - openGemini Docs
- Install & Deployment - openGemini Docs
- openGemini - GitHub
- 华为云时序时空数据库 openGemini 正式开源 - 华为云
- 华为云发起,openGemini 正式成为 CNCF 官方项目 - 华为云
- openGemini 时序数据库应用场景与技术实践分享 - 华为云 DTT(PDF)
- 3招解决时序数据高基数难题 - CSDN
- openGemini 全新列存引擎,解决时序数据高基数难题 - 华为云社区
- openGemini - LFX Insights(社区健康度)
- openGemini plugin for Grafana - Grafana Labs
- openGemini - 墨天轮百科
- openGemini - 华为开源
本文链接: https://www.cnblogs.com/johnnyzen
关于博文:评论和私信会在第一时间回复,或直接私信我。
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
日常交流:大数据与软件开发-QQ交流群: 774386015 【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!

浙公网安备 33010602011771号