DB2 9 应用开发（733 考试）认证指南，第 5 部分: CLI/ODBC 编程(3)-sdccf-ChinaUnix博客

在初始化期间，需要分配（和初始化）处理事务所需的资源，并建立到事务处理任务需要使用的数据源的连接。CLI/ODBC 应用程序使用的资源由通过惟一句柄标识的专用数据存储区组成。（句柄是一个简单的指针变量，它指向 DB2 CLI 或 ODBC Driver Manager 所控制的数据对象，该数据对象由 CLI/ODBC 函数调用引用。）通过使用数据存储区和句柄，CLI/ODBC 应用程序不必负责分配和管理全局变量和诸如嵌入式 SQL 应用程序中使用的 SQLCA 和 SQLDA 之类的数据结构。有四种不同类型的句柄：

环境句柄： 指向一个数据存储区的指针，该数据存储区包含特定于 CLI/ODBC 的全局信息。
连接句柄：指向一个数据存储区的指针，该数据存储区包含关于 CLI/ODBC 管理的数据源（数据库）连接的信息。
语句句柄：指向指向数据存储区域的指针，该数据存储区包含单个 SQL 语句有关的特定信息。
描述符句柄：指向一个数据存储区域的指针，该数据存储区包含一个元数据集合，这些元数据描述被绑定到 SQL 语句中的参数标记的应用程序变量，或者被绑定到查询结果数据集中列的应用程序变量。

每个 CLI/ODBC 应用程序必须从分配一个环境句柄开始。通常每个应用程序只分配一个环境句柄，并且在分配任何其他句柄之前，那个环境句柄必须已经存在。所有其他句柄都是在环境句柄使用的上下文环境中管理的。环境句柄可以通过调用 SQLAllocHandle() 函数并指定 SQL_HANDLE_ENV 选项来分配。用于分配环境句柄的源代码如下所示：

在 CLI/ODBC 应用程序中，到数据源的连接是通过连接句柄实现的。因此，在建立到任何数据源的连接之前，必须存在一个连接句柄。可以通过调用 SQLAllocHandle() 函数并指定 SQL_HANDLE_DBC 选项和一个有效的环境句柄来分配连接句柄。用于分配连接句柄的源代码如下所示：

CLI/ODBC 应用程序的真正骨干是语句句柄。语句句柄用于：

将应用程序变量绑定到 SQL 语句中使用的参数标记。
准备和提交 SQL 语句到适当的数据源，以便执行。
获得关于 SQL 语句产生的结果数据集的元数据。
将应用程序变量绑定到结果数据集中的列。
从结果数据集中检索（读取）数据。
当 SQL 未能执行时，获得诊断信息。

CLI/ODBC 应用程序中编写的每条 SQL 语句都必须有它自己的语句句柄。每个语句句柄只能与一个连接句柄相关联。但是，一个连接句柄可以与任意数量的语句句柄相关联。语句句柄可以通过调用 SQLAllocHandle() 函数并指定 SQL_HANDLE_STMT 选项和一个有效的连接句柄来分配。因此，用于分配语句句柄的源代码如下所示：

每当分配一个语句句柄时，就会自动分配与语句句柄相关联的 4 个描述符句柄。分配后，这些描述符句柄继续与相应的语句句柄相关联，直到它被销毁（那时，描述符句柄也随之被销毁）。大多数 CLI/ODBC 操作都可以使用这些隐式定义的描述符句柄来执行。但是，也可以通过调用 SQLAllocHandle() 函数并指定 SQL_HANDLE_DESC 选项和有效的连接句柄来显式地分配描述符句柄。

