Nyelv

Az SQL Server szolgáltatói statisztikái

A Microsoft.Data.SqlClient támogatja a futtatókörnyezeti statisztikákat. A statisztikák engedélyezéséhez állítsa egy érvényes SqlConnection objektum StatisticsEnabled tulajdonságát True értékre.

Miután engedélyezte a statisztikákat, hívja meg a(z) RetrieveStatistics elemet egy adott időpontbeli pillanatkép lekéréséhez az IDictionary objektumban. A számlálók olvasásához fel kell sorolni a rendezetlen név-érték párokat. A számlálók alaphelyzetbe állításához hívja meg a ResetStatistics-t.

Ha még nem engedélyezte a statisztikákat, RetrieveStatistics anélkül adja vissza az egyes számlálók kezdeti értékét, hogy kivételt dobna. A statisztikák letiltása után a számlálók megőrzik az addig gyűjtött értékeket.

Minden összegyűjtött statisztikai érték kapcsolatonkénti alapon történik.

Elérhető statisztikai értékek

A Microsoft SQL Server szolgáltatóprogram 18 statisztikai értéket tesz közzé. Olvassa el a szótár Count tulajdonságát az elérhető bejegyzések számának lekéréséhez. Minden számláló a Long 64 bites típust használja, amelynek neve C#-ban long, Visual Basicben pedig Int64.

A maximális érték, Int64.MaxValue, (2^63)-1. Ennél a határértéknél a számlálók már nem pontosak. Egy statisztika legnagyobb érvényes értéke tehát Int64.MaxValue - 1, vagy (2^63)-2.

Megjegyzés

Egy szótárat használnak a szolgáltatói statisztikák visszaadására, mert a visszaadott statisztikák száma, neve és sorrendje a jövőben változhat. Az alkalmazásoknak nem szabad a szótárban található adott értékre támaszkodniuk, hanem ellenőriznie kell, hogy az érték létezik-e, és ennek megfelelően ágaznak-e el.

Az alábbi táblázat a rendelkezésre álló statisztikai értékeket ismerteti. Az egyes értékek kulcsnevei nem honosítva vannak a .NET-keretrendszer regionális verzióiban.

Név kulcs Leírás
BuffersReceived A szolgáltató által az SQL Serverről fogadott táblázatos adatfolyam-(TDS-) csomagok számát adja vissza, miután az alkalmazás megkezdte a szolgáltató használatát, és engedélyezte a statisztikákat.
BuffersSent A statisztikai adatok engedélyezése után a szolgáltató által az SQL Servernek küldött TDS-csomagok számát adja vissza. A nagy parancsok több puffert is igényelhetnek. Ha például egy nagy parancsot küldenek a kiszolgálónak, és hat csomagra van szükség, ServerRoundtrips a rendszer eggyel növeli, és BuffersSent hattal növeli.
BytesReceived A szolgáltató által az SQL Serverről fogadott TDS-csomagokban lévő adatok bájtjainak számát adja vissza, miután az alkalmazás használatba vette a szolgáltatót, és engedélyezte a statisztikákat.
BytesSent Az SQL Servernek TDS-csomagokban küldött adatok bájtjainak számát adja vissza, miután az alkalmazás elkezdte használni a szolgáltatót, és engedélyezte a statisztikákat.
ConnectionTime Az az idő (ezredmásodpercben), amelyet a kapcsolat a statisztikák engedélyezése után nyitott meg (teljes kapcsolati idő, ha a statisztikát engedélyezték a kapcsolat megnyitása előtt).
CursorOpens Azt adja vissza, hogy a kurzor hányszor volt megnyitva a kapcsolaton keresztül, miután az alkalmazás elkezdte használni a szolgáltatót, és engedélyezte a statisztikákat.

Vegye figyelembe, hogy az utasítások által SELECT visszaadott csak olvasható/csak előre léptethető eredmények nem tekinthetők kurzornak, ezért nem befolyásolják ezt a számlálót.
ExecutionTime Azt az összesített időt adja vissza (ezredmásodpercben), amelyet a szolgáltató a statisztikák engedélyezése után töltött feldolgozással, beleértve a kiszolgálótól érkező válaszokra való várakozást, valamint a kódnak a szolgáltatóban való végrehajtásával töltött időt.

