共用方式為

處理產生訊息的陳述式

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

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，這兩者都會以結果集傳回輸出，而不是一組訊息。

統計資料時間的每一行都會以下列格式傳回：

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 的後續呼叫會傳回 01000 的 SQLState。 嚴重性為 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，直到傳回SQL_NO_DATA以擷取 PRINT 或 RAISERROR 信息為止。

如果 PRINT 或 RAISERROR 語句位於 SQL 語句之後（例如 SELECT 語句），則當 SQLMoreResults 在包含錯誤的結果集上的位置時，會傳回 PRINT 或 RAISERROR 資訊。 SQLMoreResults 會根據訊息的嚴重性傳回SQL_SUCCESS_WITH_INFO或SQL_ERROR。 呼叫 SQLGetDiagRec 以擷取訊息，直到傳回SQL_NO_DATA為止。

另請參閱

處理錯誤與訊息