SQLGetDiagField
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
El controlador ODBC de SQL Server Native Client especifica los siguientes campos de diagnóstico adicionales para SQLGetDiagField. Estos campos admiten informes de errores enriquecidos para las aplicaciones de SQL Server y están disponibles en todos los registros de diagnóstico generados en los identificadores de conexión ODBC conectados y los identificadores de instrucciones ODBC. 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 para 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 esos 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 informa de los siguientes códigos de función dinámica adicionales que identifican la última instrucción de SQL Server que se intentó. 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 | Source |
|---|---|
| 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 | CREATE PROCEDURE, instrucción |
| SQL_DIAG_DFC_SS_CREATE_RULE | Instrucción CREATE RULE |
| SQL_DIAG_DFC_SS_CREATE_TRIGGER | CREATE TRIGGER, instrucción |
| SQL_DIAG_DFC_SS_CURSOR_DECLARE | DECLARE CURSOR, instrucción |
| SQL_DIAG_DFC_SS_CURSOR_OPEN | OPEN, instrucción |
| SQL_DIAG_DFC_SS_CURSOR_FETCH | FETCH, instrucción |
| SQL_DIAG_DFC_SS_CURSOR_CLOSE | Instrucción CLOSE |
| SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR | DEALLOCATE, instrucción |
| SQL_DIAG_DFC_SS_DBCC | Instrucción DBCC |
| SQL_DIAG_DFC_SS_DENY | DENY, instrucción |
| SQL_DIAG_DFC_SS_DROP_DATABASE | DROP DATABASE, instrucción |
| 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 para una instrucción CHECKPOINT si la trunc. log en chkpt. la opción de base de datos 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 | PRINT, instrucción |
| SQL_DIAG_DFC_SS_RAISERROR | RAISERROR, instrucción |
| 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 | SET IDENTITY_INSERT, instrucción |
| SQL_DIAG_DFC_SS_SET_ROW_COUNT | SET ROWCOUNT, instrucción |
| SQL_DIAG_DFC_SS_SET_STATISTICS | Instrucción SET STATISTICS IO o SET STATISTICS TIME |
| SQL_DIAG_DFC_SS_SET_TEXTSIZE | SET TEXTSIZE, instrucción |
| SQL_DIAG_DFC_SS_SETUSER | SETUSER, instrucción |
| 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 | TRUNCATE TABLE, instrucción |
| SQL_DIAG_DFC_SS_UPDATE_STATISTICS | UPDATE STATISTICS, instrucción |
| SQL_DIAG_DFC_SS_UPDATETEXT | instrucción UPDATETEXT |
| SQL_DIAG_DFC_SS_USE | USE, instrucción |
| 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 usar 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 sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).
Consulte también
Función SQLGetDiagField
Detalles de implementación de la API de ODBC