處理產生訊息的陳述式
Transact-SQL SET 陳述式選項 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,而且在此時,應用程式可以呼叫 SQLGetDiagRec 來擷取 SHOWPLAN 或 STATISTICS TIME 輸出,直到傳回 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 IO 的輸出。若要取得 STATISTICS IO 輸出,應用程式會在 SQLFetch 或 SQLFetchScroll 傳回 SQL_NO_DATA 時,呼叫 SQLGetDiagRec。STATISTICS IO 的輸出會以下列格式傳回:
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。嚴重性為 10 或更低之 RAISERROR 陳述式的行為與 PRINT 相同。嚴重性為 11 或更高的 RAISERROR 會使執行傳回 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."
來自 PRINT 或 RAISERROR 陳述式的輸出包含在結果集時,呼叫 SQLGetDiagRec 的時機相當重要。用於擷取 PRINT 或 RAISERROR 輸出的 SQLGetDiagRec 呼叫必須在接收 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 來擷取 PRINT 或 RAISERROR 資訊,直到傳回 SQL_NO_DATA 為止。
如果 PRINT 或 RAISERROR 陳述式在 SQL 陳述式 (例如 SELECT 陳述式) 之後,則在 SQLMoreResults置於包含錯誤的結果集上時,會傳回 PRINT 或 RAISERROR 資訊。SQLMoreResults 會根據訊息的嚴重性,傳回 SQL_SUCCESS_WITH_INFO 或 SQL_ERROR。訊息會透過呼叫 SQLGetDiagRec 擷取,直到傳回 SQL_NO_DATA 為止。