unxiODBC编程(五)错误处理

ODBC的每个函数调用完毕都会返回一个SQLRETURN类型的返回码,这个类型其实是短整数(short int)类型,是一个16位的整数。返回值一共有下面几个值。

  1. SQL_SUCCESS,表示函数执行成功。

  2. SQL_SUCCESS_WITH_INFO,表示函数执行成功,但是返回了警告信息。比如连接数据库时返回密码即将过期信息。

  3. SQL_STILL_EXECUTING,表示调用函数时,前一个SQL语句还在执行。

  4. SQL_NEED_DATA,表示调用函数后,有动态数据需要提供。

  5. SQL_NO_DATA,表示调用函数后,没有数据返回。最典型的就是从结果集中Fetch数据时,取走最后一条数据后没有其他数据了,返回SQL_NO_DATA。

  6. SQL_ERROR,表示调用函数后,出现了错误。需要调用诊断函数获取错误信息。

  7. SQL_INVALID_HANDLE,表示调用函数时,传入了无效的句柄。

当调用的函数返回SQL_SUCCESS_WITH_INFO或SQL_ERROR时,可以调用SQLGetDiagRec()函数来返回错误信息,下面看看函数的原型和参数。

SQLRETURN SQLGetDiagRec(

SQLSMALLINT HandleType,

SQLHANDLE Handle,

SQLSMALLINT RecNumber,

SQLCHAR * SQLState,

SQLINTEGER * NativeErrorPtr,

SQLCHAR * MessageText,

SQLSMALLINT BufferLength,

SQLSMALLINT * TextLengthPtr);

HandleType是一个输入参数,是出错函数传入的句柄的类型。

Handle是一个输入参数,是出错函数传入的句柄。

RecNumber是一个输入参数,指示诊断记录的编号。记录从 1 开始编号。

SQLState是一个输出参数,返回状态码,该缓冲区将返回一个五个字符的 SQLSTATE 代码。

NativeErrorPtr是一个输出参数,返回错误码,该缓冲区将返回特定于数据源的本机错误代码。比如数据源是一个使用Oracle驱动程序的配置项,那么返回的就是Oracle的出错码。

MessageText是一个输出参数,指向返回诊断消息文本字符串的缓冲区的指针。用于存放出错信息。

BufferLength是一个输入参数,MessageText 缓冲区的长度(以字符为单位)。如果过小诊断函数会返回错误。

TextLengthPtr是一个输出参数,返回信息文本的总字符数。

看一个例子,连接数据库出错时,怎样处理错误。

SQLSMALLINT i;

SQLRETURN rc;

SQLINTEGER ecode;

SQLSMALLINT alen;

WCHAR msgtxt[8192];

WCHAR state[SQL_SQLSTATE_SIZE+1];

rc = SQLConnect(dbch, (SQLCHAR *)ds_name, SQL_NTS, (SQLCHAR *)usrname, SQL_NTS, (SQLCHAR *)passwd, SQL_NTS);

if ((rc == SQL_ERROR) || (rc == SQL_SUCCESS_WITH_INFO)) {

for (i=1; ; i++) {

rc = SQLGetDiagRec(SQL_HANDLE_DBC, dbch, i, (SQLCHAR *)state, &ecode,

(SQLCHAR *)msgtxt, (SQLSMALLINT)(sizeof(msgtxt) / sizeof(WCHAR)),

(SQLSMALLINT *)&alen);

if (rc == SQL_SUCCESS) {

fprintf(stderr, "ERROR: [%s] [%d] - %s\n", (char *)state, ecode, (char *)msgtxt);

} else if (rc == SQL_NO_DATA)

break;

else {

fprintf(stderr, "get diagnostic record error.\n");

break;

}

}

}

我们可以写一个函数来处理调用函数返回的结果。代码如下。

cpp 复制代码
/*
 * hndl  - 出错函数输入的句柄
 * htype - 出错函数输入的句柄类型
 * rc    - 出错函数的返回码
 */
SQLRETURN check_odbc_error(SQLHANDLE hndl, SQLSMALLINT htype, SQLRETURN rc)
{   
    SQLRETURN           ret;
    SQLSMALLINT         irec;
    SQLSMALLINT         alen; 
    SQLINTEGER          ecode; 
    WCHAR               msgtxt[8192]; 
    WCHAR               state[SQL_SQLSTATE_SIZE+1];


    switch (rc) {
        /* 函数返回成功,需要动态数据,没有数据了,直接返回原始码,不用处理错误 */
        case SQL_SUCCESS:
        case SQL_NEED_DATA:
        case SQL_NO_DATA:
            return (rc);

        /* 无效句柄 */
        case SQL_INVALID_HANDLE:
            fprintf(stderr, "Invalid handle!\n"):
            return (rc);

        /* 返回成功但有警告信息或者出错,处理错误记录 */
        case SQL_SUCCESS_WITH_INFO:
        case SQL_ERROR: 
            /* 从1开始取回每一条出错记录信息 */
            for (irec=1; ; irec++) {
                ret = SQLGetDiagRec(htype, hndl, irec, (SQLCHAR *)state, &ecode,
                    (SQLCHAR *)msgtxt, (SQLSMALLINT)(sizeof(msgtxt) / sizeof(WCHAR)),
                    (SQLSMALLINT *)&alen);

                if (ret == SQL_NO_DATA)
                    break;

                if (ret == SQL_SUCCESS) {
                    fprintf(stderr,"[%s] %d - %s\n",
                        (char *)state, ecode, (char *)msgtxt);
                } else {
                    fprintf(stderr, "Get diagnostic message error!\n");
                    break;
                }
            }

            return (rc);
    }

    return (0);
}

后面可以使用上面的函数来处理调用函数的返回码,简单实用,比如调用执行语句函数。

rc = SQLExecute(stmth);

check_odbc_error(stmth, SQL_HANDLE_STMT, rc);

如果你想看一些有关数据库的高技术含量的源代码和文档,请访问www.tomcoding.com网站。

相关推荐
FlashWarrior14 天前
RocksDB rate limiter讲解
c++·数据库开发·数据库架构
老赵的博客18 天前
mysql 学习
数据库开发
zh_1999522 天前
Spark面试精讲(上)
java·大数据·数据仓库·python·spark·数据库开发·数据库架构
在未来等你1 个月前
SQL进阶之旅 Day 13:CTE与递归查询技术
sql·数据分析·数据库开发·sql优化·递归查询·cte
weixin_307779131 个月前
Apache SeaTunnel部署技术详解:模式选择、技巧与最佳实践
大数据·数据库开发·数据库架构
lyh13441 个月前
【Rust 轻松构建轻量级多端桌面应用】
数据库开发
医只鸡腿子1 个月前
8.5 Q1|广州医科大学CHARLS发文 甘油三酯葡萄糖指数累积变化与 0-3期心血管-肾脏-代谢综合征人群中风发生率的相关性
数据库·数据挖掘·数据分析·健康医疗·数据库开发
weixin_307779131 个月前
Apache SeaTunnel 引擎深度解析:原理、技术与高效实践
大数据·flink·spark·数据库开发·etl
darkchink2 个月前
[LevelDB]LevelDB版本管理的黑魔法-为什么能在不锁表的情况下管理数据?
c语言·数据库·c++·oracle·数据库开发·dba·db
医只鸡腿子2 个月前
3.2/Q2,Charls最新文章解读
数据库·数据挖掘·数据分析·深度优先·数据库开发