Az időzítési kódot tartalmazó osztályok a következők:

SqlConnection

SqlCommand

SqlDataReader

SqlDataAdapter

SqlTransaction

SqlCommandBuilder

A teljesítmény szempontjából kritikus tagok lehető legkisebb számának megtartása érdekében a következő tagok nem időznek:

SqlDataReader

this[] operátor (az összes túlterhelése)

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 A kapcsolaton keresztül végrehajtott utasítások és INSERT utasítások teljes számát DELETEUPDATEadja vissza, miután az alkalmazás elkezdte használni a szolgáltatót, és engedélyezte a statisztikákat.
IduRows A kapcsolaton keresztül végrehajtott INSERT, DELETE és UPDATE utasítások által érintett sorok összes számát adja vissza, miután az alkalmazás használni kezdte a szolgáltatót, és engedélyezte a statisztikákat.
NetworkServerTime Azt az összesített időt adja vissza (ezredmásodpercben), amelyet a szolgáltató a kiszolgálótól kapott válaszokra való várakozással töltött, miután az alkalmazás használatba vette a szolgáltatót, és engedélyezte a statisztikákat.
PreparedExecs A kapcsolaton keresztül végrehajtott előkészített parancsok számát adja vissza, miután az alkalmazás megkezdte a szolgáltató használatát, és engedélyezte a statisztikákat.
Prepares A kapcsolaton keresztül készített utasítások számát adja vissza, miután az alkalmazás megkezdte a szolgáltató használatát, és engedélyezte a statisztikákat.
SelectCount Az alkalmazás a statisztikák engedélyezése után visszaadja a kapcsolaton keresztül végrehajtott SELECT utasítások számát. Olyan utasításokat tartalmaz FETCH , amelyek sorokat kérnek le a kurzorokból. SELECT utasítások esetén a szolgáltató frissíti a számlálót, amikor a(z) SqlDataReader eléri az eredményhalmaz végét.
SelectRows A kiválasztott sorok számát adja vissza, miután az alkalmazás megkezdte a szolgáltató használatát, és engedélyezte a statisztikákat. Ez a számláló az SQL-utasítások által létrehozott összes sort tükrözi, még azokat is, amelyeket a hívó ténylegesen nem használt fel. Az adatolvasó bezárása például a teljes eredményhalmaz elolvasása előtt nem befolyásolja a darabszámot. Ide tartoznak a kurzorokból a FETCH utasításokkal lekért sorok.
ServerRoundtrips Azt adja vissza, hogy a kapcsolat hányszor küldött parancsokat a kiszolgálónak, és kapott választ, miután az alkalmazás elkezdte használni a szolgáltatót, és engedélyezte a statisztikákat.
SumResultSets Azoknak az eredményhalmazoknak a számát adja vissza, amelyeket az alkalmazás a szolgáltató használatának megkezdése és a statisztikák engedélyezése után használt. Ilyen például az ügyfélnek visszaküldött eredményhalmaz. A kurzorok esetében minden beolvasási vagy blokklehívási művelet független eredményhalmaznak minősül.
Transactions Azon felhasználói tranzakciók számát adja vissza, amelyek akkor kezdődtek, amikor az alkalmazás használatba vette a szolgáltatót, és engedélyezte a statisztikákat, beleértve a visszaállításokat is. Ha egy kapcsolat automatikus véglegesítéssel fut, az egyes parancsok tranzakciónak minősülnek.

Ez a számláló az utasítás végrehajtásakor BEGIN TRAN azonnal növeli a tranzakciók számát, függetlenül attól, hogy a tranzakció véglegesítése vagy későbbi visszagördítése történik-e.
UnpreparedExecs A kapcsolaton keresztül végrehajtott nem előkészített utasítások számát adja vissza, miután az alkalmazás elkezdte használni a szolgáltatót, és engedélyezte a statisztikákat.

Érték beolvasása

