GBase 8s ODBC Driver API

应用程序使用 GBase 8s ODBC Driver API 建立与数据源的连接，将 SQL 语句发送至数据源，动态地处理结果数据，并终止连接。

驱动程序允许应用程序执行下列步骤：

1. 连接至数据源。

可以通过 DSN 连接来连接数据源，也可以使用 DSN-less 连接字符串。指定数据

源的名称和完成连接所需的任何附加信息。

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

a. 将 SQL 文本字符串置于缓冲区中。如果该语句包括参数标记，则设置参数值。

b. 如果该语句返回结果集，则为该语句分配一个游标名称，或让驱动程序分配一

个。

c. 准备该语句，或者提交立即执行。

d. 如果该语句创建结果集，则可查询结果集的属性，诸如列数，以及特定列的名

称和类型。对于结果集中每一列，请指定存储和访存结果。

e. 如果该语句导致错误，则从驱动程序检索错误信息，并采取恰当的措施。

3. 通过提交或回滚来结束任何事务。

4. 当应用程序结束与数据源的交互时，终止连接。

每个 GBase 8s ODBC Driver 函数名称都以前缀 SQL 开始。每一函数接受一个或多个参数。

定义参数作为（至驱动程序的）输入或（来自驱动程序的）输出。

下图展示了应用程序进行的基本函数调用，即使应用程序通常也调用其他函数。

图: GBase 8s ODBC Driver应用程序进行的函数调用的示例列表