CLI 和 ODBC 使用特定于产品的驱动程序来与数据源（数据库）通信，大多数驱动程序都包含一组动态参数，通过修改这些参数，可以更改驱动程序的行为，以满足应用程序的需求。这些参数被成为属性，每个环境句柄、连接句柄和语句句柄都有其自己的一组属性。（后面有一个小节描述用于获取和更改与环境句柄、连接句柄或语句句柄相关联的属性。）环境属性的一个例子是 SQL_ATTR_ODBC_VERSION 属性，在分配环境句柄之后，分配任何相应的连接句柄之前，必须为该属性赋予 SQL_OV_ODBC3 或 SQL_OV_ODBC2 值。这告诉 DB2 CLI 和 ODBC Driver Manager，应用程序打算遵从 CLI/ODBC 3.x 规范或 CLI/ODBC 2.0（或更早版本）规范。用于告诉 DB2 CLI 或 ODBC Driver Manager 应用程序打算遵从 CLI/ODBC 3.x（或更高版本）规范的代码如下所示：

让 DB2 CLI 和 ODBC Driver Manager 知道应用程序遵从何种规范很重要，因为 CLI/ODBC 函数返回的很多返回码（或者被称为 SQLSTATE，SQLSTATEs 中会详细谈到）的值会因版本的不同而不同。此外，DB2 CLI 和 ODBC 的较高版本允许在某些函数参数中使用通配符，而较早版本则不允许。

要对数据库执行任何类型的操作，必须首先建立到数据库的连接。对于 CLI/ODBC 应用程序，有 3 个函数可用于建立数据源（数据库）连接：

SQLConnect()
SQLDriverConnect()
SQLBrowseConnect()

应用程序可以使用这 3 个函数的任意组合连接到任意数目的数据源，但是某些数据源可能会限制所支持的活动连接的数量。（应用程序可以通过调用 SQLGetInfo() 函数并指定 SQL_MAX_DRIVER_CONNECTIONS 信息类型来发现一个数据源支持多少活动连接。

SQLConnect() 函数目前是最简单的 CLI/ODBC 连接函数。当使用 SQLConnect() 函数时，它假设建立连接所需的惟一信息就是一个数据源名称，可能还有一个用户 ID（授权 ID）和密码。（其他必要的信息存储在 db2cli.ini 文件的 [COMMON] 部分、ODBC.INI 文件的 [ODBC] 部分或系统注册表中的 ODBC 子键中。）该函数非常适用于只需要用户 ID 和口令来连接数据源的应用程序，以及需要提供其自己的连接界面或根本无需用户界面的应用程序。

而 SQLDriverConnect() 函数则允许应用程序使用一个连接字符串将连接信息发送到一个数据源驱动程序（而不是将该信息存储在 db2cli.ini 文件、ODBC.INI 文件或系统注册表中，然后允许驱动程序来检索）。连接字符串是一系列的键/值对，之间以分号隔开，其中包含建立到数据源连接时所需的信息。表 1 列出了一些较常用的键/值对。

键/值	用途
`DRIVER=DriverName`	指定建立到数据库的连接所需使用的 CLI/ODBC 驱动程序的名称
`DBALIAS=DatabaseAlias`	指定要与之建立连接的数据库的别名
`DSN=DataSourceName`	指定要与之建立连接的数据源的名称（与 `SQLDataSources()` 函数返回的值一致）
`UID=UserID`	指定尝试建立连接的用户的用户 ID（授权 ID）
`PWD=Password`	指定所指定用户 ID（授权 ID）对应的密码。如果所指定的 ID 不需要密码，则应该使用一个空的密码字符串（`PWD=;`）
`NEWPWD=NewPassword`	指定为所指定用户 ID（授权 ID）分配的新密码。如果使用了 `NEWPWD` 但是没有提供新密码（`NEWPWD=;`），则 DB2 CLI 驱动程序提示用户提供一个新密码

因此，若要使用 SQLDriverConnect() 函数建立到一个已编目的、名为 PAYROLL 的、使用授权 ID db2admin 和密码 ibmdb2 的数据库的连接，可以使用如下代码：

您可能注意到，有一个名为 SQL_NTS 的特殊代码被作为 SQLDriverConnect() 函数的一个参数值。接受字符串值作为参数的 CLI/ODBC 函数通常要求同时提供字符串的长度。可以使用 SQL_NTS 值代替实际长度值，表明相应的字符串是以 null 终止的。

