分享
 
 
 

使用ODBC访问数据库(一)

王朝other·作者佚名  2006-01-09
窄屏简体版  字體: |||超大  

使用ODBC API之前要用到的头文件和LIB库

#include "sql.h" // This is the the main include for ODBC Core functions.

#include "sqlext.h" // This is the include for applications using the Microsoft SQL Extensions

#include "sqltypes.h" // This file defines the types used in ODBC

#include "sqlucode.h" // This is the the unicode include for ODBC Core functions

#include "odbcss.h" // This is the application include file for the SQL Server driver specific defines.

#pragma coment(lib, "odbc32.lib")

ODBC API的返回值

ODBC API的返回值定义为:SQLRETURN。在成功时返回值为:SQL_SUCCESS, SQL_SUCCESS_WITH_INFO;在失败时返回错误代码。一点需要注意的是如果ODBC返回值为:SQL_SUCCESS_WITH_INFO并不表明执行完全成功,而是表明执行成功但是带有一定错误信息。当执行错误时ODBC返回的是一个错误信息的结果集,你需要遍历结果集合中所有行,这点和后面讲到的查询SQL语句执行结果集的思路很类似。

SQLAllocHandle 创建ODBC句柄

SQLRETURN SQLAllocHandle (

SQL SMALLINT HandleType, // 需要申请的句柄类型

SQLHANDLE InputHandle, // 输入句柄

SQLHANDLE * OutputHandlePtr); // 输出句柄,即在第一参数指定需要申请的句柄

第一参数HandleType的取值可以为:

1. SQL_HANDLE_ENV

2. SQL_HANDLE_DBC

3. SQL_HANDLE_STMT

SQLConnect 连接数据库

SQLRETURN SQLConnect (

SQLHDBC ConnectionHandle, // DBC句柄,hdbc

SQLCHAR * ServerName, // 为ODBC的DSN名称

SQLSMALLINT NameLength1, // 指明参数ServerName的长度(可以用SQL_NTS)

SQLCHAR * UserName, // 数据库用户名

SQLSMALLINT NameLength2, // 指明参数UserName的长度(可以用SQL_NTS)

SQLCHAR * Authentication, // 数据库用户密码

SQLSMALLINT NameLength3) // 指明参数Authentication的长度(可以用SQL_NTS)

例如:

SQLConnect (

hdbc,

(SQLTCHAR*)szDSN, SQL_NTS,

(SQLTCHAR*)szUserId, SQL_NTS,

(SQLTCHAR*)szPassword, SQL_NTS);

SQLExecDirect 直接执行SQL语句

SQLRETURN SQLExecDirect (

SQLHSTMT StatementHandle, // STMT句柄

SQLCHAR * StatementText, // SQL语句

SQLINTEGER TextLength) // 参数StatementText的长度,可以用SQL_NTS

如果函数执行成功,你将会得到一个结果集,否则将返回错误信息。

获取SQL语句执行的结果

对于SQL查询语句,ODBC会返回一个光标,与光标对应的是一个结果集合(可以理解为一个表格)。开发人员利用光标来浏览所有的结果,你可以利用ODBC API函数移动光标,并且获取当前光标指向的行的列字段的数值。此外还可以通过光标来对光标当前所指向的数据进行修改,而修改会直接反映到数据库中。

SQLFetch 移动光标

SQLRETURN SQLFetch (SQLHSTMT StatementHandle);

在你调用SQLExecDirect执行SQL语句后,你需要遍历结果集来得到数据。StatementHandle是STMT句柄,此句柄必须是被执行过。当调用SQLFetch 函数后,光标会被移动到下一条记录处,当光标移动到记录集的最后一条,函数将会返回SQL_NO_DATA。

SQLGetData 得到光标处的某列的值

SQLRETURN SQLGetData (

SQLHSTMT StatementHandlem, // STMT句柄

SQLUSMALLINT ColumnNumber, // 列号,以1开始

SQLSMALLINT TargetType, // 数据缓冲区(TargetValuePtr)的C语言类型

SQLPOINTER TargetValuePtr, // 数据缓冲区

SQLINTEGER BufferLength, // 数据缓冲区(TargetValuePtr)的长度

SQLINTEGER * StrLen_or_IndPtr); // 返回当前字段得到的字节长度

SQLBindCol通过列绑定获得字段数据

SQLRETURN SQLBindCol (

SQLHSTMT StatementHandle, // STMT语句

SQLUSMALLINT ColumnNumber, // 列号,以1开始

SQLSMALLINT TargetType, // 数据缓冲区(TargetValuePtr)的C语言类型

SQLPOINTER TargetValuePtr, // 数据缓冲区

SQLINTEGER BufferLength, // 数据缓冲区(TargetValuePtr)的字节长度

SQLINTEGER * StrLen_or_IndPtr); // 返回当前字段得到的字节长度

在从结果集中读取字段值时可以利用SQLGetData,但为了速度可以利用列绑定(SQLBindCol)的方式,在每次移动光标后让ODBC将数据传送到指定的变量中

SQLNumResultCols 得到结果集中列数

SQLRETURN SQLNumResultCols (

SQLHSTMT StatementHandle, // STMT句柄

SQLSMALLINT * ColumnCountPtr); // 返回的列数

SQLRowCount 执行SQL语句后得到影响的行数

