[English](https://github.com/questdb/questdb) | [简体中文](README.zh-cn.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) | [Türkçe](./README.tr-tr.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) 標准.
歡迎任何形式的貢獻！