当被调用时，SQLDriverConnect() 函数使用指定的数据源名称解析连接字符串，并尝试从系统中获取附加的信息，以建立连接。然后，该函数使用这些信息登录到适当的服务器上，并尝试连接到指定的数据源。使用 SQLDriverConnect() 函数的应用程序还可以让驱动程序提示用户提供所需的连接信息。例如，当用一个空连接字符串调用 SQLDriverConnect() 函数时，DB2 CLI 显示一个对话框，提示用户：

从 DB2 CLI 认识的数据源列表中选择一个数据源。
提供一个用户 ID 和相应的密码。
指定连接模式是独占的还是共享的。

是否显示该对话框由传递给 SQLDriverConnect() 函数的一个参数值控制：如果调用该函数时指定了 SQL_DRIVER_PROMPT、SQL_DRIVER_COMPLETE 或 SQL_DRIVER_COMPLETE_REQUIRED 选项，那么，如果提供的连接字符串没有包括足够的信息来建立数据源连接，则显示该对话框。但如果指定了 SQL_DRIVER_NOPROMPT 选项，但是没有提供足够的信息，那么就会返回错误。

和 SQLDriverConnect() 函数一样，SQLBrowseConnect() 函数使用一个连接字符串将连接信息发送给驱动程序。SQLDriverConnect() 函数在编译时需要一个有效的连接字符串，而 SQLBrowseConnect() 函数可用于在应用程序运行时构造一个连接。这点差异使应用程序可以使用它自己的对话框提示用户提供连接信息，从而保留对其外观的控制。

CLI/ODBC 应用程序执行完适当的初始化之后，焦点就转移到事务处理上来。在此期间，通过不同的 CLI/ODBC 函数调用，将查询和操纵数据的 SQL 语句传递到适当的数据源（在这里通常是 DB2 数据库）进行处理。在事务处理期间，CLI/ODBC 应用程序依次执行以下五个步骤：

分配一个或多个语句句柄。
准备和执行一个或多个语句。
检索和处理产生的结果。
通过提交或回滚终止当前事务。
释放分配的所有语句句柄。

图 2 显示了事务处理期间执行的基本步骤，并给出了常用于执行每个步骤的 CLI/ODBC 函数调用：

正如前面提到的，语句句柄引用一个数据对象，该对象包含单个 SQL 语句的有关信息。这些信息包括：

SQL 语句的文本
关于与语句相关联的游标的详细信息
所有 SQL 语句参数标记变量的绑定
所有结果数据集列变量的绑定
语句执行的返回码
状态信息

SQL 语句句柄是通过调用 SQLAllocHandle() 函数并指定 SQL_HANDLE_STMT 选项和一个有效的连接句柄来分配的。在 CLI/ODBC 应用程序执行任何 SQL 语句之前，必须至少分配一个语句句柄。

分配好语句句柄后，就可以将一个 SQL 语句赋给它，处理 SQL 语句的方式有两种：

准备和执行:这种方法将 SQL 语句的准备与执行分开，通常用于需要重复执行语句的情况。如果应用程序需要预知存在于执行 SQL 语句所产生的结果数据集中列的有关信息，也使用该方法。这种方式使用 CLI/ODBC 函数 SQLPrepare() 和 SQLExecute() 来处理 SQL 语句。
立即执行：该方法将 SQL 语句的准备和执行合并为一个步骤，通常用于语句只执行一次的情况。如果应用程序不需要关于 SQL 语句执行时所产生的结果数据集的附加信息，那么也可以使用该方法。这种方式使用 CLI/ODBC 函数 SQLExecDirect() 来处理 SQL 语句。

