金仓数据库KingbaseES客户端编程接口指南-ODBC（5. 开发过程）

5. 开发过程

在正确设置了KingbaseES ODBC 数据源以后，应用程序使用 KingbaseES ODBC API 的步骤如下：

1. 调用 SQLAllocHandle 函数分配环境句柄。

2. 调用 SQLAllocHandle 函数分配连接句柄。

3. 利用分配后的连接句柄调用 SQLConnect，SQLBrowseConnect 或者 SQLDriverConnect 连接到数据源。它指定数据源名以及完成连接所需的任何附加信息。

4. 处理一个或多个 SQL 语句：

   应用程序将 SQL 文本串放置于缓冲区中。

   如果语句包括参数标记，则将它设置参数值。

   如果语句返回结果集，应用程序则为语句赋值游标名或者使用驱动程序缺省的游标名。应用程序为“SQLPrepare 或 SQLExecute”提交语句。

   如果语句创建了结果集，应用程序则询问该结果集属性，例如列数，以及特定列的名称、类型等。它为结果集中的每一列分配存储并取回结果。

   如果语句引起错误，应用程序则从驱动程序中提取错误信息并采取相应行动。

5. 通过提交或重新操作来结束每一个事务。

6. 当应用程序与数据源之间的相互作用结束时，终止连接，释放相应的句柄。函数执行序列如下：

   1. SQLAllocHandle（SQL_HANDLE_ENV，NULL，&henv）<=> SQLAllocEnv ；

   2. SQLAllocHandle（SQL_HANDLE_DBC，henv，&hdbc）<=> SQLAllocConnect ；

   3. SQLConnect ；

   4. SQLAllocHandle（SQL_HANDLE_STMT，hdbc，&hstmt）<=> SQLAllocStmt ；

   5. 处理 SQL 语句(SQLPrepare 此步可以省略但在执行中必须调用 SQLExecDirect)；

   6. 如果有绑定参数则进行绑定赋值（SQLBindParameter）；

   7. 可以通过 SQLGetDescField, SQLColAttribute, SQLDescribeCol 等函数来获取信息（可以省略）；

   8. 通过 SQLExecute 或 SQLExecDirect 执行函数；

   9. 获取结果(SQLFetch, SQLBindCol, SQLGetData...)；

   10. SQLFreeHandle（SQL_HANDLE_STMT，hstmt）<=> SQLFreeStmt ；

   11. SQLDisconnect ；

   12. SQLFreeHandle（SQL_HANDLE_DBC，hdbc）<=> SQLFreeConnect ；

   13. SQLFreeHandle（SQL_HANDLE_ENV，henv）<=> SQLFreeEnv ；

为了让用户能更好地使用 KingbaseES ODBC 函数访问 KingbaseES 数据库，本文档还给出了一些 ODBC 的操作示例，请参见 示例说明 。