共用方式為


處理產生訊息的陳述式

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 時,SQLExecuteSQLExecDirect 會傳回 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 輸出,應用程式會在 SQLFetchSQLFetchScroll 傳回 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 陳述式會傳回其資料做為訊息,而非結果集。SQLExecDirectSQLExecute 會傳回 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 陳述式時,這是相當直接的,如以上的範例所示。在這些情況下,SQLExecDirectSQLExecute 的呼叫會傳回 SQL_ERROR 或 SQL_SUCCESS_WITH_INFO,然後可以呼叫 SQLGetDiagRec。當編碼使用迴圈處理 SQL 陳述式的批次輸出時,或執行 SQL Server 預存程序時,比較不直接。

在此情況下,SQL Server 會針對批次或預存程序中執行的每個 SELECT 陳述式傳回一個結果集。如果批次或程序包含 PRINT 或 RAISERROR 陳述式,這些陳述式的輸出會與 SELECT 陳述式結果集交錯。如果批次或程序中的第一個陳述式為 PRINT 或 RAISERROR,SQLExecuteSQLExecDirect 會傳回 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 為止。

請參閱

概念