SQLGetDiagField
O driver ODBC do SQL Server Native Client especifica os campos de diagnósticos adicionais a seguir para SQLGetDiagField. Esses campos suportam relatórios bem-elaborados de erros para os aplicativos do SQL Server e estão disponíveis em todos os registros de diagnóstico gerados em identificadores de conexão conectados ODBC e identificadores de instrução ODBC. Os campos são definidos em sqlncli.h.
Campo de registro de diagnóstico |
Descrição |
|---|---|
SQL_DIAG_SS_LINE |
Informa o número da linha de um procedimento armazenado que gera um erro. O valor de SQL_DIAG_SS_LINE só será útil se SQL_DIAG_SS_PROCNAME retornar um valor. O valor é retornado como um inteiro de 16 bits sem-sinal. |
SQL_DIAG_SS_MSGSTATE |
O estado de uma mensagem de erro. Para obter mais informações sobre o estado da mensagem de erro, consulte RAISERROR. O valor é retornado como um inteiro de 32 bits com assinatura. |
SQL_DIAG_SS_PROCNAME |
O nome do procedimento armazenado que gera um erro, se apropriado. O valor é retornado como uma cadeia de caracteres. O comprimento da cadeia de caracteres (em caracteres) depende da versão do SQL Server. Pode ser determinado chamando SQLGetInfo que solicita o valor de SQL_MAX_PROCEDURE_NAME_LEN. |
SQL_DIAG_SS_SEVERITY |
O nível de severidade da mensagem de erro associada. O valor é retornado como um inteiro de 32 bits com assinatura. |
SQL_DIAG_SS_SRVNAME |
O nome do servidor no qual o erro ocorreu. O valor é retornado como uma cadeia de caracteres. O comprimento da cadeia de caracteres (em caracteres) é definido pela macro SQL_MAX_SQLSERVERNAME em sqlncli.h. |
Campos de diagnóstico específicos do SQL Server que contêm dados de caractere, SQL_DIAG_SS_PROCNAME e SQL_DIAG_SS_SRVNAME, retornam esses dados para o cliente como cadeia de caracteres com terminação nula, ANSI ou Unicode. Se necessário, a contagem de caracteres deve ser ajustada de acordo com a largura do caractere. Como opção, um tipo de dados C portátil, como TCHAR ou SQLTCHAR, pode ser usado para garantir o comprimento variável correto do programa.
O driver ODBC do SQL Server Native Client informa os códigos de função dinâmicos adicionais a seguir que identificam a última instrução do SQL Server tentada. O código de função dinâmico é retornado no cabeçalho (record 0) do registro de diagnóstico definido e, portanto, está disponível em cada execução (bem-sucedida ou não).
Código de função dinâmico |
Origem |
|---|---|
SQL_DIAG_DFC_SS_ALTER_DATABASE |
Instrução ALTER DATABASE |
SQL_DIAG_DFC_SS_CHECKPOINT |
Instrução CHECKPOINT |
SQL_DIAG_DFC_SS_CONDITION |
O erro ocorreu nas cláusulas WHERE ou HAVING de uma instrução. |
SQL_DIAG_DFC_SS_CREATE_DATABASE |
Instrução CREATE DATABASE |
SQL_DIAG_DFC_SS_CREATE_DEFAULT |
Instrução CREATE DEFAULT |
SQL_DIAG_DFC_SS_CREATE_PROCEDURE |
Instrução CREATE PROCEDURE |
SQL_DIAG_DFC_SS_CREATE_RULE |
Instrução CREATE RULE |
SQL_DIAG_DFC_SS_CREATE_TRIGGER |
Instrução CREATE TRIGGER |
SQL_DIAG_DFC_SS_CURSOR_DECLARE |
Instrução DECLARE CURSOR |
SQL_DIAG_DFC_SS_CURSOR_OPEN |
Instrução OPEN |
SQL_DIAG_DFC_SS_CURSOR_FETCH |
Instrução FETCH |
SQL_DIAG_DFC_SS_CURSOR_CLOSE |
Instrução CLOSE |
SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR |
Instrução DEALLOCATE |
SQL_DIAG_DFC_SS_DBCC |
Instrução DBCC |
SQL_DIAG_DFC_SS_DENY |
Instrução DENY |
SQL_DIAG_DFC_SS_DROP_DATABASE |
Instrução DROP DATABASE |
SQL_DIAG_DFC_SS_DROP_DEFAULT |
Instrução DROP DEFAULT |
SQL_DIAG_DFC_SS_DROP_PROCEDURE |
Instrução DROP PROCEDURE |
SQL_DIAG_DFC_SS_DROP_RULE |
Instrução DROP RULE |
SQL_DIAG_DFC_SS_DROP_TRIGGER |
Instrução DROP TRIGGER |
SQL_DIAG_DFC_SS_DUMP_DATABASE |
Instrução BACKUP ou DUMP DATABASE |
SQL_DIAG_DFC_SS_DUMP_TABLE |
Instrução DUMP TABLE |
SQL_DIAG_DFC_SS_DUMP_TRANSACTION |
Instrução BACKUP ou DUMP TRANSACTION. Também retornado para uma instrução CHECKPOINT se a opção de banco de dados trunc. log on chkpt. estiver ativa. |
SQL_DIAG_DFC_SS_GOTO |
Instrução de controle de fluxo GOTO |
SQL_DIAG_DFC_SS_INSERT_BULK |
Instrução INSERT BULK |
SQL_DIAG_DFC_SS_KILL |
Instrução KILL |
SQL_DIAG_DFC_SS_LOAD_DATABASE |
Instrução LOAD ou RESTORE DATABASE |
SQL_DIAG_DFC_SS_LOAD_HEADERONLY |
Instrução LOAD ou RESTORE HEADERONLY |
SQL_DIAG_DFC_SS_LOAD_TABLE |
Instrução LOAD TABLE |
SQL_DIAG_DFC_SS_LOAD_TRANSACTION |
Instrução LOAD ou RESTORE TRANSACTION |
SQL_DIAG_DFC_SS_PRINT |
Instrução PRINT |
SQL_DIAG_DFC_SS_RAISERROR |
Instrução RAISERROR |
SQL_DIAG_DFC_SS_READTEXT |
Instrução READTEXT |
SQL_DIAG_DFC_SS_RECONFIGURE |
Instrução RECONFIGURE |
SQL_DIAG_DFC_SS_RETURN |
Instrução de controle de fluxo RETURN |
SQL_DIAG_DFC_SS_SELECT_INTO |
Instrução SELECT INTO |
SQL_DIAG_DFC_SS_SET |
Instrução SET (genérica, todas as opções) |
SQL_DIAG_DFC_SS_SET_IDENTITY_INSERT |
Instrução SET IDENTITY_INSERT |
SQL_DIAG_DFC_SS_SET_ROW_COUNT |
Instrução SET ROWCOUNT |
SQL_DIAG_DFC_SS_SET_STATISTICS |
Instruções SET STATISTICS IO ou SET STATISTICS TIME |
SQL_DIAG_DFC_SS_SET_TEXTSIZE |
Instrução SET TEXTSIZE |
SQL_DIAG_DFC_SS_SETUSER |
Instrução SETUSER |
SQL_DIAG_DFC_SS_SET_XCTLVL |
Instrução SET TRANSACTION ISOLATION LEVEL |
SQL_DIAG_DFC_SS_SHUTDOWN |
Instrução SHUTDOWN |
SQL_DIAG_DFC_SS_TRANS_BEGIN |
Instrução BEGIN TRAN |
SQL_DIAG_DFC_SS_TRANS_COMMIT |
Instrução COMMIT TRAN |
SQL_DIAG_DFC_SS_TRANS_PREPARE |
Preparar para confirmar uma transação distribuída |
SQL_DIAG_DFC_SS_TRANS_ROLLBACK |
Instrução ROLLBACK TRAN |
SQL_DIAG_DFC_SS_TRANS_SAVE |
Instrução SAVE TRAN |
SQL_DIAG_DFC_SS_TRUNCATE_TABLE |
Instrução TRUNCATE TABLE |
SQL_DIAG_DFC_SS_UPDATE_STATISTICS |
Instrução UPDATE STATISTICS |
SQL_DIAG_DFC_SS_UPDATETEXT |
Instrução UPDATETEXT |
SQL_DIAG_DFC_SS_USE |
Instrução USE |
SQL_DIAG_DFC_SS_WAITFOR |
Instrução de controle de fluxo WAITFOR |
SQL_DIAG_DFC_SS_WRITETEXT |
Instrução WRITETEXT |
SQLGetDiagField e parâmetros com valor de tabela
SQLGetDiagField pode ser usado para recuperar dois campos de diagnóstico: SQL_DIAG_SS_TABLE_COLUMN_NUMBER e SQL_DIAG_SS_TABLE_ROW_NUMBER. Esses campos ajudam a determinar qual valor gerou o erro ou a mensagem de advertência associada ao registro de diagnóstico.
Para obter mais informações sobre parâmetros com valor de tabela, consulte Parâmetros com valor de tabela (ODBC).
Consulte também
Conceitos
Detalhes de implementação da API ODBC