Condividi tramite


SQLGetDiagField

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)

Il driver ODBC di SQL Server Native Client specifica i campi di diagnostica aggiuntivi seguenti per SQLGetDiagField. Questi campi supportano la segnalazione errori avanzata per le applicazioni SQL Server e sono disponibili in tutti i record di diagnostica generati negli handle di connessione ODBC connessi e negli handle di istruzioni ODBC. I campi sono definiti in sqlncli.h.

Campo del record di diagnostica Descrizione
SQL_DIAG_SS_LINE Segnala il numero di riga di una stored procedure che genera un errore. Il valore di SQL_DIAG_SS_LINE è significativo solo se SQL_DIAG_SS_PROCNAME restituisce un valore. Il valore viene restituito come numero intero senza segno a 16 bit.
SQL_DIAG_SS_MSGSTATE Stato di un messaggio di errore. Per informazioni sullo stato del messaggio di errore, vedere RAISERROR. Il valore viene restituito come numero intero con segno a 32 bit.
SQL_DIAG_SS_PROCNAME Nome della stored procedure che genera un errore, se appropriato. Il valore viene restituito come stringa di caratteri. La lunghezza della stringa (in caratteri) dipende dalla versione di SQL Server. Può essere determinata chiamando SQLGetInfo che richiede il valore per SQL_MAX_PROCEDURE_NAME_LEN.
SQL_DIAG_SS_SEVERITY Livello di gravità del messaggio di errore associato. Il valore viene restituito come numero intero con segno a 32 bit.
SQL_DIAG_SS_SRVNAME Nome del server in cui si è verificato l'errore. Il valore viene restituito come stringa di caratteri. La lunghezza della stringa (in caratteri) viene definita dalla macro SQL_MAX_SQLSERVERNAME in sqlncli.h.

Campi di diagnostica specifici di SQL Server che contengono dati di tipo carattere, SQL_DIAG_SS_PROCNAME e SQL_DIAG_SS_SRVNAME, restituiscono tali dati al client come stringhe null terminate, ANSI o Unicode. Se necessario, il conteggio dei caratteri deve essere regolato in base alla larghezza dei caratteri. In alternativa, è possibile utilizzare un tipo di dati C portabile, ad esempio TCHAR o SQLTCHAR, per assicurare una lunghezza corretta della variabile di programma.

Il driver ODBC di SQL Server Native Client segnala i codici di funzione dinamici aggiuntivi seguenti che identificano l'ultima istruzione di SQL Server tentata. Il codice di funzione dinamica viene restituito nell'intestazione (record 0) del set di record di diagnostica ed è pertanto disponibile a ogni esecuzione, indipendentemente dall'esito di quest'ultima.

