分析 ODBC 驅動程式效能資料

發行項
07/04/2024

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Platform System （PDW）

此範例顯示記錄效能統計數據的 SQL Server ODBC 驅動程式特定選項。此範例會建立一個檔案:odbcperf.log。此範例會顯示建立效能數據記錄檔，以及直接從 SQLPERF 數據結構顯示效能數據（SQLPERF 結構定義於 Odbcss.h. 中）。此範例是針對 ODBC 3.0 版或更新版本所開發。

重要

盡可能使用 Windows 驗證。如果無法使用 Windows 驗證，請提示使用者在執行階段輸入認證。請避免將認證儲存在檔案中。如果您必須保存認證，則應該用 Win32 crypto API 加密這些認證。

使用 ODBC 系統管理員記錄驅動程式效能數據

在 控制台 中，按兩下 [系統管理工具]，然後按兩下 [資料源] [ODBC]。 或者，您可以叫用odbcad32.exe。
按兩下 [ 使用者 DSN]、 [系統 DSN] 或 [檔案 DSN ] 索引標籤。
按兩下要記錄效能的數據源。
按一下 [設定] 。
在 [Microsoft SQL Server 設定 DSN 精靈] 中，流覽至具有 記錄 ODBC 驅動程式統計數據的頁面至記錄檔。
選取 [記錄 ODBC 驅動程序統計數據] 至記錄檔。在方塊中，放置應該記錄統計數據的檔名。或者，按兩下 [ 瀏覽 ] 以瀏覽檔案系統中的統計資料記錄檔。

以程式設計方式記錄驅動程式效能數據

使用 SQL_COPT_SS_PERF_DATA_LOG呼叫 SQLSetConnectAttr ，以及效能數據記錄檔的完整路徑和檔名。例如：
```
"C:\\Odbcperf.log"  
```
使用 SQL_COPT_SS_PERF_DATA 和 SQL_PERF_START 呼叫 SQLSetConnectAttr 以開始記錄效能數據。
或者，使用 SQL_COPT_SS_LOG_NOW 和 NULL 呼叫 SQLSetConnectAttr ，以將效能數據的製表符分隔記錄寫入效能數據記錄檔。當應用程式執行時，這可以多次完成。
使用 SQL_COPT_SS_PERF_DATA 和 SQL_PERF_STOP 呼叫 SQLSetConnectAttr ，以停止記錄效能數據。

將驅動程式效能數據提取至應用程式

使用 SQL_COPT_SS_PERF_DATA 和 SQL_PERF_START 呼叫 SQLSetConnectAttr ，以開始分析效能數據。
使用 SQL_COPT_SS_PERF_DATA和 SQLPERF 結構的指標位址呼叫 SQLGetConnectAttr 。第一個這類呼叫會將指標設定為包含目前效能數據之有效 SQLPERF 結構的位址。驅動程式不會持續重新整理效能結構中的數據。應用程式必須隨時重複對 SQLGetConnectAttr 的呼叫，才能使用較目前的效能數據重新整理結構。
使用 SQL_COPT_SS_PERF_DATA 和 SQL_PERF_STOP 呼叫 SQLSetConnectAttr ，以停止記錄效能數據。

範例

您將需要名為 AdventureWorks 的 ODBC 數據源，其預設資料庫是 AdventureWorks 範例資料庫。（您可以從下載 AdventureWorks 範例資料庫 Microsoft SQL Server 範例和社群專案首頁。）此數據源必須以操作系統提供的 ODBC 驅動程式為基礎（驅動程式名稱為 “SQL Server” ）。如果您要在 64 位作業系統上建置並執行此範例做為 32 位應用程式，您必須在 %windir%\SysWOW64\odbcad32.exe 中使用 ODBC 系統管理員建立 ODBC 數據源。

此範例會連線到計算機的預設 SQL Server 實例。若要連線到具名實例，請變更 ODBC 數據源的定義，以使用下列格式指定實例：server\namedinstance。根據預設，SQL Server Express 會安裝至具名執行個體。

使用 odbc32.lib 編譯。

// compile with: odbc32.lib  
#include <stdio.h>  
#include <string.h>  
#include <windows.h>  
#include <sql.h>  
#include <sqlext.h>  
#include <odbcss.h>  
  
SQLHENV henv = SQL_NULL_HENV;  
SQLHDBC hdbc1 = SQL_NULL_HDBC;       
SQLHSTMT hstmt1 = SQL_NULL_HSTMT;  
  
void Cleanup() {  
   if (hstmt1 != SQL_NULL_HSTMT)  
      SQLFreeHandle(SQL_HANDLE_STMT, hstmt1);  
  
   if (hdbc1 != SQL_NULL_HDBC) {  
      SQLDisconnect(hdbc1);  
      SQLFreeHandle(SQL_HANDLE_DBC, hdbc1);  
   }  
  
   if (henv != SQL_NULL_HENV)  
      SQLFreeHandle(SQL_HANDLE_ENV, henv);  
}  
  
