第一章 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 python-docx即可

通用

HTTP REST

POST /api/sql

跨语言、跨平台调用

SDK支持两种连接方式：TCP长连接（默认端口31111）和HTTP短连接（默认端口31112）。TCP通道延迟更低，适合高频数据操作；HTTP通道更方便跨墙和调试。

ℹ 生产环境建议使用TCP长连接方式，减少连接建立开销。测试和调试阶段可使用HTTP API快速验证。

图1-1 Prometheus Metrics接口输出示例