第一章 SDK概述
1.1 多语言支持
SXDB提供三套官方SDK，覆盖主流开发语言，所有SDK均基于统一的TCP二进制协议通信，确保跨语言行为一致。同时提供HTTP REST API作为补充接入方式。
| 语言 | 组件 | 包名或文件 | 特点 |
| C++ | 头文件+示例 | sxdb_protocol.h | 零依赖，头文件引入即可 |
| Java | JDBC驱动JAR | com.sxdb.jdbc.* | 标准JDBC接口，兼容ORM框架 |
| Python | 客户端模块 | sxdb_client.py | 单文件，pip install 即可 |
| 通用 | HTTP REST | POST /api/sql | 跨语言、跨平台调用 |
1.2 连接方式
SDK支持两种连接方式：TCP长连接（默认端口31111）和HTTP短连接（默认端口31112）。TCP通道延迟更低，适合高频数据操作；HTTP通道更方便跨墙和调试。
ℹ 生产环境建议使用TCP长连接方式，减少连接建立开销。测试和调试阶段可使用HTTP API快速验证。
图1-1 Prometheus Metrics接口输出示例