int main() {  
   RETCODE retcode;  
  
   // Pointer to the ODBC driver performance structure.  
   SQLPERF *PerfPtr;  
   SQLINTEGER cbPerfPtr;  
  
   // Allocate the ODBC environment and save handle.  
   retcode = SQLAllocHandle (SQL_HANDLE_ENV, NULL, &henv);  
   if( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLAllocHandle(Env) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Notify ODBC that this is an ODBC 3.0 app.  
   retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER) SQL_OV_ODBC3, SQL_IS_INTEGER);  
   if( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLSetEnvAttr(ODBC version) Failed\n\n");  
      Cleanup();  
      return(9);      
   }  
  
   // Allocate ODBC connection handle and connect.  
   retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);  
   if( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLAllocHandle(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // This sample use Integrated Security. Please create the SQL Server   
   // DSN by using the Windows NT authentication.   
   retcode = SQLConnect(hdbc1, (UCHAR*)"AdventureWorks", SQL_NTS, (UCHAR*)"", SQL_NTS, (UCHAR*)"", SQL_NTS);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLConnect() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Set options to log performance statistics.  Specify file to use for the log.  
   retcode = SQLSetConnectAttr( hdbc1, SQL_COPT_SS_PERF_DATA_LOG, &"odbcperf.log", SQL_NTS);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLSetConnectAttr() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Start the performance statistics log.  
   retcode =   
      SQLSetConnectAttr( hdbc1, SQL_COPT_SS_PERF_DATA, (SQLPOINTER)SQL_PERF_START, SQL_IS_UINTEGER);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLSetConnectAttr() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Allocate statement handle, then execute command.  
   retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt1);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLAllocHandle() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   retcode = SQLExecDirect(hstmt1, (UCHAR*)"SELECT * FROM Purchasing.Vendor", SQL_NTS);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLExecDirect() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Clear any result sets generated.  
   while ( ( retcode = SQLMoreResults(hstmt1) ) != SQL_NO_DATA ) {  
      if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
         printf("SQLMoreResults() Failed\n\n");  
         Cleanup();  
         return(9);  
      }  
   }  
  
   retcode = SQLExecDirect(hstmt1, (UCHAR*)"SELECT * FROM Sales.Store", SQL_NTS);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLExecDirect() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Clear any result sets generated.  
   while ( ( retcode = SQLMoreResults(hstmt1) ) != SQL_NO_DATA ) {  
      if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
         printf("SQLMoreResults() Failed\n\n");  
         Cleanup();  
         return(9);  
      }  
   }  
  
   // Generate a long-running query.  
   retcode = SQLExecDirect(hstmt1, (UCHAR*)"waitfor delay '00:00:04' ", SQL_NTS);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLExecDirect() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Clear any result sets generated.  
   while ( ( retcode = SQLMoreResults(hstmt1) ) != SQL_NO_DATA ) {  
      if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
         printf("SQLMoreResults() Failed\n\n");  
         Cleanup();  
         return(9);  
      }  
   }  
  
   // Write current statistics to the performance log.  
   retcode =   
      SQLSetConnectAttr( hdbc1, SQL_COPT_SS_PERF_DATA_LOG_NOW, (SQLPOINTER)NULL, SQL_IS_UINTEGER);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLSetConnectAttr() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Get pointer to current SQLPerf structure.  
   // Print a couple of statistics.  
   retcode =   
      SQLGetConnectAttr( hdbc1, SQL_COPT_SS_PERF_DATA, (SQLPOINTER)&PerfPtr, SQL_IS_POINTER, &cbPerfPtr);  
   if( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLGetConnectAttr() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   printf("SQLSelects = %d, SQLSelectRows = %d\n", PerfPtr->SQLSelects, PerfPtr->SQLSelectRows);  
  
   // Cleanup  
   SQLFreeHandle(SQL_HANDLE_STMT, hstmt1);  
   SQLDisconnect(hdbc1);  
   SQLFreeHandle(SQL_HANDLE_DBC, hdbc1);  
   SQLFreeHandle(SQL_HANDLE_ENV, henv);  
}

另請參閱

分析 ODBC 驅動程式效能操作說明主題（ODBC）
分析 ODBC 驅動程式效能

共用方式為

分析 ODBC 驅動程式效能資料

使用 ODBC 系統管理員記錄驅動程式效能數據

以程式設計方式記錄驅動程式效能數據

將驅動程式效能數據提取至應用程式

範例

另請參閱

意見反應

其他資源