进阶 questdb.com 2026-10-13 06:17:07 · 30 阅读

第4章 QuestDB连接方式与QWP客户端库详解

第4章:连接

QuestDB 提供多种接口供应用程序写入数据或执行查询。请根据实际环境选择最适合的方式。

选择连接方式 使用场景推荐方案 需要最佳吞吐量、持久性和功能完整性的全新应用客户端库 驱动数据库的 AI 代理或 MCP 工具代理 来自 Kafka、Flink、Redpanda 或 Telegraf 的数据管道消息代理 HTTP 脚本、临时 curl 命令或 CSV 导入REST API 现有的 InfluxDB 采集器,或任何已支持 ILP 协议的工具兼容性 → ILP Postgres 风格数据层、BI 工具或 ORM兼容性 → PGWire 将 QuestDB 嵌入 JVM 应用Java(嵌入式) 开发新的 QuestDB 客户端库(QWP 规范)Wire 协议

客户端库 Java、Python、Go、Rust、Node.js、C & C++ 及 .NET 的第一方库是连接 QuestDB 的推荐方式。它们基于 QuestDB Wire 协议(QWP),通过单一配置和单一连接统一管理数据写入与查询。

QWP 支持情况 以下库已支持 QWP。其余语言客户端正在更新中——在发布支持 QWP 的版本前,它们将继续使用 ILP 写入数据和通过 PGWire 执行查询。 语言 | QWP 支持状态 Java | ✓ 稳定版 C & C++ | ✓ 稳定版 Rust | ✓ 稳定版 Python | ✓ 稳定版 .NET | 测试版 Go | 测试版 Node.js | 计划中

核心亮点: 网络传输采用二进制格式,体积约为 ILP 或 HTTP 的一半。 支持双向流式传输,单连接持续入站带宽达 800 MiB/s,出站最高可达 2.5 GiB/s。 自动故障转移,读写均能在无需应用层干预的情况下完成切换。 支持存储转发(Store-and-forward),即使服务器宕机甚至完全损毁也能保证数据不丢,卸载延迟低于 200 纳秒。 单一配置,一个连接字符串即可控制所有选项,且跨语言通用。 模式灵活,支持自动建表和动态添加列。

选择语言: Java 参考级 QWP 客户端,支持连接池写入和单连接流式 SQL。查看更多 C & C++ 面向系统程序和嵌入式代码的列式 QWP 写入与流式查询。查看更多 Rust 线程安全的 QWP 连接池,支持 Buffer、Chunk、Arrow 及 Polars 写入。查看更多 Python 支持 QWP 行级及 DataFrame 写入,以及向 pandas、polars 或 Arrow 的 SQL 流式输出。查看更多 .NET 面向 .NET 的 QWP 发送器与查询客户端。测试版。查看更多 Go 支持存储转发持久性的连接池 QWP 写入与查询。测试版。查看更多 Node.js JavaScript 运行时客户端。目前通过 ILP 写入,QWP 支持即将上线。查看更多

REST API 监听 9000 端点的 HTTP / JSON 接口,任何标准 HTTP 客户端均可使用。适用于需要一行 curl 命令、Shell 脚本、健康检查或在不引入客户端库的情况下进行批量文件加载的场景。QWP 不会取代 REST API。

REST API:/exec 执行 SQL 并返回 JSON,/imp 上传 CSV,/exp 将结果导出为 CSV 或 Parquet。 CSV 导入:通过 HTTP 或 COPY 命令批量加载 CSV 文件。 Parquet 导出:将查询结果写入 Parquet。

兼容性协议 如果已有工具支持这些协议,或原生客户端库不适合当前环境,可使用这些兼容性接口。

InfluxDB 行协议(ILP)—— InfluxDB 使用的基于文本的写入协议。兼容 Telegraf、Flink 及任何已支持 ILP 输出的采集器。Kafka 连接器原生支持 QWP。 PostgreSQL Wire 协议(PGWire)—— 可通过任何兼容 Postgres 的驱动(psycopg、JDBC、pgx 等)、BI 工具(Tableau、Grafana、Metabase)及 ORM 查询 QuestDB。

这些协议仍获得完全支持。由于它们早于 QWP 且主要用于集成已支持这些协议的现有工具链,故归类为兼容性接口。

Wire 协议 QuestDB Wire 协议(QWP)的底层字节规范,涵盖入站和出站的 WebSocket 变体。如果你正在开发我们尚未支持的编程语言客户端库,或需在现有框架中嵌入 QuestDB 连接功能,请参阅这些文档。

QWP 还提供用于“发后即忘”(fire-and-forget)指标上报的 UDP 传输方式,Java、Rust、C 和 C++ 客户端通过 udp 连接字符串模式支持该功能。它通过 qwp.udp.* 服务器设置进行配置,默认处于禁用状态,且没有单独的字节级规范文档。

请参阅 Wire 协议参考文档。

后续步骤

从上方选择一个语言并跟随其快速入门指南。 关于 SQL 语法、函数和操作符,请参阅 SQL 参考。 初次接触 QuestDB?请尝试演示实例,或参考第一组数据集指南。 时间序列基础知识背景:时间戳基础。

评论 (0)