SDK 开发指南

概述

OpenMLDB的SDK，可以分为几层，如图所示。我们将从下层往上依次介绍。

SDK核心层

最下层是SDK核心层，具体实现为SQLClusterRouter，它是client的最小实现。通过正确的配置后，使用SQLClusterRouter的方法可以完成对OpenMLDB集群的所有操作。

开发者需要注意，它的方法中最核心的三个方法。

1. ExecuteSQL，支持执行所有sql，包括DDL，DML，DQL等等。

2. ExecuteSQLParameterized，支持参数化的sql形式。

3. ExecuteSQLRequest，这是OpenMLDB特有的Request模式，不是普通sql，因此需要一个专用的方法。

其他方法，比如CreateDB/DropDB/DropTable，由于历史原因，还没有及时删除，开发者不需要关心。

Wrapper层

由于SDK核心层的实现较复杂，我们提供Java和Python SDK的时候，没有选择从零开发，而是使用Java和Python调用SDK核心层。具体来说，我们使用swig做了一层wrapper。

Java Wrapper具体实现为SqlClusterExecutor。可以看到，它仅仅是对sql_router_sdk调用的简单封装，比如，对输入类型的转换，对返回结果的封装，对返回错误的封装。

Python Wrapper具体实现为OpenMLDBSdk。和Java Wrapper类似，它也只是简单的封装。

用户层

Wrapper层是可以直接使用的，但不够方便。所以，我们再提供了一层，Java/Python SDK的用户层。

Java用户层，支持了Java中比较流行的JDBC，具体实现见jdbc，使得用户可以使用JDBC协议来访问OpenMLDB，降低接入成本。

Python用户层，则是支持Python中比较流行的sqlalchemy，具体实现见sqlalchemy_openmldb与dbapi，同样可以降低用户的接入成本。

补充

我们希望增加更易用的C++ SDK。显然，我们不需要Wrapper层。 所以，理论上讲，开发者只需要用户层的设计与实现，实现中调用SDK核心层。

但考虑到代码复用，可能会一定程度地改动SDK核心层的代码，或者是调整SDK核心代码结构（比如，暴露SDK核心层的部分头文件等）。