读者:UXDB 开发者,技术架构师、存量应用迁移团队、DBA 与运维集成人员,以及关注 UXDB 多语言生态的合作伙伴与行业读者。
近日,优炫数据库(UXDB) 应用开发接口文档完成体系化更新。共计1657 个接口条目,覆盖 ASP.NET、Python、PHP、Golang、Node.js、Qt 六大开发栈,逐条给出功能说明、函数签名、参数表与返回值定义。
UXDB 的多语言驱动生态覆盖 ASP.NET、C、C++、Golang、NCI、Node.js、JDBC、OCI、ODBC、PHP、Python、Qt 等语言与接口。此次体系化更新的六份手册,聚焦其中 ASP.NET、Python、PHP、Golang、Node.js、Qt 六大开发栈。
此前,各语言驱动接口文档以环境搭建与入门示例为主。开发者一旦触及预处理语句、批量装载、大对象、异步通知等深层能力,便只能依赖阅读和反复试错。此次更新把驱动能力从“能连上”推进到“查得清、用得准”。
一、六份文档,六种生态
规模差异来自各语言的接口组织方式,而非能力差异:
ASP.NET 按 ADO.NET 规范组织为 45 个类型对象。除 Connection、Command、DataReader、DataAdapter 等标准对象外,独立定义了 20 余种 UXDB 原生数据类型,包括日期时间族(Date、TimeTZ、TimeStampTZ、Interval)、网络与几何类型(Inet、MacAddress、Box、Circle、Path、Point、Polygon)以及变长位串 BitString,并配 CopyIn/CopyOut 批量通道与 LargeObject 管理。
Python 驱动 pycouxdb 完全支持 DB API 2.0 且线程安全,覆盖两阶段提交、服务端游标、异步连接与查询取消、逻辑与物理复制,并提供 DictCursor、execute_values 批量写入等高频工具。
PHP 采用 uxsql 与 pdo_uxsql 双扩展并行:前者覆盖连接、异步查询、结果集、大对象与 COPY;后者在 PDO 标准接口之上提供 UXDB 专有的大对象与 COPY 通道。文档同时收录 25 个旧版别名并逐一标注对应新接口,便于存量应用平滑迁移。
Golang 在 database/sql 标准接口之上叠加 uxsql 扩展:数组与 hstore 类型、CopyIn 批量导入、连接池统计、LISTEN/NOTIFY 监听器、SQL 组装转义与 SQLSTATE 错误解析。
Node.js 以 config.json 配置化方式使用,Client 单连接与 Pool 连接池齐备,提供类型解析器,接口面精简。
Qt 对外提供 Qt SQL 模块的 11 个公开类,覆盖数据库连接、SQL 执行、结果集处理、数据模型绑定等标准操作。
二、跨语言对齐,边界显式标注
此次UXDB 驱动文档更新在六个维度上形成统一能力框架:连接与连接池、预处理与参数绑定、COPY 批量导入导出、大对象 LOB、LISTEN/NOTIFY 异步通知、SQLSTATE 诊断。多数通用数据访问能力在六种语言间保持一致,开发者可按场景选择语言;特定能力则需结合下述显式边界判断。
需要说明两处驱动能力边界:Node.js 驱动当前未文档化 COPY 与大对象接口;Golang 的 uxsql 扩展未列出大对象能力。文档对所有不支持或未文档化项均作显式标注,例如 Python 不提供 psycopg2 导入名兼容等,让能力边界在选型阶段即可判定,而非留到实现阶段才暴露。
三、谁得到什么:五类读者的直接价值
开发者:接口可查、调用可依。 各条目逐一给出参数与返回值定义,无需阅读驱动源码即可完成调用;预处理语句、批量装载、大对象、异步通知等深层能力不再依赖反复试错。
技术架构师与技术负责人:选型阶段看清边界。 各文档在连接与连接池、预处理与参数绑定、COPY、大对象、LISTEN/NOTIFY、SQLSTATE 六个维度上形成统一框架,同时对 Node.js、Golang 的未覆盖项作显式标注,便于在架构选型阶段判断“选哪种语言会牺牲哪些数据库特性”。
存量应用迁移团队:改造集中在驱动层。 各驱动分别对齐主流生态标准:Golang 遵循 database/sql,Python 遵循 DB API 2.0,PHP 提供 PDO 兼容层,ASP.NET 遵循 ADO.NET,Node.js 沿用 pg 风格,Qt 沿用 Qt SQL 模块标准类。存量应用迁移时,改造集中在驱动加载与连接串配置,业务逻辑改动有限。
DBA、运维与集成实施人员:联调和排障有据可查。 接口条目中的函数签名、参数表、返回值定义以及“不支持”标注,可作为集成联调、问题定位和运维排障的依据,减少在驱动源码与运行现象之间来回猜测。
合作伙伴与行业读者:判断生态成熟度与适配成本。 各语言覆盖 Web 应用(PHP、Node.js)、企业级业务系统(ASP.NET)、云原生与数据工程(Golang、Python)、Qt 开发的桌面/跨平台应用四类典型场景,与 UXDB 在 OLTP、OLAP、向量、GIS、时序、图计算等多模态能力形成配套,也便于合作伙伴判断行业方案中的语言适配成本。
四、获取方式
文档随UXDB产品文档一同发布,位于官网的"文档中心->应用开发->开发接口”栏目