SQLRETURN SQLRowCount (

SQLHSTMT StatementHandle, // STMT句柄

SQLINTEGER * RowCountPtr); // 被影响的数据的行数

你可以通过SQLExecDirect执行SQL语句来插入,修改和删除数据,在执行插入,修改和删除的SQL语句后就可以通过SQLRowCount函数来得到被影响的数据的行数。

SQLDescribeCol 得到结果集中列的描述

SQLRETURN SQLDescribeCol (

SQLHSTMT StatementHandle, // STMT句柄

SQLSMALLINT ColumnNumber, // 需要得到的列的序号,从1开始计算

SQLCHAR * ColumnName, // 得到列的名称

SQLSMALLINT BufferLength, // 指明ColumnName参数的最大长度

SQLSMALLINT * NameLengthPtr, // 返回列名称的长度

SQLSMALLINT * DataTypePtr, // 返回列的ODBC数据类型,见表

SQLUINTEGER * ColumnSizePtr, // 返回列的长度

SQLSMALLINT * DecimalDigitsPtr, // 当列为数字类型时返回小数点后数据的位数

SQLSMALLINT * NullablePtr); // 指明该列是否允许空值

SQLSetStmtAttr设置ODBC光标类型

SQLRETURN SQLSetStmtAttr (

SQLHSTMT StatementHandle, // STMT句柄

SQLINTEGER Attribute, // 指定需要设置的属性类型

SQLPOINTER ValuePtr, // 提供的参数值

SQLINTEGER StringLength); // 指定参数的长度,当参数是整数时设置为

// SQL_IS_INTEGER, 当参数是字符串是设置

// 为字符串长度或者是SQL_NTS

函数SQLSetStmtAttr可以让我们在ODBC中可以使用不同的光标类型

Attribute

ValuePtr

作用

SQL_ATTR_ASYNC_ENABLE

整数,取值为:

SQL_ASYNC_ENABLE_OFF,

SQL_ASYNC_ENABLE_ON

是否使用异步执行功能

SQL_ATTR_QUERY_TIMEOUT

设置一个合法的整数

SQL语句执行时的超时秒数,设置为0表示无超时

SQL_ATTR_CURSOR_TYPE

整数,取值为:

SQL_CURSOR_FORWARD_ONLY,

SQL_CURSOR_STATIC,

SQL_CURSOR_DYNAMIC,SQL_CURSOR_KEYSET_DRIVEN

设置光标的类型

1. 向前光标:SQL_CURSOR_FORWARD_ONLY,光标仅仅向前滚动。

2. 静态光标:SQL_CURSOR_STATIC,结果集的数据是静态的,这就是说明在执行查询后,返回的结果集的数据不会再改变,即使是有其他程序更新了数据库中的记录,结果集中的记录也不会发生改变。

3. 动态光标:SQL_CURSOR_DYNAMIC,在光标打开以后,当结果集中的行所对应的数据值发生变化时,其变化能够反映到光标所对应的结果集上,这些变化包括:字段的修改,添加,结果集中行的顺序变化。但是请注意如果行被删除则无法在当前结果集中反映出,因为被删除的行不再出现在当前的结果集中。动态光标所对应的结果集在数据发生变化时会被重建。例如,假设动态光标已获取到了两行,然后,另一应用程序更新了这两行中的一行,并删除了另一行,如果动态游标再试图获取那些行,它将不能检测已删除的行(因为当前结果集中只有一行,但是不要利用这个办法去检测被删除的行,因为出现这种情况还可能是因为行的数据被改变后不能再满足查询条件),而是返回已更新行的新值。

4. 键集光标:SQL_CURSOR_KEYSET_DRIVEN,和上面的动态光标所不同的是键集光标能够检测到行的删除和修改,但是无法检测到行的添加和结果集顺序变化。因为在光标创建时就创建了整个结果集,结果集合中记录和顺序已经被固定,这一点和静态光标一样。所以键集光标可以说是一种介于静态光标和动态光标之间的光标类型。

如:SQLSetStmtAttr (hstmt, SQL_ATTR_CURSOR_TYPE, (SQLPOINTER) SQL_CURSOR_KEYSET_DRIVEN, 0);

SQLFetchScroll利用可滚动光标进行查询

SQLRETURN SQLFetchScroll (

SQLHSTMT StatementHandle, // STMT语句

SQLSMALLINT FetchOrientation, // 光标滚动的方式,见下表

SQLINTEGER FetchOffset); // 光标滚动的位置

前面介绍的SQLFetch函数只能够让光标向前移动,但在很多时候我们需要光标能够前后移动。我们需要利用另一个函数SQLFetchScroll,但是再这之前请利用SQLSetStmtAttr正确设置光标类型。

FetchOrientation

含 义

SQL_FETCH_NEXT

滚动到下一行,这时候调用相当与SQLFetch,参数FetchOffset将被忽略(用0值)

SQL_FETCH_PRIOR

滚动到上一行,参数FetchOffset将被忽略(用0值)

SQL_FETCH_FIRST

滚动到第一行,参数FetchOffset将被忽略(用0值)

SQL_FETCH_LAST

滚动到最后一行,参数FetchOffset将被忽略(用0值)

SQL_FETCH_ABSOLUTE

滚动到参数FetchOffset指定的绝对行

SQL_FETCH_RELATIVE

由当前位置滚动到参数FetchOffset指定的相对行,FetchOffset大于0表示向前滚动,FetchOffset小于0表示向后滚动

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有