这两种方法都允许使用参数标记代替被处理的 SQL 语句中的常量和表达式。参数标记用问号（?）表示，用来指示当执行 SQL 语句时将在 SQL 语句中的何处替换一个或多个应用程序变量的当前值。当一个应用程序变量与 SQL 语句中一个参数标记关联时，就称该变量被“绑定”到该参数标记。这种绑定是通过调用 SQLBindParameter() 函数完成的，应用程序变量被绑定到参数标记之后，参数标记与该变量的关联就一直有效，直到它被重载或者相应的语句句柄被释放。虽然在 SQL 语句准备好之后可以随时进行绑定，但是只有到 SQL 语句执行的时候，才能真正从绑定变量中检索数据。

清单 1 展示了在一个用 C 语言编写的 CLI/ODBC 应用程序中，如何将应用程序变量绑定到简单的 SELECT SQL 语句中的参数标记。它还展示了在语句执行之前，将值以何种方式提供给绑定参数。

在准备并执行了 SQL 语句之后，需要检索和处理该语句所产生的结果。如果 SQL 语句是 SELECT 或 VALUES 以外的语句，那么在该语句执行之后，惟一需要做的是检查 CLI/ODBC 函数返回码，以确认该语句是否按预期执行。但是，如果执行的 SQL 语句是一个查询，那么可能还需要进行相应的处理来从产生的结果数据集中检索数据。

当查询返回多个行时，这些行被存储在与执行的 SQL 语句相关联的连接句柄和语句句柄所引用的数据存储区中。因此，可能需要执行以下步骤来从产生的结果数据集中检索数据：

确定产生的结果数据集的结构（即列的数量、列的数据类型、数据长度）。这可以通过执行 SQLNumResultCols()、SQLDescribeCol() 和 SQLColAttributes() 函数来完成。
使用 SQLBindCol() 函数将应用程序变量绑定到结果数据集中的列上（可选）。
重复地从产生的结果数据集读取下一行，并将之复制到绑定的应用程序变量中。这通常是通过在一个循环中重复地调用 SQLFetch() 函数来实现的。（每当读取一个新行时，步骤 2 中未绑定到应用程序变量绑定的列值可以通过调用 SQLGetData() 函数获得。）

在第一步中，首先分析所准备或执行的 SQL 语句，以确定产生的结果数据集的结构。如果 SQL 语句被硬编码到应用程序中，那么不需要这一步，因为产生的结果数据集的结构是已知的。但是，如果 SQL 语句是在应用程序运行时生成的，那么就必须查询该语句产生的结果数据集，以获得该信息。

知道结果数据集的结构之后，可以将一个或多个应用程序变量绑定到结果数据集中特定的列上（就像将应用程序变量绑定到 SQL 语句参数标记一样）。在这种情况下，应用程序变量被用作输出参数，而不是输入参数，当调用 SQLFetch() 函数时，就会检索出数据并直接写入这些变量中。但是，由于可以使用 SQLGetData() 函数从结果数据集中检索数据，因此应用程序变量/列绑定是可选的。

在第三步中，通过重复调用 SQLFetch() 函数（通常在循环中），检索存储在结果数据集中的数据，直到数据被检索完。如果已经将应用程序变量绑定到结果数据集中的列上，那么每当调用 SQLFetch() 时，这些变量的值就会自动更新。另一方面，如果没有执行列绑定，那么可以使用 SQLGetData() 函数将数据从特定列中复制到适当的应用程序变量中。SQLGetData() 函数还可用于在多个小部分中检索大型可变长度的列数据值（当使用绑定应用程序变量时不能这样做）。结果数据集中存储的所有数据都可以使用这两种方法的任意组合来检索。

清单 2 展示了在用 C 语言编写的 CLI/ODBC 应用程序中，如何将一个应用程序变量绑定到结果数据集中的列上。它还展示了通常如何通过重复地调用 SQLFetch()检索结果数据集中的数据。

您也许还记得，事务（也称工作单元）是组合成一个单元的一个或多个 SQL 操作的序列，它们通常位于一个应用程序进程中。个给定的事务可以包含从一个单一操作到成百甚至上千个任意数目的 SQL 操作，主要取决于何为您的业务逻辑中所认为的单步。事务很重要，因为一个事务的开始和终止可以确定数据库中的数据一致性点。在一个事务中，要么将事务中执行的所有操作的结果持久地应用到数据库中（提交），要么回改所有操作的结果（回滚），并使数据库返回到启动事务之前所处的状态。

