SQL Server 的提供者統計資料

下載 ADO.NET

從 .NET Framework 2.0 版與 .NET Core 1.0 版開始，適用於 SQL Server 的 Microsoft SqlClient Data Provider 就支援執行階段統計資料。您必須在建立有效的連線物件之後，將 StatisticsEnabled 物件的 SqlConnection 屬性設定為 True，以啟用統計資料。啟用統計資料功能後，您可以透過 SqlConnection 物件的 RetrieveStatistics 方法擷取 IDictionary 參考，以「某個時間點的快照」方式檢視這些統計資料。您可以將清單列舉為一組名稱/值對字典項目。這些名稱/值對並未排序。您隨時都可以呼叫 ResetStatistics 物件的 SqlConnection 方法來重設計數器。如果尚未啟用統計資料收集功能，就不會產生例外狀況。此外，如果在未先呼叫 RetrieveStatistics 的情況下呼叫 StatisticsEnabled，擷取的值會是每個項目的初始值。如果您啟用統計資料、執行應用程式一段時間，然後停用統計資料，擷取的值將會反映出直到停用統計資料那一刻為止，所收集到的值。所有收集到的統計值都是以個別連線為基礎。

可用的統計值

Microsoft SQL Server 提供者目前提供了 18 個不同的項目。可透過 RetrieveStatistics 傳回的 IDictionary 介面參考之 Count 屬性，取得可用項目的數量。提供者統計資料的所有計數器均使用 Common Language Runtime Int64 類型 (C# 及 Visual Basic 中的 long)，寬度為 64 位元。如 int64.MaxValue 欄位所定義，int64 資料類型的最大值是 ((2^63)-1))。當計數器的值達到此最大值時，應該就不會再被視為準確的值。這表示 int64.MaxValue-1((2^63)-2) 實際上是任何統計資料的最大有效值。

注意

字典是用來傳回提供者統計資料，因為未來所傳回統計資料的數目、名稱與順序可能會變更。應用程式不應該依賴在字典中找到的特定值，而應該改為檢查值是否存在，並據以進行分支處理。

下表說明目前可用的統計值。請注意，個別值的索引鍵名稱在 Microsoft .NET Framework 和 .NET Core 的不同地區版本之間不會進行本地化。

金鑰名稱	描述
`BuffersReceived`	傳回應用程式開始使用提供者並啟用統計資料之後，提供者從 SQL Server 接收到的表格式資料流 (TDS) 封包數目。
`BuffersSent`	傳回啟用統計資料之後，提供者傳送給 SQL Server 的 TDS 封包數目。大型命令可能會需要多個緩衝區。例如，如果將大型命令傳送至伺服器，而且該命令需要 6 個封包，`ServerRoundtrips` 就會遞增 1，`BuffersSent` 會遞增 6。
`BytesReceived`	傳回應用程式開始使用提供者並啟用統計資料之後，提供者從 SQL Server 接收到的 TDS 封包中所包含資料的位元組數目。
`BytesSent`	傳回應用程式開始使用提供者並啟用統計資料之後，TDS 封包中傳送給 SQL Server 之資料的位元組數目。
`ConnectionTime`	在啟用統計資料後連線處於開啟的時間量 (如果統計資料是在開啟連線之前啟用的，則為總連線時間)。
`CursorOpens`	傳回自應用程式開始使用提供者並啟用統計資料後，游標透過該連線開啟的次數。請注意，SELECT 陳述式傳回的唯讀/順向結果不會被視為資料指標，因此不會影響此計數器。
`ExecutionTime`	傳回啟用統計資料後，提供者在處理作業所耗用的累計時間量 (以毫秒為單位)，包括等待伺服器回覆的時間，以及提供者本身執行程式碼的時間。包含計時程式碼的類別如下： SqlConnection SqlCommand SqlDataReader SqlDataAdapter SqlTransaction SqlCommandBuilder 為了讓對效能至關重要的成員儘可能保持精簡，下列成員不納入計時： SqlDataReader this[] 運算子 (所有多載版本) GetBoolean GetChar GetDateTime GetDecimal GetDouble GetFloat GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetSqlBinary GetSqlBoolean GetSqlByte GetSqlDateTime GetSqlDecimal GetSqlDouble GetSqlGuid GetSqlInt16 GetSqlInt32 GetSqlInt64 GetSqlMoney GetSqlSingle GetSqlString GetString IsDBNull
`IduCount`	在應用程式開始使用提供者並啟用統計資料之後，會傳回透過此連線執行的 INSERT、DELETE 和 UPDATE 陳述式總數。
`IduRows`	回傳受 INSERT、 DELETE影響的列數，以及 UPDATE 在應用程式開始使用提供者並啟用統計後，透過連線執行的語句總數。
`NetworkServerTime`	一旦應用程式已開始使用提供者並啟用統計資料後，傳回提供者等待伺服器回覆的累計時間量 (以毫秒為單位)。
`PreparedExecs`	傳回應用程式開始使用提供者並啟用統計資料後，透過連線所執行的備妥命令數目。
`Prepares`	傳回自應用程式開始使用提供者並啟用統計資料後，透過該連線已準備的陳述式數目。
`SelectCount`	傳回自應用程式開始使用提供者並啟用統計資料後，透過此連線執行的 SELECT 陳述式數目。這包括用來從游標擷取資料列的 FETCH 陳述式，而且當到達 SqlDataReader 的結尾時，會更新 SELECT 陳述式的計數值。
`SelectRows`	傳回應用程式開始使用提供者並啟用統計資料之後所選取的資料列數。此計數器會反映 SQL 陳述式產生的所有資料列，即使呼叫者並未實際取用的資料列也算在內。例如，在讀取整個結果集之前關閉資料讀取器並不會影響計數。這包括透過 FETCH 陳述式從游標擷取的資料列。
`ServerRoundtrips`	傳回應用程式開始使用提供者並啟用統計資料之後，連線傳送命令至伺服器並收到回覆的次數。
`SumResultSets`	傳回應用程式開始使用提供者並啟用統計資料之後，已使用的結果集數目。例如，這會包含傳回給用戶端的任何結果集。對於游標，每次擷取或區塊擷取作業皆視為獨立的結果集。
`Transactions`	傳回應用程式開始使用此提供者並啟用統計資料後所啟動的使用者交易數量，包括回復。如果是使用自動認可來執行連線，系統會將每個命令都視為一個交易。一旦執行 BEGIN TRAN 陳述，此計數器就會將交易計數加 1，無論該交易之後是認可還是回復。
`UnpreparedExecs`	傳回應用程式已開始使用提供者並啟用統計資料之後，透過連線所執行的未備妥陳述式數目。

取得值

下列主控台應用程式會顯示如何在連線上啟用統計資料、擷取四個獨立統計資料值，並將其寫到主控台視窗。

注意

下列範例使用包含於 SQL Server 的 AdventureWorks 範例資料庫。範例程式碼中提供的連接字串會假設資料庫安裝在本機電腦且可供使用。請依據環境需求修改連接字串。

using System;  
using System.Collections;  
using System.Collections.Generic;  
using System.Data;  
using Microsoft.Data.SqlClient;  
  
namespace CS_Stats_Console_GetValue  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      string connectionString = GetConnectionString();  
  
      using (SqlConnection awConnection =   
        new SqlConnection(connectionString))  
      {  
        // StatisticsEnabled is False by default.  
        // It must be set to True to start the   
        // statistic collection process.  
        awConnection.StatisticsEnabled = true;  
  
        string productSQL = "SELECT * FROM Production.Product";  
        SqlDataAdapter productAdapter =   
          new SqlDataAdapter(productSQL, awConnection);  
  
        DataSet awDataSet = new DataSet();  
  
        awConnection.Open();  
  
        productAdapter.Fill(awDataSet, "ProductTable");  
        // Retrieve the current statistics as  
        // a collection of values at this point  
        // and time.  
        IDictionary currentStatistics =  
          awConnection.RetrieveStatistics();  
  
        Console.WriteLine("Total Counters: " +  
          currentStatistics.Count.ToString());  
        Console.WriteLine();  
  
        // Retrieve a few individual values  
        // related to the previous command.  
        long bytesReceived =  
            (long) currentStatistics["BytesReceived"];  
        long bytesSent =  
            (long) currentStatistics["BytesSent"];  
        long selectCount =  
            (long) currentStatistics["SelectCount"];  
        long selectRows =  
            (long) currentStatistics["SelectRows"];  
  
        Console.WriteLine("BytesReceived: " +  
            bytesReceived.ToString());  
        Console.WriteLine("BytesSent: " +  
            bytesSent.ToString());  
        Console.WriteLine("SelectCount: " +  
            selectCount.ToString());  
        Console.WriteLine("SelectRows: " +  
            selectRows.ToString());  
  
        Console.WriteLine();  
        Console.WriteLine("Press any key to continue");  
        Console.ReadLine();  
      }  
  
    }  
    private static string GetConnectionString()  
    {  
      // To avoid storing the connection string in your code,  
      // you can retrieve it from a configuration file.  
      return "Data Source=localhost;Integrated Security=SSPI;" +   
        "Initial Catalog=AdventureWorks";  
    }  
  }  
}

