[English](https://github.com/questdb/questdb) | 简体中文 | [繁體中文](README.zh-hk.md) | [العربية](README.ar-dz.md) | [Italiano](README.it-it.md) | [Українська](README.ua-ua.md) | [Español](README.es-es.md) | [Português](README.pt.md) | [日本語](./README.ja-ja.md)
# QuestDB
QuestDB 是一个开源的時序数据库，支持高吞吐数据获取和快速 SQL 查询，操作简单。
它支持使用InfluxDB连接协议、PostgreSQL协议和REST API进行批量无模式导入和导出。
QuestDB非常适用于金融市场数据、应用程序指标、传感器数据、实时分析、仪表板和系统基础设施监控。
QuestDB使用原生时间序列SQL插件实现了ANSI SQL。这些 SQL 扩展语义能更简单的连接
（JOIN）多个来源的关系型数据以及时间序列数据。我们通过列导向的存储模型、大规模
并行的矢量执行、SIMD 指令和各种低延迟技术实现了高性能。整个代码库是用 Java 和
C++从头开始构建的，没有任何外部依赖，并且 100% 不受垃圾回收的影响。
## 尝试 QuestDB
我们提供了一个[在线演示](https://demo.questdb.io/)，其中包括最新的 QuestDB 版本
和几个样本数据集：
- Trips： 近 10 年的纽约市出租车行程轨迹数据集，含 1.6 亿行的数据。
- Trades： 每月30M+的实时加密货币市场数据。
- Pos： 含有 25 万艘船的时序地理数据集。
| 查询 | 运行时间 |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SELECT sum(double) FROM trips` | [0.15 secs]() |
| `SELECT sum(double), avg(double) FROM trips` | [0.5 secs]() |
| `SELECT avg(double) FROM trips WHERE time in '2019'` | [0.02 secs]() |
| `SELECT time, avg(double) FROM trips WHERE time in '2019-01-01' SAMPLE BY 1h` | [0.01 secs]() |
| `SELECT * FROM trades LATEST ON time PARTITION BY symbol` | [0.00025 secs](https://demo.questdb.io/?query=SELECT%20*%20FROM%20trades%20LATEST%20ON%20timestamp%20PARTITION%20BY%20symbol;&executeQuery=true) |
我们的[在线演示](https://demo.questdb.io/)运行在 `c5.metal` 上且仅使用 96 个线程中的 24 个线程。
## 如何开始
### 安裝 QuestDB
你可以使用 Docker 来快速启动一个 QuestDB 实例：
```bash
docker run -p 9000:9000 -p 9009:9009 -p 8812:8812 questdb/questdb
```
macOS 用户可以使用 Homebrew 来启动：
```bash
brew install questdb
brew services start questdb
questdb start // To start questdb
questdb stop // To stop questdb
```
[QuestDB 下载页面](https://questdb.io/get-questdb/) 提供运行文件的直接下载，并
提供其他安装和部署方式的详细信息。
### 连接到 QuestDB
你可以使用以下接口与 QuestDB 进行交互。
- [web 控制台](https://questdb.io/docs/develop/web-console/): 将会启动一个 web
控制台，默认运行在 `9000` 端口
- [InfluxDB line protocol](https://questdb.io/docs/reference/api/influxdb/): 支
持高性能、高吞吐量单向数据插入，默认运行在 `9009` 端口
- [REST API](https://questdb.io/docs/reference/api/rest/) : 默认运行在 `9000` 端口
- [PostgreSQL wire protocol](https://questdb.io/docs/reference/api/postgres/):
默认运行在 `8812` 端口
### 写入数据
以下是我们官方开发的questdb客户端，支持多种编程语言：
- [.NET](https://github.com/questdb/net-questdb-client)
- [C/C++](https://github.com/questdb/c-questdb-client)
- [Go](https://pkg.go.dev/github.com/questdb/go-questdb-client)
- [Java](https://questdb.io/docs/reference/clients/java_ilp/)
- [NodeJS](https://questdb.github.io/nodejs-questdb-client)
- [Python](https://py-questdb-client.readthedocs.io/en/latest/)
- [Rust](https://docs.rs/crate/questdb-rs/latest)
## QuestDB 与其他开源 TSDB 的对比
参考[我们的文章](https://questdb.io/blog/2021/07/05/comparing-questdb-timescaledb-influxdb/)，
其中在功能、性能和成熟度上比较了 QuestDB 和其他的开源时序数据库。
以下是 高维度[时间序列基准测试套件](https://github.com/timescale/tsbs) 运行 `cpu-only`
用例的测试结果，基于使用 6 到 16 个工作线程在 32 个 CPU 和 64 GB RAM上测试对比得到：
## 相关资源
### 📚 阅读文档
- [QuestDB 文档:](https://questdb.io/docs/introduction/) 描述了如何运行
和配置 QuestDB 的技术参考。
- [教程](https://questdb.io/tutorial/) 逐步了解QuestDB的功能。
- [产品路线图](https://github.com/questdb/questdb/projects) 了解我们下个产品发布的计划。
### ❓ 寻求支持
- [Community Slack:](https://slack.questdb.io) 加入技术讨论，提问问题，与其他用户见面！
- [GitHub issues:](https://github.com/questdb/questdb/issues) 报告 QuestDB bugs与问题
- [Stack Overflow:](https://stackoverflow.com/questions/tagged/questdb) 寻找常见
问题的解决方法。
### 🚢 部署 QuestDB
- [AWS AMI](https://questdb.io/docs/guides/aws-official-ami)
- [Google Cloud Platform](https://questdb.io/docs/guides/google-cloud-platform)
- [Official Docker image](https://questdb.io/docs/get-started/docker)
- [DigitalOcean droplets](https://questdb.io/docs/guides/digitalocean)
- [Kubernetes Helm charts](https://questdb.io/docs/guides/kubernetes)
## 贡献
我们总是乐于接受对项目的贡献，无论是源代码、文档、错误报告、功能请求还是反馈。如
果要开始贡献：
- 请看一下 GitHub 上标有
"[Good first issue](https://github.com/questdb/questdb/issues?q=is%3Aissue+is%3Aopen+label%3A%22Good+first+issue%22)"
的问题。
- 阅
读[贡献指南](https://github.com/questdb/questdb/blob/master/CONTRIBUTING.md)。
- 有关构建 QuestDB 的详细信息，请参
见[构建说明](https://github.com/questdb/questdb/blob/master/core/README.md)。
- [创建 QuestDB 的一个分叉](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo)，
并提交一个 pull request，说明你的修改建议。
✨ 为了表示感谢，我们将向贡献者发送一些我们的 QuestDB 礼品，如贴纸和 T 恤衫
[在这里申领](https://questdb.io/community)
衷心感谢以下为 QuestDB 作出贡献的优秀人士：
（[表情符号键](https://allcontributors.org/docs/en/emoji-key)）：
本项目遵循
[all-contributors](https://github.com/all-contributors/all-contributors) 标准.
欢迎任何形式的贡献！
