使用ODBC API 连接数据库.docx
- 文档编号:11273936
- 上传时间:2023-02-26
- 格式:DOCX
- 页数:34
- 大小:147.43KB
使用ODBC API 连接数据库.docx
《使用ODBC API 连接数据库.docx》由会员分享,可在线阅读,更多相关《使用ODBC API 连接数据库.docx(34页珍藏版)》请在冰豆网上搜索。
使用ODBCAPI连接数据库
主要内容:
ØODBCAPI的体系结构
Ø使用ODBCAPI开发数据库应用程序的一般步骤
Ø使用函数SQLAllocHandle分配句柄
Ø使用函数SQLConnect、SQLDriverConnect、SQLBrowseConnect连接数据源
Ø使用函数SQLPrepare和SQLExecute执行SQL语句
Ø使用函数SQLBindCol()绑定数据库字段
Ø使用函数SQLGetDiagRec和SQLGetDiagField处理错误
Ø使用函数SQLFetch移动数据库记录指针
Ø使用ODBCAPI进行事务处理
Ø使用函数SQLDisconnect断开数据源的连接
目录
ODBCAPI基础3
ODBCAPI句柄3
ODBC数据类型5
ODBC诊断5
使用ODBC API变成建立应用程序7
ODBC API编程模型概述7
连接数据库10
准备并执行SQL语句14
获取记录集16
记录的添加、删除和更新18
错误处理20
事务处理21
断开数据源连接并释放环境句柄23
ODBCAPI基础
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_CHAR
CHAR(n)
SQL_VACHAR
VACHAR(n)
SQL_LONGVACHAR
LONGVACHAR
SQL_WCHAR
WCHAR(n)
2、C数据类型
ODBC定义了由应用程序变量及其相应的数据标识符所使用的C数据类型。
在其他的事情中,它们也用于绑定至结果集列和语句参数的缓冲区。
ODBC还定义了一个从每个数据类型到一个C数据类型的默认映射。
要使用默认映射,应用程序可指定SQL_C_DEFAULT类型标识符。
但是,出于互操作性的原因,不主张使用这个标识符。
在ODBC1.x版本中定义的所有整数C数据类型都是带符号的。
在ODBC2.0中添加了不带符号的C数据类型及其相应的数据标识符。
ODBC中定义的常用C数据类型如表所示,此处列出了部分常用的类型,详细资料参见ODBC的技术手册:
C类型标识
ODBCC类型定义
C类型
SQL_C_CHAR
SQLCHAR
Unsignedchar*
SQL_C_SSHORT
SQLSMALLINT
Shortint
SQL_C_USHORT[j]
SQLUSMALLINT
Unsignedshortint
SQL_C_SLONG[j]
SQLINTEGER
Longint
ODBC诊断
为了在程序开发过程中调试程序,发现程序错误,ODBCAPI通过两种方式返回有关ODBCAPI函数执行的信息:
返回码和诊断记录。
返回码返回函数执行的返回值,说明函数执行成功与否;诊断记录说明函数执行的详细信息。
1、返回码(ReturnCode)
每一个ODBCAPI函数都返回一个代码——返回码,指示函数执行的成功与否。
如果函数调用成功,返回码为SQL_SUCCESS(指示可通过诊断记录获取相关操作的详细信息)或SQL_SUCCESS_WITH_INFO(指示应用程序执行结果带有警告信息,可通过诊断记录获取详细的信息)。
如果函数调用失败,返回码为SQL_ERROR。
下面一段代码根据函数SQLFetch()执行的返回码,判断函数执行的成功与否,从而据此进行相应的处理:
SQLRETURNrtcode;
SQLHSTMThstmt;
While(rtcode=SQLFetch(hstmt)!
=SQL_NO_DATA)
{
If(rtcode==SQL_SUCCESS_WITH_INFO)
{
//显示警告信息
}else
{
//显示出错信息
break;
}
//函数调用成功
}
如果程序执行错误,返回码为SQL_INVALID_HANDLE,程序无法执行,而其他的返回码都带有程序执行信息。
2、诊断记录
每个ODBCAPI函数都能产生一系列的反应操作信息的诊断记录,这些诊断记录都放在相关联的ODBC句柄中,直到下一个使用同一个句柄的函数调用,该诊断记录一直存在。
诊断记录的大小没有限制。
诊断记录有两种:
头记录(HeadRecord)和状态记录(StatusRecord)。
头记录是第一版权记录(Record0),后面的记录为状态记录。
诊断记录有许多的域组成,这些域在头记录和状态记录中是不同的。
可以用SQLGetDiagField函数获取诊断记录中的特定的域,另外,可以使用SQLGetDiagRec()函数获取诊断记录中一些常用的域,如SQLSTATE、原始错误号等。
(1)头记录
头记录的各个域中包含了一个函数执行的通用信息,无论函数执行成功与否,只要不返回SQL_INVALID_HANDLE,都会生成头记录。
(2)状态记录
状态记录中的每个域包含了驱动管理器、ODBC驱动程序或数据源返回的特定的错误或警告信息,包括SQLSTATE、原始错误码、诊断信息、列号和行号等。
只有函数执行返回SQL_ERROR、SQL_STILL_EXEUTING、SQL_SUCCESS_WITH_INFO、SQL_NEED_DATA或SQL_NO_DATA时,才会生成诊断记录。
(3)使用SQLGetDiagRec和SQLGetDiagField
应用程序可以调用SQLGetDiagRec和SQLGetDiagField函数获取诊断信息。
对于给定的句柄,这两个函数返回最近使用句柄的函数的诊断信息。
当有使用该句柄的函数执行时,句柄记录所记录的原有的诊断信息被覆盖。
如果函数执行后产生多个状态记录,程序必须多次调用这两个函数以获取信息。
例如,下面的代码提示符提供给用户使用SQL语句并执行它。
如果返回一些真消息,则它调用SQLGetDiagField来取得状态记录书并调用SQLGetDiagRec来从那些记录中取得SQLSTATE、本地错误代码、诊断消息:
SQLCHAR sqlState[6], SQLStmt[100], Msg[SQL_MAX_MESSAGE_LENGTH];
SQLINTRGER NativeError;
SQLSMALLINT I,MsgLen;
SQLRETURN rc1, rc2;
SQLHSTME Hstmt;
//Prompt the user for an SQL statement
GetSQLStmt(SQLStmt);
//执行SQL语句返回错误结果
rc1 = SQLExecDirect(hstmt, SQLStmt, SQL_NTS);
if((rc1 == SQL_SUCCESS_WITH_INFO) || (rc1 == SQL_ERROR))
{
//得到状态记录
i = 1;
while((rc2 = SQLGetDiagRec(SQL_HANDLE_STMT, hstmt, i, SqlState, &NativeError, Msg, sizeof(Msg), &MsgLen)) !
= SQL_NO_DATA)
{
DisplayError(SqlState, NativeError, Msg, MsgLen);
i++;
}
}
if((rc1 == SQL_SUCCESS) || (rc1 == SQL_SUCCESS_WITH_INFO))
{
//如果必要就处理结果
}
使用ODBC API变成建立应用程序
ODBC API编程模型概述
使用ODBCAPI编写的程序运行时相对要简洁、高效。
一般,编写ODBC程序主要有以下几个步骤:
●为ODBC分配环境句柄
●分配一个连接句柄
●用SQL命令分配一个语句句柄
●执行该命令返回结果集
●断开同数据源的连接
●释放ODBC环境
为了更清楚的阐述ODBCAPI的调用步骤以及涉及到的重要函数,总结了一个表来说明ODBCAPI应用的结构:
所有ODBC应用程序都必须遵循上图的通用ODBCAPI调用
注册数据源(Access数据库employers.mdb,其中只有一张表emp,包含三个字段:
职工号<数字,关键字>、职工名称<文本>、工作<文本>)
//添加ODBC数据源
voidCDemo1App:
:
SetODBCSource()
{
CStringstrAccessPath=m_strExePath+“employers.mdb”;
intiLen=strAccessPath.GetLength();
charcpConfig[MAX_PATH];//构造注册字符串
strcpy(cpConfig,“DSN=daliu\0”);
strcpy(cpConfig+10,“DBC=”);
strcpy(cpConfig+14,strAccessPath);
strcpy(cpConfig+14+iLen,“\0”);
strcpy(cpConfig+15+iLen,“DEFAULTDIR=”);
strcpy(cpConfig+15+iLen+11,m_strExePath);
strcpy(cpConfig+25+iLen+m_strExePath.GetLength(),“\0\0”);
//注册数据源
if(!
SQLConfigDataSource(NULL,ODBC_ADD_SYS_DSN,
“MicrosoftAccessDriver(*.mdb)\0”,cpConfig))
{
//AfxMessageBox(“addodbcsourcefailed!
”);
}
}
连接数据库
连接数据库包括初始化环境句柄、初始化连接句柄以及连接数据源等几个步骤。
1、初始化环境句柄
(1)分配环境句柄
对于任何ODBC应用程序来说,第一步的工作是装在驱动程序管理器,然后初始化ODBC环境,分配句柄
首先声明一个SQLHENV类型的变量,然后调用SQLAllocHandle,向其中传递分配的SQLHENV类型的变量地址和SQL_HANDLE_ENV选项,代码如下:
//分配环境句柄
m_retcode=SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&m_henv);if((m_retcode!
=SQL_SUCCESS)&&(m_retcode!
=SQL_SUCCESS_WITH_INFO)){
AfxMessageBox(“分配环境句柄失败”);
returnFALSE;
}
其中:
m_henv是要分配的环境句柄,m_retcode是返回码。
执行该调用语句后,驱动程序分配一个结构,该结构中存放环境变量,然后返回对应于该环境的环境句柄。
一个应用程序对应于一个环境,但是同一个环境可以用于不同数据源的连接,可以使用多个线程,应用程序完成数据访问任务,应调用函数SQLFreeHandle()函数释放当前分配的环境。
(2)设置环境属性
应用程序在完成环境的分配后,接着调用函数SQLSetEnvAttr设置环境属性,注册ODBC的版本号,说明应用程序所遵从的标准是ODBC2.x还是ODBC3.x,相关代码如下所示。
使用不同的版本,相同的参数作用会不相同,具体的说明参见MSDN。
/*设置ODBC版本的环境属性*/
m_retcode=SQLSetEnvAttr(m_henv,SQL_ATTR_ODBC_VERSION,(void
*)SQL_OV_ODBC3,0);
if((m_retcode!
=SQL_SUCCESS)&&(m_retcode!
=SQL_SUCCESS_WITH_INFO)){
ReportError(m_henv,SQL_HANDLE_ENV,“设置ODBC版本号时失败”);returnFALSE;
}
其中m_henv是环境句柄,m_retcode是返回码,ReportError是一个处理错误的函数。
2、初始化连接句柄
(1)分配连接句柄
分配环境句柄之后,在建立至数据源的连接之前,必须分配一个连接句柄,每一个到数据源的连接对应于一个连接句柄。
首先,程序定义一个SQLHDBC类型的变量,用于存放连接句柄,然后调用SQLAllocHandle函数分配句柄。
//分配连接句柄
m_retcode=SQLAllocHandle(SQL_HANDLE_DBC,m_henv,&m_hdbc);
if((m_retcode!
=SQL_SUCCESS)&&(m_retcode!
=SQL_SUCCESS_WITH_INFO)){
ReportError(m_henv,SQL_HANDLE_ENV,“分配连接句柄失败!
”);
returnFALSE;
}
其中m_henv是环境句柄,m_hdbc是要分配的连接句柄,m_retcode是返回码
(2)设置连接属性
连接属性表示了一个连接的特性,如登录等待时间、使用的光标库等。
所有的连接属性都有默认值,也可以通过调用函数SQLSetConnectAttr()设置,调用函数SQLGetConnectAttr()可获取这些连接属性的当前设置值,这两个函数定义如下:
SQLSetConnectAttr(
SQLHDBCConnectionHandle,
SQLINTEGERAttribute,
SQLPOINTERValuePtr,
SQLINTRGERStringLength
);
SQLRETURNSQLGetConnectAttr(
SQLHDBCConnectionHandle,
SQLINTEGERAttribute,
SQLPOINTERValuePtr,
SQLINTEGERBufferLength,
SQLINTEGER*StringLengthPtr
);
3、连接数据源
完成连接属性的设置之后,就可以建立到数据源的连接了。
对于不同的程序和用户接口,可以用不同的函数建立连接:
SQLConnect、SQLDriverConnect、SQLBrowseConnect
(1)SQLConnect
该函数提供了最为直接的程序控制方式,只要提供数据源名称、用户ID和口令,就可以进行连接了。
其定义如下:
SQLRETURNSQLConnect(
SQLHDBCConnectionHandle,//连接句柄
SQLCHAR*ServerName,//数据源名称
SQLSMALLINTNameLength1,//数据源名称长度
SQLCHAR*UserName,//用户ID
SQLSMALLINTNameLength2,//用户ID长度
SQLCHAR*Authentication,//用户口令
SQLSMALLINTNameLength3//用户口令长度
);
//连接数据源
m_retcode=SQLConnect(m_hdbc,(SQLCHAR*)cpServerName,SQL_NTS,
(SQLCHAR*)cpUserName,SQL_NTS,
(SQLCHAR*)cpPassword,SQL_NTS);
if((m_retcode!
=SQL_SUCCESS)&&(m_retcode!
=SQL_SUCCESS_WITH_INFO)){
ReportError(m_hdbc,SQL_HANDLE_DBC,“连接数据库失败!
”);
returnFALSE;}
(2)SQLDriverConnect
该函数用一个连接字符串建立至数据源的连接,他可以提供比SQLConnect函数的3个参数更多的信息,可以让用户输入必要的连接信息,使用系统中还没有定义的
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 使用ODBC API 连接数据库 使用 ODBC 连接 数据库
![提示](https://static.bdocx.com/images/bang_tan.gif)