Az alábbi konzolalkalmazás bemutatja, hogyan engedélyezheti a statisztikát egy kapcsolaton, hogyan kérdezhet le négy egyedi statisztikai értéket, és hogyan írhatja ki őket a konzolablakba.

Megjegyzés

Az alábbi példa az SQL Serverhez mellékelt mintaadatbázist AdventureWorks használja. A mintakódban megadott kapcsolati sztring feltételezi, hogy az adatbázis telepítve van, és elérhető a helyi számítógépen. Szükség szerint módosítsa a kapcsolati karakterláncot a környezethez.

Option Strict On

Imports System
Imports System.Collections
Imports System.Data
Imports Microsoft.Data.SqlClient

Module Module1

  Sub Main()
    Dim connectionString As String = GetConnectionString()

    Using awConnection As New SqlConnection(connectionString)
      ' StatisticsEnabled is False by default.
      ' It must be set to True to start the
      ' statistic collection process.
      awConnection.StatisticsEnabled = True

      Dim productSQL As String = "SELECT * FROM Production.Product"
      Dim productAdapter As _
          New SqlDataAdapter(productSQL, awConnection)

      Dim awDataSet As New DataSet()

      awConnection.Open()

      productAdapter.Fill(awDataSet, "ProductTable")

      ' Retrieve the current statistics as
      ' a collection of values at this point
      ' and time.
      Dim currentStatistics As IDictionary = _
          awConnection.RetrieveStatistics()

      Console.WriteLine("Total Counters: " & _
          currentStatistics.Count.ToString())
      Console.WriteLine()

      ' Retrieve a few individual values
      ' related to the previous command.
      Dim bytesReceived As Long = _
          CLng(currentStatistics.Item("BytesReceived"))
      Dim bytesSent As Long = _
          CLng(currentStatistics.Item("BytesSent"))
      Dim selectCount As Long = _
          CLng(currentStatistics.Item("SelectCount"))
      Dim selectRows As Long = _
          CLng(currentStatistics.Item("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()
    End Using

  End Sub

  Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file.
    Return "..."
  End Function
End Module
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 "...";
    }
  }
}

Az összes érték lekérdezése

Az alábbi konzolalkalmazás bemutatja, hogyan engedélyezheti a statisztikát egy kapcsolaton, hogyan kérdezheti le az összes elérhető statisztikai értéket az enumerátor használatával, és hogyan írhatja őket a konzolablakba.

Megjegyzés

Az alábbi példa az SQL Serverhez mellékelt mintaadatbázist AdventureWorks használja. A mintakódban megadott kapcsolati sztring feltételezi, hogy az adatbázis telepítve van, és elérhető a helyi számítógépen. Szükség szerint módosítsa a kapcsolati karakterláncot a környezethez.

Option Strict On

Imports System
Imports System.Collections
Imports System.Data
Imports Microsoft.Data.SqlClient

Module Module1
  Sub Main()
    Dim connectionString As String = GetConnectionString()

    Using awConnection As New SqlConnection(connectionString)
      ' StatisticsEnabled is False by default.
      ' It must be set to True to start the
      ' statistic collection process.
      awConnection.StatisticsEnabled = True

      Dim productSQL As String = "SELECT * FROM Production.Product"
      Dim productAdapter As _
          New SqlDataAdapter(productSQL, awConnection)

      Dim awDataSet As New DataSet()

      awConnection.Open()

      productAdapter.Fill(awDataSet, "ProductTable")

      ' Retrieve the current statistics as
      ' a collection of values at this point
      ' and time.
      Dim currentStatistics As IDictionary = _
          awConnection.RetrieveStatistics()

      Console.WriteLine("Total Counters: " & _
          currentStatistics.Count.ToString())
      Console.WriteLine()

      Console.WriteLine("Key Name and Value")

      ' Note the entries are unsorted.
      For Each entry As DictionaryEntry In currentStatistics
        Console.WriteLine(entry.Key.ToString() & _
            ": " & entry.Value.ToString())
      Next

      Console.WriteLine()
      Console.WriteLine("Press any key to continue")
      Console.ReadLine()
    End Using

  End Sub

  Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file.
    Return "..."
  End Function
End Module
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 "...";
    }
  }
}

Lásd még