# ceresdb

**Repository Path**: lizehua/ceresdb

## Basic Information

- **Project Name**: ceresdb
- **Description**: CeresDB 是一款高性能、分布式、Schema-less 的云原生时序数据库，能够同时处理时序型（time-series）以及分析型（analytics）负载。
- **Primary Language**: Rust
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 24
- **Created**: 2024-11-13
- **Last Updated**: 2024-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![HoraeDB](docs/logo/horaedb-banner-white-small.jpg)

![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)
[![CI](https://github.com/apache/horaedb/actions/workflows/ci.yml/badge.svg)](https://github.com/apache/horaedb/actions/workflows/ci.yml)
[![OpenIssue](https://img.shields.io/github/issues/apache/horaedb)](https://github.com/apache/horaedb/issues)
[![HoraeDB Docker](https://img.shields.io/docker/v/apache/horaedb-server?logo=docker&label=horaedb-server)](https://hub.docker.com/r/apache/horaedb-server)
[![HoraeMeta Docker](https://img.shields.io/docker/v/apache/horaemeta-server?logo=docker&label=horaemeta-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)