SQLGetDiagField
El controlador ODBC de SQL Server Native Client especifica los siguientes campos de diagnóstico adicionales para SQLGetDiagField. Estos campos admiten el informe de errores enriquecido para aplicaciones de SQL Server y están disponible en todos los registros de diagnóstica que se generan en los identificadores de conexión de ODBC e identificadores de instrucciones de ODBC conectados. Los campos se definen en sqlncli.h.
Campo del registro de diagnóstico |
Descripción |
|---|---|
SQL_DIAG_SS_LINE |
Indica el número de línea de un procedimiento almacenado que genera un error. El valor de SQL_DIAG_SS_LINE solamente es significativo si SQL_DIAG_SS_PROCNAME devuelve un valor. El valor se devuelve como un entero sin signo de 16 bits. |
SQL_DIAG_SS_MSGSTATE |
El estado de un mensaje de error. Para obtener información sobre el estado del mensaje de error, vea RAISERROR. El valor se devuelve como un entero con signo de 32 bits. |
SQL_DIAG_SS_PROCNAME |
Nombre del procedimiento almacenado que genera un error, si procede. El valor se devuelve como una cadena de caracteres. La longitud de la cadena (en caracteres) depende de la versión de SQL Server. Se puede determinar mediante una llamada a SQLGetInfo que solicita el valor de SQL_MAX_PROCEDURE_NAME_LEN. |
SQL_DIAG_SS_SEVERITY |
El nivel de gravedad del mensaje de error asociado. El valor se devuelve como un entero con signo de 32 bits. |
SQL_DIAG_SS_SRVNAME |
El nombre del servidor donde se ha producido el error. El valor se devuelve como una cadena de caracteres. La longitud de la cadena (en caracteres) se define en la macro SQL_MAX_SQLSERVERNAME de sqlncli.h. |
Los campos de diagnóstico específicos de SQL Server que contienen datos de caracteres, SQL_DIAG_SS_PROCNAME y SQL_DIAG_SS_SRVNAME, devuelven estos datos al cliente como cadenas terminadas en NULL, ANSI o Unicode. Si es necesario, el ancho de caracteres debe ajustar el recuento de caracteres. También se puede utilizar un tipo de datos de C portátil como TCHAR o SQLTCHAR para garantizar la longitud correcta de la variable de programa.
El controlador ODBC de SQL Server Native Client notifica los siguientes códigos de función dinámica adicionales que identifican la última instrucción SQL Server intentada. El código de función dinámica se devuelve en el encabezado (registro 0) del conjunto de registros de diagnóstico y está por tanto disponible en cada ejecución (correcta o no).
Código de función dinámica |
Origen |
|---|---|
SQL_DIAG_DFC_SS_ALTER_DATABASE |
Instrucción ALTER DATABASE |
SQL_DIAG_DFC_SS_CHECKPOINT |
Instrucción CHECKPOINT |
SQL_DIAG_DFC_SS_CONDITION |
Error surgido en las cláusulas WHERE o HAVING de una instrucción. |
SQL_DIAG_DFC_SS_CREATE_DATABASE |
Instrucción CREATE DATABASE |
SQL_DIAG_DFC_SS_CREATE_DEFAULT |
Instrucción CREATE DEFAULT |
SQL_DIAG_DFC_SS_CREATE_PROCEDURE |
Instrucción CREATE PROCEDURE |
SQL_DIAG_DFC_SS_CREATE_RULE |
Instrucción CREATE RULE |
SQL_DIAG_DFC_SS_CREATE_TRIGGER |
Instrucción CREATE TRIGGER |
SQL_DIAG_DFC_SS_CURSOR_DECLARE |
Instrucción DECLARE CURSOR |
SQL_DIAG_DFC_SS_CURSOR_OPEN |
Instrucción OPEN |
SQL_DIAG_DFC_SS_CURSOR_FETCH |
Instrucción FETCH |
SQL_DIAG_DFC_SS_CURSOR_CLOSE |
Instrucción CLOSE |
SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR |
Instrucción DEALLOCATE |
SQL_DIAG_DFC_SS_DBCC |
Instrucción DBCC |
SQL_DIAG_DFC_SS_DENY |
Instrucción DENY |
SQL_DIAG_DFC_SS_DROP_DATABASE |
Instrucción DROP DATABASE |
SQL_DIAG_DFC_SS_DROP_DEFAULT |
Instrucción DROP DEFAULT |
SQL_DIAG_DFC_SS_DROP_PROCEDURE |
Instrucción DROP PROCEDURE |
SQL_DIAG_DFC_SS_DROP_RULE |
Instrucción DROP RULE |
SQL_DIAG_DFC_SS_DROP_TRIGGER |
Instrucción DROP TRIGGER |
SQL_DIAG_DFC_SS_DUMP_DATABASE |
Instrucción BACKUP o DUMP DATABASE |
SQL_DIAG_DFC_SS_DUMP_TABLE |
Instrucción DUMP TABLE |
SQL_DIAG_DFC_SS_DUMP_TRANSACTION |
Instrucción BACKUP o DUMP TRANSACTION. También se devuelve en una instrucción CHECKPOINT si la opción de base de datos trunc. log on chkpt. está activada. |
SQL_DIAG_DFC_SS_GOTO |
Instrucción GOTO de control de flujo |
SQL_DIAG_DFC_SS_INSERT_BULK |
Instrucción INSERT BULK |
SQL_DIAG_DFC_SS_KILL |
Instrucción KILL |
SQL_DIAG_DFC_SS_LOAD_DATABASE |
Instrucción LOAD o RESTORE DATABASE |
SQL_DIAG_DFC_SS_LOAD_HEADERONLY |
Instrucción LOAD o RESTORE HEADERONLY |
SQL_DIAG_DFC_SS_LOAD_TABLE |
Instrucción LOAD TABLE |
SQL_DIAG_DFC_SS_LOAD_TRANSACTION |
Instrucción LOAD o RESTORE TRANSACTION |
SQL_DIAG_DFC_SS_PRINT |
Instrucción PRINT |
SQL_DIAG_DFC_SS_RAISERROR |
Instrucción RAISERROR |
SQL_DIAG_DFC_SS_READTEXT |
Instrucción READTEXT |
SQL_DIAG_DFC_SS_RECONFIGURE |
Instrucción RECONFIGURE |
SQL_DIAG_DFC_SS_RETURN |
Instrucción RETURN de control de flujo |
SQL_DIAG_DFC_SS_SELECT_INTO |
Instrucción SELECT INTO |
SQL_DIAG_DFC_SS_SET |
Instrucción SET (genérico, todas las opciones) |
SQL_DIAG_DFC_SS_SET_IDENTITY_INSERT |
Instrucción SET IDENTITY_INSERT |
SQL_DIAG_DFC_SS_SET_ROW_COUNT |
Instrucción SET ROWCOUNT |
SQL_DIAG_DFC_SS_SET_STATISTICS |
Instrucción SET STATISTICS IO o SET STATISTICS TIME |
SQL_DIAG_DFC_SS_SET_TEXTSIZE |
Instrucción SET TEXTSIZE |
SQL_DIAG_DFC_SS_SETUSER |
Instrucción SETUSER |
SQL_DIAG_DFC_SS_SET_XCTLVL |
Instrucción SET TRANSACTION ISOLATION LEVEL |
SQL_DIAG_DFC_SS_SHUTDOWN |
Instrucción SHUTDOWN |
SQL_DIAG_DFC_SS_TRANS_BEGIN |
Instrucción BEGIN TRAN |
SQL_DIAG_DFC_SS_TRANS_COMMIT |
Instrucción COMMIT TRAN |
SQL_DIAG_DFC_SS_TRANS_PREPARE |
Preparación para confirmar una transacción distribuida |
SQL_DIAG_DFC_SS_TRANS_ROLLBACK |
Instrucción ROLLBACK TRAN |
SQL_DIAG_DFC_SS_TRANS_SAVE |
Instrucción SAVE TRAN |
SQL_DIAG_DFC_SS_TRUNCATE_TABLE |
Instrucción TRUNCATE TABLE |
SQL_DIAG_DFC_SS_UPDATE_STATISTICS |
Instrucción UPDATE STATISTICS |
SQL_DIAG_DFC_SS_UPDATETEXT |
Instrucción UPDATETEXT |
SQL_DIAG_DFC_SS_USE |
Instrucción USE |
SQL_DIAG_DFC_SS_WAITFOR |
Instrucción WAITFOR de control de flujo |
SQL_DIAG_DFC_SS_WRITETEXT |
Instrucción WRITETEXT |
SQLGetDiagField y parámetros con valores de tabla
SQLGetDiagField se puede utilizar para recuperar dos campos de diagnóstico: SQL_DIAG_SS_TABLE_COLUMN_NUMBER y SQL_DIAG_SS_TABLE_ROW_NUMBER. Estos campos ayudan a determinar qué valor produjo el error o la advertencia asociados al registro de diagnóstico.
Para obtener más información acerca de los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).
Vea también
Conceptos
Detalles de implementación de la API de ODBC