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

时间:2024-11-13 14:46:21

注意事项

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

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

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

表2 SQLSTATE值

SQLSTATE

错误

描述

HY000

一般错误

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

HY001

内存分配错误

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

HY008

取消操作

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

HY010

函数系列错误

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

HY013

内存管理错误

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

HYT01

连接超时

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

IM001

驱动程序不支持此函数

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

support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0119.html