SQLGetDiagField

SQL Server Native Client ODBC 驱动程序为 SQLGetDiagField 指定下列额外诊断字段。这些字段支持 SQL Server 应用程序的大量错误报告功能,并且可以在连接的 ODBC 连接句柄和 ODBC 语句句柄上生成的所有诊断记录中使用。这些字段在 sqlncli.h 中定义。

诊断记录字段

说明

SQL_DIAG_SS_LINE

报告生成错误的存储过程的行号。只有 SQL_DIAG_SS_PROCNAME 返回值时,SQL_DIAG_SS_LINE 的值才有意义。该值作为无符号 16 位整数返回。

SQL_DIAG_SS_MSGSTATE

错误消息的状态。有关错误消息状态的信息,请参阅 RAISERROR。该值作为有符号 32 位整数返回。

SQL_DIAG_SS_PROCNAME

根据需要生成错误的存储过程的名称。该值作为字符串返回。字符串的长度(以字符为单位)取决于 SQL Server 的版本。通过调用请求 SQL_MAX_PROCEDURE_NAME_LEN 值的 SQLGetInfo 可以确定此长度。

SQL_DIAG_SS_SEVERITY

关联错误消息的严重级别。该值作为有符号 32 位整数返回。

SQL_DIAG_SS_SRVNAME

发生错误的服务器的名称。该值作为字符串返回。字符串的长度(以字符为单位)由 sqlncli.h 中的 SQL_MAX_SQLSERVERNAME 宏定义。

包含字符数据的 SQL Server 特定诊断字段(即 SQL_DIAG_SS_PROCNAME 和 SQL_DIAG_SS_SRVNAME)将该数据作为以 Null 值结束的 ANSI 或 Unicode 字符串返回给客户端。如有必要,应根据字符宽度调整字符计数。或者,还可以使用可移植 C 数据类型(如 TCHAR 或 SQLTCHAR)确保正确的程序可变长度。

SQL Server Native Client ODBC 驱动程序报告标识最后尝试的 SQL Server 语句的以下额外动态函数代码。动态函数代码在诊断记录集的标头(记录 0)中返回,因此可在每次执行时(成功或失败)使用。

动态函数代码

来源

SQL_DIAG_DFC_SS_ALTER_DATABASE

ALTER DATABASE 语句

SQL_DIAG_DFC_SS_CHECKPOINT

CHECKPOINT 语句

SQL_DIAG_DFC_SS_CONDITION

在语句的 WHERE 或 HAVING 子句中引发的错误。

SQL_DIAG_DFC_SS_CREATE_DATABASE

CREATE DATABASE 语句

SQL_DIAG_DFC_SS_CREATE_DEFAULT

CREATE DEFAULT 语句

SQL_DIAG_DFC_SS_CREATE_PROCEDURE

CREATE PROCEDURE 语句

SQL_DIAG_DFC_SS_CREATE_RULE

CREATE RULE 语句

SQL_DIAG_DFC_SS_CREATE_TRIGGER

CREATE TRIGGER 语句

SQL_DIAG_DFC_SS_CURSOR_DECLARE

DECLARE CURSOR 语句

SQL_DIAG_DFC_SS_CURSOR_OPEN

OPEN 语句

SQL_DIAG_DFC_SS_CURSOR_FETCH

FETCH 语句

SQL_DIAG_DFC_SS_CURSOR_CLOSE

CLOSE 语句

SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR

DEALLOCATE 语句

SQL_DIAG_DFC_SS_DBCC

DBCC 语句

SQL_DIAG_DFC_SS_DENY

DENY 语句

SQL_DIAG_DFC_SS_DROP_DATABASE

DROP DATABASE 语句

SQL_DIAG_DFC_SS_DROP_DEFAULT

DROP DEFAULT 语句

SQL_DIAG_DFC_SS_DROP_PROCEDURE

DROP PROCEDURE 语句

SQL_DIAG_DFC_SS_DROP_RULE

DROP RULE 语句

SQL_DIAG_DFC_SS_DROP_TRIGGER

