{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/416", "result": {"data":{"issuesJson":{"id":"5054ed95-75ee-5c90-8fa2-0b3fa13256d0","title":"openGemini/openGemini: 一款云原生分布式时序数据库，主要面向物联网和运维监控场景","number":416,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ReposopenGemini/openGemini
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

README

\n

\"color\"

\n

\"license\" \"language\" \"codeCov\" \"release\"
\nEnglish | 简体中文

\n

Official Website | Docs | Contribution Guide | RoadMap | Performance

\n \n \n \"Activity\n \n

About openGemini

\n

openGemini is a cloud-native distributed time series database, focusing on the storage and analysis of massive telemetry data.

\n

If you have used openGemini, please let us know and click submit Usage Information

\n

\"cncf_logo\"

\n

openGemini is an sandbox project of the Cloud Native Computing Foundation (CNCF). Please consider joining the CNCF if you are an organization that wants to take an active role in supporting the growth and evolution of the cloud native ecosystem.

\n

Why openGemini

\n

Compared with other time series database, openGemini has the following advantages:

\n\n

Support for Cloud Native Scenarios

\n\n

Application Scenes

\n

\"image-20220927210909436\"

\n

Quick Start

\n

For a more detailed introduction, please visit our official website User Guide

\n

This section mainly contains the following:

\n\n

Compiling environment information

\n

GO version v1.22+

\n

Python version v3.7+

\n

How to set GO environment variables

\n

Open ~/.profile configuration file and add the following configurations to the end of the file:

\n
export GOPATH=/path/to/dir\nexport GOBIN=$GOPATH/bin\nexport GO111MODULE=on\nexport GONOSUMDB=*\nexport GOSUMDB=off\n
\n

Compiling

\n
    \n
  1. Clone source codes from Github
    2. \n
\n
> cd $GOPATH\n> mkdir -p {pkg,bin,src}\n> cd src\n> git clone https://github.com/openGemini/openGemini.git\n
\n
    \n
  1. Enter the home directory
    2. \n
\n
> cd openGemini\n
\n
    \n
  1. Compiling
    2. \n
\n
> export CGO_LDFLAGS=\"-Wl,-z,now -Wl,-z,relro -Wl,-z,noexecstack -fPIE -ftrapv\"\n> export CGO_CFLAGS=\"-fstack-protector-strong -D_FORTIFY_SOURCE=2 -O2\"\n> python build.py\n
\n

The compiled binary file is in the build directory

\n
> ls build\nts-meta ts-monitor ts-server  ts-sql  ts-store\n
\n

Configuration

\n

The configuration file is in the conf directory. For more information about the configuration items, please refer to User Guide --> Reference --> Configuration Files

\n

Run openGemini

\n

Standalone operation

\n
> cd openGemini\n> mkdir -p /tmp/openGemini\n> sh scripts/install.sh\n
\n

Refer to cluster deployments in User Guide

\n

Using openGemini

\n

Install ts-cli

\n
> go install github.com/openGemini/openGemini-cli/cmd/ts-cli@latest\n
\n

Use the openGemini-cli to connect to openGemini

\n
> ts-cli --host 127.0.0.1 --port 8086
\n

After successful login, the following message will be displayed

\n
> ts-cli --host 127.0.0.1 --port 8086\nopenGemini CLI 0.1.0 (rev-revision)\nPlease use 'quit', 'exit' or 'Ctrl-D' to exit this program\n>
\n

Create a database

\n
> create database sensordb\n> use sensordb\n
\n

The openGemini supports three ways for creating a measurement.

\n\n
> create measurement sensor\n
\n\n
> create measurement sensor with shardkey farmID
\n

Write data

\n
insert sensor,farmID=f1,deviceID=d0 sensorID=\"s20\",value=50.98\n
\n

Query data

\n
> select * from sensor\nname: sensor\n+---------------------+----------+--------+----------+-------+\n| time                | deviceID | farmID | sensorID | value |\n+---------------------+----------+--------+----------+-------+\n| 1657959880895515464 | d0       | f1     | s20      | 50.98 |\n+---------------------+----------+--------+----------+-------+\n5 columns,1 rows in set\nElapsed: 7.723332ms\n
\n

Join & Contribute

\n

Tips for Contribution

\n

Code of Conduct

\n

openGemini follows the CNCF Code of Conduct.

\n

Contact Us

\n
    \n
  1. \n

    Slack

    \n
    2. \n
  2. \n

    Twitter

    \n
    3. \n
  3. \n

    Email

    \n
    4. \n
  4. \n

    mailing list

    \n
    5. \n
\n

License

\n

openGemini is licensed under the Apache License 2.0. Refer to LICENSE for more details.

\n

For third-party software usage notice, see Open_Source_Software_Notice

","updatedAt":"2025-05-21T16:14:29Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"时序数据库","color":"41997a"}},{"node":{"name":"openGemini","color":"ba2654"}}]},"comments":{"edges":[]}}},"pageContext":{"number":416,"previous":{"title":"opendevops-cn/opendevops: 一站式 DevOps、自动化运维、完全开源的云管理平台、自动化运维平台","number":415},"next":{"title":"apernet/OpenGFW: OpenGFW 是一个 Linux 上灵活、易用、开源的 GFW 实现，并且在许多方面比真正的 GFW 更强大","number":417}}}, "staticQueryHashes": ["151096407","2861350382"]}