Codice di funzione dinamica Origine
SQL_DIAG_DFC_SS_ALTER_DATABASE ALTER DATABASE - istruzione
SQL_DIAG_DFC_SS_CHECKPOINT Istruzione CHECKPOINT
SQL_DIAG_DFC_SS_CONDITION L'errore si è verificato nella clausola WHERE o HAVING di un'istruzione.
SQL_DIAG_DFC_SS_CREATE_DATABASE Istruzione CREATE DATABASE
SQL_DIAG_DFC_SS_CREATE_DEFAULT Istruzione CREATE DEFAULT
SQL_DIAG_DFC_SS_CREATE_PROCEDURE CREATE PROCEDURE - istruzione
SQL_DIAG_DFC_SS_CREATE_RULE Istruzione CREATE RULE
SQL_DIAG_DFC_SS_CREATE_TRIGGER CREATE TRIGGER - istruzione
SQL_DIAG_DFC_SS_CURSOR_DECLARE DECLARE CURSOR - istruzione
SQL_DIAG_DFC_SS_CURSOR_OPEN OPEN - istruzione
SQL_DIAG_DFC_SS_CURSOR_FETCH FETCH - istruzione
SQL_DIAG_DFC_SS_CURSOR_CLOSE Istruzione CLOSE
SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR DEALLOCATE - istruzione
SQL_DIAG_DFC_SS_DBCC Istruzione DBCC
SQL_DIAG_DFC_SS_DENY DENY - istruzione
SQL_DIAG_DFC_SS_DROP_DATABASE DROP DATABASE - istruzione
SQL_DIAG_DFC_SS_DROP_DEFAULT Istruzione DROP DEFAULT
SQL_DIAG_DFC_SS_DROP_PROCEDURE Istruzione DROP PROCEDURE
SQL_DIAG_DFC_SS_DROP_RULE Istruzione DROP RULE
SQL_DIAG_DFC_SS_DROP_TRIGGER Istruzione DROP TRIGGER
SQL_DIAG_DFC_SS_DUMP_DATABASE Istruzione BACKUP o DUMP DATABASE
SQL_DIAG_DFC_SS_DUMP_TABLE Istruzione DUMP TABLE
SQL_DIAG_DFC_SS_DUMP_TRANSACTION Istruzione BACKUP o DUMP TRANSACTION. Restituito anche per un'istruzione CHECKPOINT se l'trunc. log in chkpt. l'opzione di database è attivata.
SQL_DIAG_DFC_SS_GOTO Istruzione per il controllo di flusso GOTO
SQL_DIAG_DFC_SS_INSERT_BULK Istruzione INSERT BULK
SQL_DIAG_DFC_SS_KILL Istruzione KILL
SQL_DIAG_DFC_SS_LOAD_DATABASE Istruzione LOAD o RESTORE DATABASE
SQL_DIAG_DFC_SS_LOAD_HEADERONLY Istruzione LOAD o RESTORE HEADERONLY.
SQL_DIAG_DFC_SS_LOAD_TABLE Istruzione LOAD TABLE
SQL_DIAG_DFC_SS_LOAD_TRANSACTION Istruzione LOAD o RESTORE TRANSACTION
SQL_DIAG_DFC_SS_PRINT istruzione PRINT
SQL_DIAG_DFC_SS_RAISERROR istruzione RAISERROR
SQL_DIAG_DFC_SS_READTEXT Istruzione READTEXT
SQL_DIAG_DFC_SS_RECONFIGURE Istruzione RECONFIGURE
SQL_DIAG_DFC_SS_RETURN Istruzione per il controllo di flusso RETURN
SQL_DIAG_DFC_SS_SELECT_INTO SELECT INTO - istruzione
SQL_DIAG_DFC_SS_SET Istruzione SET (generica, tutte le opzioni)
SQL_DIAG_DFC_SS_SET_IDENTITY_INSERT SET IDENTITY_INSERT - istruzione
SQL_DIAG_DFC_SS_SET_ROW_COUNT SET ROWCOUNT - istruzione
SQL_DIAG_DFC_SS_SET_STATISTICS Istruzione SET STATISTICS IO o SET STATISTICS TIME
SQL_DIAG_DFC_SS_SET_TEXTSIZE SET TEXTSIZE - istruzione
SQL_DIAG_DFC_SS_SETUSER SETUSER - istruzione
SQL_DIAG_DFC_SS_SET_XCTLVL Istruzione SET TRANSACTION ISOLATION LEVEL
SQL_DIAG_DFC_SS_SHUTDOWN Istruzione SHUTDOWN
SQL_DIAG_DFC_SS_TRANS_BEGIN Istruzione BEGIN TRAN
SQL_DIAG_DFC_SS_TRANS_COMMIT Istruzione COMMIT TRAN
SQL_DIAG_DFC_SS_TRANS_PREPARE Preparazione al commit di una transazione distribuita
SQL_DIAG_DFC_SS_TRANS_ROLLBACK Istruzione ROLLBACK TRAN
SQL_DIAG_DFC_SS_TRANS_SAVE Istruzione SAVE TRAN
SQL_DIAG_DFC_SS_TRUNCATE_TABLE TRUNCATE TABLE - istruzione
SQL_DIAG_DFC_SS_UPDATE_STATISTICS UPDATE STATISTICS - istruzione
SQL_DIAG_DFC_SS_UPDATETEXT UPDATETEXT, istruzione
SQL_DIAG_DFC_SS_USE USE - istruzione
SQL_DIAG_DFC_SS_WAITFOR Istruzione per il controllo di flusso WAITFOR
SQL_DIAG_DFC_SS_WRITETEXT Istruzione WRITETEXT

SQLGetDiagField e parametri con valori di tabella

SQLGetDiagField può essere usato per recuperare due campi di diagnostica: SQL_DIAG_SS_TABLE_COLUMN_NUMBER e SQL_DIAG_SS_TABLE_ROW_NUMBER. Tali campi consentono di identificare il valore che ha generato l'errore o l'avviso associato al record di diagnostica.

Per altre informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).

Vedi anche

Funzione SQLGetDiagField
Dettagli di implementazione dell'API ODBC