擷取所有值

下列主控台應用程式會顯示如何在連線上啟用統計資料、使用列舉程式擷取所有可用的統計資料值，並將其寫到主控台視窗。

注意

using System;  
using System.Collections;  
using System.Collections.Generic;  
using System.Text;  
using System.Data;  
using Microsoft.Data.SqlClient;  
  
namespace CS_Stats_Console_GetAll  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      string connectionString = GetConnectionString();  
  
      using (SqlConnection awConnection =   
        new SqlConnection(connectionString))  
      {  
        // StatisticsEnabled is False by default.  
        // It must be set to True to start the   
        // statistic collection process.  
        awConnection.StatisticsEnabled = true;  
  
        string productSQL = "SELECT * FROM Production.Product";  
        SqlDataAdapter productAdapter =  
            new SqlDataAdapter(productSQL, awConnection);  
  
        DataSet awDataSet = new DataSet();  
  
        awConnection.Open();  
  
        productAdapter.Fill(awDataSet, "ProductTable");  
  
        // Retrieve the current statistics as  
        // a collection of values at this point  
        // and time.  
        IDictionary currentStatistics =  
            awConnection.RetrieveStatistics();  
  
        Console.WriteLine("Total Counters: " +  
            currentStatistics.Count.ToString());  
        Console.WriteLine();  
  
        Console.WriteLine("Key Name and Value");  
  
        // Note the entries are unsorted.  
        foreach (DictionaryEntry entry in currentStatistics)  
        {  
          Console.WriteLine(entry.Key.ToString() +  
              ": " + entry.Value.ToString());  
        }  
  
        Console.WriteLine();  
        Console.WriteLine("Press any key to continue");  
        Console.ReadLine();  
      }  
  
    }  
    private static string GetConnectionString()  
    {  
      // To avoid storing the connection string in your code,  
      // you can retrieve it from a configuration file.  
      return "Data Source=localhost;Integrated Security=SSPI;" +   
        "Initial Catalog=AdventureWorks";  
    }  
  }  
}

後續步驟

SQL Server and ADO.NET (SQL Server 和 ADO.NET)

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-07-21