Инструкции обработки, создающие сообщения

Параметры инструкции SET Transact-SQL STATISTICS TIME и STATISTICS IO используются для получения сведений, которые помогают диагностировать длительные запросы. Более ранние версии SQL Server также поддерживают параметр SHOWPLAN для анализа планов запросов. Приложение ODBC может задать эти параметры, выполнив следующие инструкции:

SQLExecDirect(hstmt, "SET SHOWPLAN ON", SQL_NTS);  
SQLExecDirect(hstmt, "SET STATISTICS TIME ON", SQL_NTS90  
);  
SQLExecDirect(hstmt, "SET STATISTICS IO ON", SQL_NTS);  

Если параметр SET STATISTICS TIME или SET SHOWPLAN — ON, SQLExecute и SQLExecDirect возвращают SQL_SUCCESS_WITH_INFO, а в этом случае приложение может получить выходные данные SHOWPLAN или STATISTICS TIME, вызвав SQLGetDiagRec , пока не вернется SQL_NO_DATA. Каждая строка данных SHOWPLAN возвращается в формате:

szSqlState="01000", *pfNativeError=6223,  
szErrorMsg="[Microsoft][SQL Server Native Client][SQL Server]   
              Table Scan"  

SQL Server версии 7.0 заменил параметр SHOWPLAN SHOWPLAN_ALL и SHOWPLAN_TEXT, оба из которых возвращают выходные данные в результирующем наборе, а не набор сообщений.

Каждая строка STATISTICS TIME возвращается в формате:

szSqlState="01000", *pfNativeError= 3613,  
szErrorMsg="[Microsoft][SQL Server Native Client][SQL Server]  
   SQL Server Parse and Compile Time: cpu time = 0 ms."  

Выходные данные операций ввода-вывода SET STATISTICS недоступны до конца результирующий набор. Чтобы получить выходные данные статистических операций ввода-вывода, приложение вызывает SQLGetDiagRec в момент, когда SQLFetch или SQLFetchScroll возвращает SQL_NO_DATA. Выходные данные операций ввода-вывода STATISTICS возвращаются в формате:

szSqlState="01000", *pfNativeError= 3615,  
szErrorMsg="[Microsoft][ SQL Server Native Client][SQL Server]  
   Table: testshow  scan count 1,  logical reads: 1,  
   physical reads: 0."  

Использование инструкций DBCC

Операторы DBCC возвращают данные в виде сообщений, а не результирующих наборов. SQLExecDirect или SQLExecute возвращает SQL_SUCCESS_WITH_INFO, а приложение получает выходные данные путем вызова SQLGetDiagRec , пока не возвращается SQL_NO_DATA.

Например, следующая инструкция возвращает SQL_SUCCESS_WITH_INFO:

SQLExecDirect(hstmt, "DBCC CHECKTABLE(Authors)", SQL_NTS);  

Вызовы возвращаемого значения SQLGetDiagRec :

szSqlState = "01000", *pfNativeError = 2536,  
szErrorMsg="[Microsoft][ SQL Server Native Client][SQL Server]  
   Checking authors"  
szSqlState = "01000", *pfNativeError = 2579,  
szErrorMsg="[Microsoft][ SQL Server Native Client][SQL Server]  
   The total number of data pages in this table is 1."  
szSqlState = "01000", *pfNativeError = 7929,  
szErrorMsg="[Microsoft][ SQL Server Native Client][SQL Server]  
   Table has 23 data rows."  
szSqlState = "01000", *pfNativeError = 2528  
szErrorMsg="[Microsoft][ SQL Server Native Client][SQL Server]  
   DBCC execution completed. If DBCC printed error messages,  
   see your System Administrator."  

Использование инструкций PRINT и RAISERROR

Transact-SQL инструкции PRINT и RAISERROR также возвращают данные путем вызова SQLGetDiagRec. Инструкции PRINT вызывают выполнение инструкции SQL для возврата SQL_SUCCESS_WITH_INFO, а последующий вызов SQLGetDiagRec возвращает SQLState 01000. ФУНКЦИЯ RAISERROR с серьезностью десяти или более низких работает так же, как и PRINT. ФУНКЦИЯ RAISERROR с серьезностью 11 или выше приводит к возврату SQL_ERROR выполнения, а последующий вызов SQLGetDiagRec возвращает SQLState 42000. Например, следующая инструкция возвращает SQL_SUCCESS_WITH_INFO:

SQLExecDirect (hstmt, "PRINT  'Some message' ", SQL_NTS);  

Функция вызова SQLGetDiagRec возвращает:

szSQLState = "01000", *pfNative Error = 0,  
szErrorMsg= "[Microsoft] [SQL Server Native Client][SQL Server]  
   Some message"  

Следующая инструкция возвращает SQL_SUCCESS_WITH_INFO:

SQLExecDirect (hstmt, "RAISERROR ('Sample error 1.', 10, -1)",  
   SQL_NTS)  

Функция вызова SQLGetDiagRec возвращает:

szSQLState = "01000", *pfNative Error = 50000,  
szErrorMsg= "[Microsoft] [SQL Server Native Client][SQL Server]  
   Sample error 1."  

Следующая инструкция возвращает SQL_ERROR:

SQLExecDirect (hstmt, "RAISERROR ('Sample error 2.', 11, -1)", SQL_NTS)  

Функция вызова SQLGetDiagRec возвращает:

szSQLState = "42000", *pfNative Error = 50000,  
szErrorMsg= "[Microsoft] [SQL Server Native Client][SQL Server]  
   Sample error 2."  

Время вызова SQLGetDiagRec критически важно, если выходные данные инструкций PRINT или RAISERROR включены в результирующий набор. Вызов SQLGetDiagRec для получения выходных данных PRINT или RAISERROR необходимо выполнить сразу после инструкции, которая получает SQL_ERROR или SQL_SUCCESS_WITH_INFO. Это просто, если выполняется только одна инструкция SQL, как в приведенных выше примерах. В таких случаях вызов SQLExecDirect или SQLExecute возвращает SQL_ERROR или SQL_SUCCESS_WITH_INFO, а затем можно вызвать SQLGetDiagRec . Это менее просто при выполнении циклов написания кода для обработки выходных данных пакета инструкций SQL или при выполнении хранимых процедур SQL Server.

В этом случае SQL Server возвращает результирующий набор для каждой инструкции SELECT, выполняемой в пакете или хранимой процедуре. Если пакет или процедура содержит инструкции PRINT или RAISERROR, выходные данные для этих инструкций перемещаются с результирующих наборами инструкций SELECT. Если первая инструкция в пакете или процедуре является PRINT или RAISERROR, SQLExecute или SQLExecDirect возвращает SQL_SUCCESS_WITH_INFO или SQL_ERROR, а приложение должно вызывать SQLGetDiagRec , пока не возвращается SQL_NO_DATA для получения сведений PRINT или RAISERROR.

Если инструкция PRINT или RAISERROR возникает после инструкции SQL (например, инструкции SELECT), данные PRINT или RAISERROR возвращаются, когда sqlMoreResultsпозиций в результирующий набор, содержащий ошибку. SQLMoreResults возвращает SQL_SUCCESS_WITH_INFO или SQL_ERROR в зависимости от серьезности сообщения. Сообщения извлекаются путем вызова SQLGetDiagRec , пока не возвращается SQL_NO_DATA.

См. также

Обработка ошибок и сообщений