进阶 questdb.com 2026-10-13 06:17:07 · 33 阅读
第3章 快速上手 QuestDB
快速上手
本指南将帮助您运行第一个 QuestDB 实例。
由于目标是快速起步,我们将默认使用初始配置。
启动后,我们会提供数据插入、配置和生产环境部署的指南。
QuestDB 已在运行?直接跳至下文!
选择官方客户端或数据摄取方式。
正在升级现有实例?请参阅 QuestDB 升级指南。
安装 QuestDB
从以下选项中选择:
Docker
Homebrew
Binaries
Docker
使用 Docker 前提是自己已安装 Docker。您可以在官方文档中找到针对您平台的安装指南。
安装 Docker 后,拉取并运行 QuestDB:
docker run -p 9000:9000 -p 8812:8812 -p 9003:9003 questdb/questdb:10.0.1
这将暴露 Web 控制台 (9000)、PostgreSQL 兼容接口 (8812) 和健康检查端点 (9003)。 如需更详细的说明,请参见 Docker 部署指南。 Homebrew 要通过 Homebrew 安装 QuestDB,请运行以下命令: brew install questdb
在 macOS 上,QuestDB 的根目录和服务器配置文件位置取决于芯片类型: Apple Silicon (M1/M2/M*) 芯片:/opt/homebrew/var/questdb Intel 芯片:/usr/local/var/questdb Binaries 下载二进制文件并运行 QuestDB。 选择您的平台: LinuxWindowsAny (no JVM)下载二进制文件:
questdb-10.0.1-rt-linux-x86-64.tar.gz
然后解压:
tar -xvf questdb-10.0.1-rt-linux-x86-64.tar.gz
默认目录为:
$HOME/.questdb
下载可执行文件:
questdb-10.0.1-rt-windows-x86-64.tar.gz
默认根目录为:
C:\Windows\System32\qdbroot
下载二进制文件: questdb-10.0.1-no-jre-bin.tar.gz 此包不包含 Java。 如果您没有对应平台的包(例如 ARM Linux),请使用此版本。 需要本地 Java 25。 要检查已安装版本: java -version
如果没有 Java,请安装以下之一: Eclipse Temurin Amazon Corretto OpenJDK Oracle Java 其他 Java 发行版可能可用,但未经定期测试。例如,已知 Azul Zing 不兼容。 设置环境变量时,将 JAVA_HOME 指向您的 Java 25 安装目录。 运行 QuestDB Linux/No JVMmacOS (Homebrew)Windows./questdb.sh start
要停止:./questdb.sh stop | 检查状态:./questdb.sh status所有选项./questdb.sh [start|stop|status] [-d dir] [-f] [-n] [-t tag]
选项说明-d需要一个 dir 目录值,指定作为 QuestDB 根目录的文件夹。更多信息和默认值请参见下方的默认根目录部分。-t需要一个 tag 字符串值,作为服务的标签。该选项允许用户运行多个 QuestDB 服务并分别管理。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web Console。不加此选项时,Web Console 会被缓存,仅在缺失时才部署。-n不响应 HUP 信号。这样即使关闭启动 QuestDB 的终端窗口,QuestDB 仍会继续运行。questdb start
停止:questdb stop | 查看状态:questdb status全部选项questdb [start|stop|status] [-d dir] [-f] [-n] [-t tag]
选项说明-d需要一个 dir 目录值,指定作为 QuestDB 根目录的文件夹。更多信息和默认值请参见下方的默认根目录部分。-t需要一个 tag 字符串值,作为服务的标签。该选项允许用户运行多个 QuestDB 服务并分别管理。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web Console。不加此选项时,Web Console 会被缓存,仅在缺失时才部署。-n不响应 HUP 信号。这样即使关闭启动 QuestDB 的终端窗口,QuestDB 仍会继续运行。questdb.exe start
停止:questdb.exe stop | 查看状态:questdb.exe status全部选项questdb.exe [start|stop|status|install|remove] \
[-d dir] [-f] [-j JAVA_HOME] [-t tag]
选项描述install安装 Windows QuestDB 服务。服务将在系统启动时自动启动。remove移除 Windows QuestDB 服务。之后它不会随系统启动。-d接受一个 dir 目录值,该文件夹将作为 QuestDB 的根目录。更多信息和默认值请参见下方“默认根目录”部分。-t接受一个 tag 字符串值,用作服务的标签。此选项允许用户运行多个 QuestDB 服务并独立管理它们。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web 控制台。若无此选项,Web 控制台会被缓存,仅在缺失时才部署。-j仅限 Windows!此选项允许指定 JAVA_HOME 的路径。 验证安装 在浏览器中打开 http://localhost:9000。 你应该能看到 QuestDB Web 控制台。 试着在 SQL 编辑器中运行你的第一个查询: CREATE TABLE test (ts TIMESTAMP, val DOUBLE) TIMESTAMP(ts);
INSERT INTO test VALUES (now(), 42.5);
SELECT * FROM test;
TIMESTAMP(ts) 子句将表标记为时序表,正是靠它 QuestDB 才能实现亚毫秒级的时间范围查询。请查阅 模式设计,了解该机制及其他关键概念。 一切就绪?可以开始导入数据了。 默认端口: 端口 | 服务 --- | --- 9000 | REST API 和 Web 控制台 9009 | InfluxDB 行协议(ILP)——旧版 TCP,建议改用 HTTP 8812 | PostgreSQL 线协议 9003 | 健康检查端点 导入数据 现在,该真正起飞了。🚀 下一步:导入数据——数据库的命脉。 可从以下精选的纯导入语言客户端中选择: Java:参考 QWP 客户端。通过单连接实现池化导入和流式 SQL。了解更多 C & C++:面向系统和嵌入式代码的列式 QWP 导入及流式查询。了解更多 Rust:线程安全的 QWP 池,支持 Buffer、Chunk、Arrow 和 Polars 导入。了解更多 Python:QWP 行数据和 DataFrame 导入,支持将 SQL 结果流式传输至 pandas、polars 或 Arrow。了解更多 .NET:.NET 的 QWP 发送器与查询客户端。Beta 版。了解更多 Go:具备存储转发持久性的池化 QWP 导入与查询。Beta 版。了解更多 Node.js:JavaScript 运行时客户端。通过 ILP 导入;QWP 支持计划中。了解更多 想要更多选项?查看导入概览。 创建新数据 目前还没有数据,但仍想试用 QuestDB? 有几种快捷方式: QuestDB 演示实例:托管部署,数据已加载完毕,随时可用。可快速体验 Web 控制台和 SQL 语法。 创建第一个数据集指南:创建表,使用 rnd_ 函数生成数据。 示例数据集仓库:IoT、电商、金融或 Git 日志?都可以试试! 快速上手仓库: 基于代码的快速上手,覆盖常见编程语言和场景下的导入、查询及数据可视化。还有一只穿运动服的黑猫。 时序流式分析模板: 一个便于使用开源技术进行近实时分析的实用模板。 学习 QuestDB 初次接触 QuestDB?从这里开始: 模式设计——理解指定时间戳、分区和 SYMBOL 类型。这些是快速时序查询的基础。 生产部署建议: 容量规划——生产环境的推荐配置 配置——所有 server.conf 选项 使用 Grafana 可视化——从数据创建仪表盘(示例)
这将暴露 Web 控制台 (9000)、PostgreSQL 兼容接口 (8812) 和健康检查端点 (9003)。 如需更详细的说明,请参见 Docker 部署指南。 Homebrew 要通过 Homebrew 安装 QuestDB,请运行以下命令: brew install questdb
在 macOS 上,QuestDB 的根目录和服务器配置文件位置取决于芯片类型: Apple Silicon (M1/M2/M*) 芯片:/opt/homebrew/var/questdb Intel 芯片:/usr/local/var/questdb Binaries 下载二进制文件并运行 QuestDB。 选择您的平台: LinuxWindowsAny (no JVM)下载二进制文件:
questdb-10.0.1-rt-linux-x86-64.tar.gz
然后解压:
tar -xvf questdb-10.0.1-rt-linux-x86-64.tar.gz
默认目录为:
$HOME/.questdb
下载可执行文件:
questdb-10.0.1-rt-windows-x86-64.tar.gz
默认根目录为:
C:\Windows\System32\qdbroot
下载二进制文件: questdb-10.0.1-no-jre-bin.tar.gz 此包不包含 Java。 如果您没有对应平台的包(例如 ARM Linux),请使用此版本。 需要本地 Java 25。 要检查已安装版本: java -version
如果没有 Java,请安装以下之一: Eclipse Temurin Amazon Corretto OpenJDK Oracle Java 其他 Java 发行版可能可用,但未经定期测试。例如,已知 Azul Zing 不兼容。 设置环境变量时,将 JAVA_HOME 指向您的 Java 25 安装目录。 运行 QuestDB Linux/No JVMmacOS (Homebrew)Windows./questdb.sh start
要停止:./questdb.sh stop | 检查状态:./questdb.sh status所有选项./questdb.sh [start|stop|status] [-d dir] [-f] [-n] [-t tag]
选项说明-d需要一个 dir 目录值,指定作为 QuestDB 根目录的文件夹。更多信息和默认值请参见下方的默认根目录部分。-t需要一个 tag 字符串值,作为服务的标签。该选项允许用户运行多个 QuestDB 服务并分别管理。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web Console。不加此选项时,Web Console 会被缓存,仅在缺失时才部署。-n不响应 HUP 信号。这样即使关闭启动 QuestDB 的终端窗口,QuestDB 仍会继续运行。questdb start
停止:questdb stop | 查看状态:questdb status全部选项questdb [start|stop|status] [-d dir] [-f] [-n] [-t tag]
选项说明-d需要一个 dir 目录值,指定作为 QuestDB 根目录的文件夹。更多信息和默认值请参见下方的默认根目录部分。-t需要一个 tag 字符串值,作为服务的标签。该选项允许用户运行多个 QuestDB 服务并分别管理。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web Console。不加此选项时,Web Console 会被缓存,仅在缺失时才部署。-n不响应 HUP 信号。这样即使关闭启动 QuestDB 的终端窗口,QuestDB 仍会继续运行。questdb.exe start
停止:questdb.exe stop | 查看状态:questdb.exe status全部选项questdb.exe [start|stop|status|install|remove] \
[-d dir] [-f] [-j JAVA_HOME] [-t tag]
选项描述install安装 Windows QuestDB 服务。服务将在系统启动时自动启动。remove移除 Windows QuestDB 服务。之后它不会随系统启动。-d接受一个 dir 目录值,该文件夹将作为 QuestDB 的根目录。更多信息和默认值请参见下方“默认根目录”部分。-t接受一个 tag 字符串值,用作服务的标签。此选项允许用户运行多个 QuestDB 服务并独立管理它们。如果省略此选项,默认标签为 questdb。-f强制重新部署 Web 控制台。若无此选项,Web 控制台会被缓存,仅在缺失时才部署。-j仅限 Windows!此选项允许指定 JAVA_HOME 的路径。 验证安装 在浏览器中打开 http://localhost:9000。 你应该能看到 QuestDB Web 控制台。 试着在 SQL 编辑器中运行你的第一个查询: CREATE TABLE test (ts TIMESTAMP, val DOUBLE) TIMESTAMP(ts);
INSERT INTO test VALUES (now(), 42.5);
SELECT * FROM test;
TIMESTAMP(ts) 子句将表标记为时序表,正是靠它 QuestDB 才能实现亚毫秒级的时间范围查询。请查阅 模式设计,了解该机制及其他关键概念。 一切就绪?可以开始导入数据了。 默认端口: 端口 | 服务 --- | --- 9000 | REST API 和 Web 控制台 9009 | InfluxDB 行协议(ILP)——旧版 TCP,建议改用 HTTP 8812 | PostgreSQL 线协议 9003 | 健康检查端点 导入数据 现在,该真正起飞了。🚀 下一步:导入数据——数据库的命脉。 可从以下精选的纯导入语言客户端中选择: Java:参考 QWP 客户端。通过单连接实现池化导入和流式 SQL。了解更多 C & C++:面向系统和嵌入式代码的列式 QWP 导入及流式查询。了解更多 Rust:线程安全的 QWP 池,支持 Buffer、Chunk、Arrow 和 Polars 导入。了解更多 Python:QWP 行数据和 DataFrame 导入,支持将 SQL 结果流式传输至 pandas、polars 或 Arrow。了解更多 .NET:.NET 的 QWP 发送器与查询客户端。Beta 版。了解更多 Go:具备存储转发持久性的池化 QWP 导入与查询。Beta 版。了解更多 Node.js:JavaScript 运行时客户端。通过 ILP 导入;QWP 支持计划中。了解更多 想要更多选项?查看导入概览。 创建新数据 目前还没有数据,但仍想试用 QuestDB? 有几种快捷方式: QuestDB 演示实例:托管部署,数据已加载完毕,随时可用。可快速体验 Web 控制台和 SQL 语法。 创建第一个数据集指南:创建表,使用 rnd_ 函数生成数据。 示例数据集仓库:IoT、电商、金融或 Git 日志?都可以试试! 快速上手仓库: 基于代码的快速上手,覆盖常见编程语言和场景下的导入、查询及数据可视化。还有一只穿运动服的黑猫。 时序流式分析模板: 一个便于使用开源技术进行近实时分析的实用模板。 学习 QuestDB 初次接触 QuestDB?从这里开始: 模式设计——理解指定时间戳、分区和 SYMBOL 类型。这些是快速时序查询的基础。 生产部署建议: 容量规划——生产环境的推荐配置 配置——所有 server.conf 选项 使用 Grafana 可视化——从数据创建仪表盘(示例)