QuestDB 开源项目教程

1. 项目目录结构及介绍

QuestDB 是一个开源的时间序列数据库，具有快速的数据摄取和 SQL 查询能力。以下是 QuestDB 项目的目录结构及其主要文件的介绍：

questdb/
├── artifacts/
├── benchmarks/
├── ci/
├── compat/
├── core/
├── examples/
├── i18n/
├── pkg/
│   └── ami/
│       └── marketplace/
├── utils/
├── win64svc/
├── all-contributorsrc
├── git-blame-ignore-revs
├── gitignore
├── gitmodules
├── CODEOWNERS
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE.txt
├── README.md
├── SECURITY.md
├── examples-manifest.yaml
└── pom.xml

主要目录和文件介绍

• artifacts/: 包含构建和发布过程中生成的工件。
• benchmarks/: 包含性能基准测试代码。
• ci/: 包含持续集成（CI）配置文件。
• compat/: 包含与不同平台兼容性的代码。
• core/: 包含 QuestDB 的核心代码。
• examples/: 包含示例代码和数据集。
• i18n/: 包含国际化（i18n）相关文件。
• pkg/ami/marketplace/: 包含 AWS AMI 和市场相关的配置文件。
• utils/: 包含各种实用工具和脚本。
• win64svc/: 包含 Windows 64 位服务的相关代码。
• all-contributorsrc: 贡献者列表配置文件。
• git-blame-ignore-revs: Git 忽略的修订列表。
• gitignore: Git 忽略文件配置。
• gitmodules: Git 子模块配置。
• CODEOWNERS: 代码所有者配置文件。
• CODE_OF_CONDUCT.md: 行为准则文件。
• CONTRIBUTING.md: 贡献指南文件。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目介绍和使用说明文件。
• SECURITY.md: 安全相关信息文件。
• examples-manifest.yaml: 示例配置文件。
• pom.xml: Maven 项目配置文件。

2. 项目启动文件介绍

QuestDB 的启动文件主要通过 Docker 或 Homebrew 进行启动。以下是启动文件的介绍：

使用 Docker 启动

docker run -p 9000:9000 -p 9009:9009 -p 8812:8812 questdb/questdb

使用 Homebrew 启动（适用于 macOS 用户）

brew install questdb
brew services start questdb
questdb start
questdb stop

3. 项目配置文件介绍

QuestDB 的配置文件主要通过环境变量或配置文件进行设置。以下是主要的配置文件和配置方式：

环境变量配置

QuestDB 支持通过环境变量进行配置，例如：

export QUESTDB_HTTP_BIND_PORT=9000
export QUESTDB_PG_BIND_PORT=8812

配置文件

QuestDB 的配置文件通常位于 conf/ 目录下，例如 conf/server.conf。以下是一个示例配置文件的内容：

# QuestDB 服务器配置文件
http.bind.to=0.0.0.0:9000
pg.bind.to=0.0.0.0:8812
line.tcp.bind.to=0.0.0.0:9009

其他配置

QuestDB 还支持通过命令行参数进行配置，例如：

questdb start --http.bind.to=0.0.0.0:9000 --pg.bind.to=0.0.0.0:8812

通过以上配置，您可以灵活地调整 QuestDB 的运行参数，以满足不同的需求。