云数据库 GaussDB-SQLGetDiagRec:注意事项

时间:2023-11-01 16:22:49

注意事项

SQLGetDiagRec不发布自己的诊断记录。它用下列返回值来报告它自己的执行结果:

  • SQL_SUCCESS:函数成功返回诊断信息。
  • SQL_SUCCESS_WITH_INFO:*MessageText太小以致不能容纳所请求的诊断信息。没有诊断记录生成。
  • SQL_INVALID_HANDLE:由HandType和Handle所指出的句柄是不合法句柄。
  • SQL_ERROR:RecNumber小于等于0或BufferLength小于0。

如果调用ODBC函数返回SQL_ERROR或SQL_SUCCESS_WITH_INFO,可调用SQLGetDiagRec返回诊断信息值SQLSTATE,SQLSTATE值的如下表。

表2 SQLSTATE值

SQLSATATE

错误

描述

HY000

一般错误

未定义特定的SQLSTATE所产生的一个错误。

HY001

内存分配错误

驱动程序不能分配所需要的内存来支持函数的执行或完成。

HY008

取消操作

调用SQLCancel取消执行语句后,依然在StatementHandle上调用函数。

HY010

函数系列错误

在为执行中的所有数据参数或列发送数据前就调用了执行函数。

HY013

内存管理错误

不能处理函数调用,可能由当前内存条件差引起。

HYT01

连接超时

数据源响应请求之前,连接超时。

IM001

驱动程序不支持此函数

调用了StatementHandle相关的驱动程序不支持的函数

support.huaweicloud.com/distributed-devg-v2-opengauss/gaussdb-v5r2c10-1558.html