从事务处理的角度来看，可以将 CLI/ODBC 应用程序配置为以两种模式中的一种来运行：自动提交或手动提交。当使用自动提交模式时，每个 SQL 语句都被当作一个完整的事务，在 SQL 语句成功执行之后，每个事务都自动提交。对于除 SELECT SQL 语句以外的语句，在语句执行之后就立即发生提交操作。对于 SELECT 语句，当用于处理结果数据集的游标关闭后，就立即发生提交操作。（记住，CLI/ODBC 必要时会自动声明并打开一个游标。）自动提交模式是默认的提交模式，对于简单的 CLI/ODBC 应用程序通常就足够了。但是，对于一些大型应用程序，尤其是执行更新操作的那些应用程序，在建立一个数据源连接之后，应该立即切换为手动提交模式。用于切换到手动提交模式的函数调用如下所示：

当使用手动提交模式时，会在应用程序首次访问一个数据源时隐式地开始事务，在调用 SQLEndTran() 函数时显式地结束事务。这个 CLI/ODBC 函数用于回滚或提交当前事务所做的所有更改。因此，从数据源第一次被访问开始，到调用 SQLEndTran() 函数为止，这段时间内在数据源上执行的所有操作都被当作一个事务。

当 SQL 语句的结果被处理完毕，并且不再需要事务处理开始时分配的 SQL 语句数据存储区时，应该释放为该数据存储保留的内存。要释放与特定语句句柄相关联的数据存储区，可以调用 SQLFreeHandle() 函数并指定 SQL_HANDLE_STMT 选项和适当的语句句柄（例如 SQLFreeHandle(SQL_HANDLE_STMT, StmtHandle)）来实现。当被调用时，CLI/ODBC 函数执行以下任务：

取消对所有之前绑定的参数应用程序变量的绑定
取消对所有之前绑定的列应用程序变量的绑定
关闭已打开的游标，并丢弃其结果
销毁指定的句柄，并释放所有相关资源

如果一个语句句柄没有被释放，那么它还可以用于处理其他 SQL 语句。

在 CLI/ODBC 应用程序终止，并且控制被返回到操作系统之前，应该终止已建立的所有数据源连接，并释放初始化期间分配的所有资源。（通常，这些资源由一个环境数据存储区和一个或多个连接数据存储区组成。）

通过调用 SQLDisconnect() 函数并指定适当的连接句柄，终止已有的数据库连接。为了释放相应的连接数据存储区，用 SQL_HANDLE_DBC 选项调用 SQLFreeHandle() 函数并指定适当的连接句柄。当之前分配的所有连接数据存储区都被释放后，通过用 SQL_HANDLE_ENV 选项并指定适当的环境句柄来调用 SQLFreeHandle() 函数，释放与连接数据存储区相关联的环境数据存储区。

检查了构成所有 CLI/ODBC 应用程序的基本组件之后，现在就让我们来看一看如何连接这些组件以产生与 DB2 数据库交互的 CLI/ODBC 应用程序。下面是用 C 语言编写的一个简单的 CLI/ODBC 应用程序，该应用程序获取并打印职位为 DESIGNER 的所有雇员的雇员编号和姓氏：

阅读(292308) | 评论(0) | 转发(0) |

上一篇：DB2 9 应用开发（733 考试）认证指南，第 5 部分: CLI/ODBC 编程(2)

下一篇：DB2 9 应用开发（733 考试）认证指南，第 5 部分: CLI/ODBC 编程(4)

给主人留下些什么吧！~~

感谢所有关心和支持过ChinaUnix的朋友们

16024965号-6

构造 CLI/ODBC 应用程序

所有 CLI/ODBC 应用程序都要被构造来执行以下三个不同的任务：

初始化
事务处理
终止