DROP TRIGGER 语句

SQL_DIAG_DFC_SS_DUMP_DATABASE

BACKUP 或 DUMP DATABASE 语句

SQL_DIAG_DFC_SS_DUMP_TABLE

DUMP TABLE 语句

SQL_DIAG_DFC_SS_DUMP_TRANSACTION

BACKUP 或 DUMP TRANSACTION 语句。同时,如果启用 trunc. log on chkpt. 数据库选项,则还针对 CHECKPOINT 语句返回。

SQL_DIAG_DFC_SS_GOTO

GOTO 控制流语句

SQL_DIAG_DFC_SS_INSERT_BULK

INSERT BULK 语句

SQL_DIAG_DFC_SS_KILL

KILL 语句

SQL_DIAG_DFC_SS_LOAD_DATABASE

LOAD 或 RESTORE DATABASE 语句

SQL_DIAG_DFC_SS_LOAD_HEADERONLY

LOAD 或 RESTORE HEADERONLY 语句

SQL_DIAG_DFC_SS_LOAD_TABLE

LOAD TABLE 语句

SQL_DIAG_DFC_SS_LOAD_TRANSACTION

LOAD 或 RESTORE TRANSACTION 语句

SQL_DIAG_DFC_SS_PRINT

PRINT 语句

SQL_DIAG_DFC_SS_RAISERROR

RAISERROR 语句

SQL_DIAG_DFC_SS_READTEXT

READTEXT 语句

SQL_DIAG_DFC_SS_RECONFIGURE

RECONFIGURE 语句

SQL_DIAG_DFC_SS_RETURN

RETURN 控制流语句

SQL_DIAG_DFC_SS_SELECT_INTO

SELECT INTO 语句

SQL_DIAG_DFC_SS_SET

SET 语句(常规,所有选项)

SQL_DIAG_DFC_SS_SET_IDENTITY_INSERT

SET IDENTITY_INSERT 语句

SQL_DIAG_DFC_SS_SET_ROW_COUNT

SET ROWCOUNT 语句

SQL_DIAG_DFC_SS_SET_STATISTICS

SET STATISTICS IO 或 SET STATISTICS TIME 语句

SQL_DIAG_DFC_SS_SET_TEXTSIZE

SET TEXTSIZE 语句

SQL_DIAG_DFC_SS_SETUSER

SETUSER 语句

SQL_DIAG_DFC_SS_SET_XCTLVL

SET TRANSACTION ISOLATION LEVEL 语句

SQL_DIAG_DFC_SS_SHUTDOWN

SHUTDOWN 语句

SQL_DIAG_DFC_SS_TRANS_BEGIN

BEGIN TRAN 语句

SQL_DIAG_DFC_SS_TRANS_COMMIT

COMMIT TRAN 语句

SQL_DIAG_DFC_SS_TRANS_PREPARE

准备提交分布式事务

SQL_DIAG_DFC_SS_TRANS_ROLLBACK

ROLLBACK TRAN 语句

SQL_DIAG_DFC_SS_TRANS_SAVE

SAVE TRAN 语句

SQL_DIAG_DFC_SS_TRUNCATE_TABLE

TRUNCATE TABLE 语句

SQL_DIAG_DFC_SS_UPDATE_STATISTICS

UPDATE STATISTICS 语句

SQL_DIAG_DFC_SS_UPDATETEXT

UPDATETEXT 语句

SQL_DIAG_DFC_SS_USE

USE 语句

SQL_DIAG_DFC_SS_WAITFOR

WAITFOR 控制流语句

SQL_DIAG_DFC_SS_WRITETEXT

WRITETEXT 语句

SQLGetDiagField 和表值参数

SQLGetDiagField 可用于检索两个诊断字段:SQL_DIAG_SS_TABLE_COLUMN_NUMBER 和 SQL_DIAG_SS_TABLE_ROW_NUMBER。这些字段可帮助您确定哪个值导致了与诊断记录关联的错误或警告。

有关表值参数的详细信息,请参阅表值参数 (ODBC)

请参阅

概念

其他资源