3使用ODBC API访问数据库

主要内容：ODBCAPI的体系结构使用ODBCAPI开发数据库应用程序的一般步骤使用函数SQLAllocHandle分配句柄使用函数SQLConnect、SQLDriverConnect、SQLBrowseConnect连接数据源使用函数SQLPrepare和SQLExecute执行SQL语句使用函数SQLBindCol()绑定数据库字段使用函数SQLGetDiagRec和SQLGetDiagField处理错误使用函数SQLFetch移动数据库记录指针使用ODBCAPI进行事务处理使用函数SQLDisconnect断开数据源的连接目录ODBCAPI基础.................................................................................................................................3ODBCAPI句柄..........................................................................................................................3ODBC数据类型........................................................................................................................5ODBC诊断................................................................................................................................6使用ODBCAPI变成建立应用程序.................................................................................................8ODBCAPI编程模型概述..........................................................................................................8连接数据库.............................................................................................................................11准备并执行SQL语句............................................................................................................16获取记录集.............................................................................................................................18记录的添加、删除和更新.....................................................................................................20错误处理.................................................................................................................................23事务处理.................................................................................................................................23断开数据源连接并释放环境句柄.........................................................................................25ODBCAPI基础ODBCAPI句柄ODBCAPI实现数据库操作的手段是句柄。在ODBC中，使用不同的句柄（HANDLE）来标志环境（environment）、连接（Connection）、语句（statement）、描述符（description）等。句柄是一个应用程序变量，系统用它来存储关于应用程序的上下文信息和应用程序所用到的一些对象。1、环境句柄环境是存取数据的全局性背景，与环境相关的是全局的所有信息。例如：环境状态、当前环境状态诊断、当前在环境上分配的连接句柄、每个环境属性的当前设置。在实现ODBC的一段代码（DriverManager或者驱动程序）中，环境句柄标识包含这个信息的结构。环境句柄在ODBC应用程序中不经常用。他们经常用来调用SQLDataSources和SQLDrivers，又是用来调用函数SQLAllocHandle、SQLEndTran、SQLFreeHandle、SQLGetDiagField和SQLGetDiagReg。环境句柄ODBC中整个上下文的句柄，使用ODBC的每个程序从创建环境句柄开始、以释放环境句柄结束。所有其他的句柄都由环境句柄的上下文来管理。环境句柄在每个应用程序中只能创建一个。2、连接句柄一个连接包含一个驱动程序和一个数据源。连接句柄标识每个连接。连接句柄定义使用哪个驱动程序和该驱动程序使用的数据源。在执行一段ODBC（DriverManager或者驱动程序）的代码中，连接句柄标志一个包含连接信息的结构。比如：连接状态、当前连接层诊断、语句句柄和当前连接上分配的描述符、每个连接属性的当前设置。如果驱动程序支持多个同时连接，ODBC并不阻止多个同时的连接。因此，在特定的ODBC环境中，多个连接句柄可能指向不同的驱动程序和数据源、相同的驱动程序和不同的数据源甚至是与相同的驱动程序和数据源的多个连接。一些驱动程序限制他们支持的活动连接数目，SQLGetInfo中的SQL_MAX_DRIVER_CONNECTIONS选项可指定一个特定的驱动程序支持多少个活动连接。与数据源进行连接（SQLConnect、SQLDriverConnect或SQLBrowseConnect）、从数据源上断开（SQLDisconnect）、获取驱动程序及数据源信息（SQLGetInfo）、检索诊断（SQLGetDiagField和SQLGetDiagRec）和执行事务（SQLEndTran）时，都需要使用连接句柄。当设置和获取连接属性（SQLSetConnectAttr）及获取SQL语句内部格式（SQLNativeSql）时，也使用它们。在应用程序中，可在任何适当的时候连接或脱离数据源，但不要轻易的建立或脱离连接。3、语句句柄一个语句不只是一个SQL语句，它包含所有与那个SQL语句相关的信息，如任何由语句和语句执行中使用的参数建立的结果集。一个语句甚至不需要应用程序的SQL语句。例如，当在一个语句上执行如SQLTables这样的编目函数时，它执行返回表名列表的预定义SQL语句。每个语句由语句句柄标识。一个语句与单个的连接相关，并且在那个连接上可能有多个语句。一些驱动程序限制它们支持活动语句的数目，在SQLGetInfo中SQL_MAX_CONCURRENT_ACTIVITIES选项指定一个驱动程序在单个的连接上支持多少个活动的语句。如果它的结果是未确定的，那么语句被定义成“活动的”，其结果既不是结果集，也不是受INSERT、UPDATE、或DELETE语句影响的行数，或者用多个调用把数据发送到SQLPutData。在实现ODBC（DriverManager或驱动程序）的一段代码中，语句句柄标识一个包含语句信息的结构，如：语句状态、当前语句层诊断、应用程序变量绑定到语句参数和结果集列的地址、每个语句属性的当前设置。语句句柄在大多数ODBC函数中使用，它们用于函数绑定参数及结果集列（SQLBindParameter和SQLBindCol）、准备执行语句（SQLPrepare、SQLExecute和SQLExecDirect）、检索元数据（SQLColAttribute和SQLDescribeCol）、取结果（SQLFetch）和检索诊断（SQLGetDiagField和SQLGetDiagRec）。它们还在编目函数（SQLColumns，SQLTables等）和其他一些函数中使用。语句句柄使用SQLAllocHandle分配，使用SQLFreeHandle释放。4、描述符句柄从应用程序或驱动程序来看，描述符就是描述SQL语句的参数或结果集列的元数据集合。因此，描述符可用来担当如下4种角色：1)应用程序参数描述符（APD）：包含绑定到SQL语句中参数的应用程序缓冲区的信息，如它们的地址、长度和C数据类型。2)实现参数描述符（IPD）：包含关于SQL语句中参数的信息，如它们的SQL数据类型、长度、和可控性（nullability）。3)应用程序行描述符（ARD）：包含绑定到结果集列的应用程序缓冲区的信息，如它们的地址、长度和C数据类型。4)实现行描述符（IRD）：包含结果集中列的信息，如它们的SQL数据类型、长度、和可控性。四种描述符（一种承担一个角色）在分配语句时自动分配，且总是与那条语句相关。称为自动分配描述符。应用程序还可用SQLAllocHandle分配描述符，称为显示分配描述符。它们根据连接进行分配，并且可以与那个连接上的一条或多条语句关联，来履行那些语句上的APD或ARD的职责。应用程序可完成ODBC中的大多数操作，而不明确使用描述符。然而，描述符可以为有些操作提供方便的快捷方式。例如，假设一个应用程序想从两套不同的缓冲区插入数据。要用第一套缓冲区，它会反复调用SQLBindParameter来把它们绑定至INSERT语句的参数中，然后再执行该语句。要使用第二套缓冲区，它就会重复这个过程。另一种方法就是在一个描述符中建立起对第一套缓冲区的绑定，在另一个描述符中建立对第二套缓冲区的绑定。要在两套绑定集间切换，只需调用SQLSetStmtAttr，并把正确的描述符作为APD与语句联系起来即可。ODBC数据类型ODBC使用两套数据类型：SQL数据类型和C数据类型。SQL数据类型用于数据源，而C数据类型用于应用程序的C代码。1、SQL数据类型SQL数据类型是在数据源中保存的数据类型。每个数据源都定义了它自己的SQL数据类型。ODBC定义类型标识符并且描述可能映射为每一种类型标识符的SQL数据类型的一种特征。在基本数据源中，每一种数据类型如何映射为ODBC的SQL类型标识符是由驱动程序制定的。ODBC中定义的常用SQL数据类型如表所示，此处列出了部分常用的类型，详细资料参见ODBC的技术手册：SQL类型标识SQL类型举例SQL_CHARCHAR(n)SQL_VACHARVACHAR(n)SQL_LONGVACHARLONGVACHARSQL_WCHARWCHAR(n)2、C数据类型ODBC定义了由应用程序变量及其相应的数据标识符所使用的C数据类型。在其他的事情中，它们也用于绑定至结果集列和语句参数的缓冲区。ODBC还定义了一个从每个数据类型到一个C数据类型的默认映射。要使用默认映射，应用程序可指定SQL_C_DEFAULT类型标识符。但是，出于互操作性的原因，不主张使用这个标识符。在ODBC1.x版本中定义的所有整数C数据类型