https://github.com/apache/horaedb
Apache HoraeDB (incubating) is a high-performance, distributed, cloud native time-series database.
https://github.com/apache/horaedb
cloud-native distributed-database horaedb iot-database prometheus-remote-storage rust timeseries-analysis timeseries-database tsdb
Last synced: 17 days ago
JSON representation
Apache HoraeDB (incubating) is a high-performance, distributed, cloud native time-series database.
- Host: GitHub
- URL: https://github.com/apache/horaedb
- Owner: apache
- License: apache-2.0
- Created: 2022-05-26T06:22:14.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-15T06:58:18.000Z (3 months ago)
- Last Synced: 2025-04-10T11:58:52.453Z (17 days ago)
- Topics: cloud-native, distributed-database, horaedb, iot-database, prometheus-remote-storage, rust, timeseries-analysis, timeseries-database, tsdb
- Language: Rust
- Homepage: https://horaedb.apache.org
- Size: 10.7 MB
- Stars: 2,725
- Watchers: 41
- Forks: 214
- Open Issues: 23
-
Metadata Files:
- Readme: README-CN.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/apache/horaedb/actions/workflows/ci.yml)
[](https://github.com/apache/horaedb/issues)
[](https://hub.docker.com/r/apache/horaedb-server)
[](https://hub.docker.com/r/apache/horaemeta-server)
[English](./README.md)
Apache HoraeDB (incubating) 是一款高性能、分布式的云原生时序数据库。
## 文档
- [User Guide](https://horaedb.apache.org/docs/getting-started/)
- [Development Guide](https://horaedb.apache.org/docs/dev/)
## 快速开始
### 通过 Docker 运行
#### 使用 Docker 运行单机版 HoraeDB
```
docker run -d --name horaedb-server \
-p 8831:8831 \
-p 3307:3307 \
-p 5440:5440 \
ghcr.io/apache/horaedb-server:nightly-20231222-f57b3827
```
#### 使用 docker compose 运行集群，包含两个 horaedb 节点和一个 horaemeta 节点
```
docker compose -f docker/docker-compose.yaml up
```
### 基本操作
创建表
```
curl --location --request POST 'http://127.0.0.1:5440/sql' \
-d '
CREATE TABLE `demo` (
`name` string TAG,
`value` double NOT NULL,
`t` timestamp NOT NULL,
timestamp KEY (t))
ENGINE=Analytic
with
(enable_ttl="false")
'
```
数据写入
```
curl --location --request POST 'http://127.0.0.1:5440/sql' \
-d '
INSERT INTO demo (t, name, value)
VALUES (1702224000000, "horaedb", 100)
'
```
数据查询
```
curl --location --request POST 'http://127.0.0.1:5440/sql' \
-d '
SELECT * FROM `demo`
'
```
删除表
```
curl --location --request POST 'http://127.0.0.1:5440/sql' \
-d '
Drop TABLE `demo`
'
```
## 开发者社区
与来自世界各地的用户和开发人员一起在 Apache HoraeDB (incubating) 社区中茁壮成长。
- https://horaedb.apache.org/community/
## 致谢
在开发程中，我们受到很多开源项目的影响和启发，例如 [influxdb_iox](https://github.com/influxdata/influxdb/tree/main), [tikv](https://github.com/tikv/tikv) 等等，感谢这些杰出的项目。
## 开源许可
[Apache License 2.0](./LICENSE)