處理產生訊息的陳述式
適用於： 
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics 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為止。