Idioma
Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Microsoft.Data.SqlClient suporta estatísticas em tempo de execução. Ative as estatísticas definindo a propriedade StatisticsEnabled num objeto SqlConnection válido como True.
Depois de ativares as estatísticas, chama RetrieveStatistics para obteres um instantâneo de um determinado momento no objeto IDictionary. Enumere os respetivos pares nome/valor sem ordem específica para ler os contadores. Para reiniciar os contadores, invoque ResetStatistics.
Se não tiver ativado as estatísticas, RetrieveStatistics devolve o valor inicial de cada contador sem lançar uma exceção. Depois de desativares as estatísticas, os contadores mantêm os valores recolhidos até esse ponto.
Todos os valores estatísticos recolhidos são calculados individualmente por ligação.
Valores estatísticos disponíveis
O fornecedor do Microsoft SQL Server expõe 18 valores estatísticos. Leia a propriedade Count do dicionário para obter o número de entradas disponíveis. Todos os contadores utilizam Int64, o tipo de 64 bits nomeado long em C# e Long no Visual Basic.
O valor máximo, Int64.MaxValue, é (2^63)-1. Nesse limite, os contadores já não são precisos. O valor válido máximo para uma estatística é, portanto Int64.MaxValue - 1, , ou (2^63)-2.
Nota
Um dicionário é usado para retornar estatísticas do provedor porque o número, os nomes e a ordem das estatísticas retornadas podem mudar no futuro. Os aplicativos não devem confiar em um valor específico encontrado no dicionário, mas devem verificar se o valor está lá e ramificar de acordo.
A tabela seguinte descreve os valores estatísticos disponíveis. Os nomes de chave para os valores individuais não estão localizados em versões regionais do .NET Framework.
| Nome da chave | Descrição |
|---|---|
BuffersReceived |
Retorna o número de pacotes de fluxo de dados tabulares (TDS) recebidos pelo provedor do SQL Server depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
BuffersSent |
Retorna o número de pacotes TDS enviados ao SQL Server pelo provedor após a habilitação das estatísticas. Comandos grandes podem exigir vários buffers. Por exemplo, se um comando grande é enviado para o servidor e requer seis pacotes, ServerRoundtrips é incrementado em um e BuffersSent é incrementado em seis. |
BytesReceived |
Retorna o número de bytes de dados nos pacotes TDS recebidos pelo provedor do SQL Server depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
BytesSent |
Retorna o número de bytes de dados enviados ao SQL Server em pacotes TDS depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
ConnectionTime |
A quantidade de tempo (em milissegundos) que a conexão foi aberta após as estatísticas terem sido habilitadas (tempo total de conexão se as estatísticas foram habilitadas antes de abrir a conexão). |
CursorOpens |
Retorna o número de vezes que um cursor foi aberto através da conexão depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. Note que os resultados apenas de leitura/apenas avançar devolvidos por instruções SELECT não são considerados cursores e, portanto, não afetam este contador. |
ExecutionTime |
Retorna a quantidade acumulada de tempo (em milissegundos) que o provedor gastou processando depois que as estatísticas foram habilitadas, incluindo o tempo gasto aguardando respostas do servidor, bem como o tempo gasto executando código no próprio provedor. As classes que incluem código de temporização são: SqlConnectionSqlCommandSqlDataReaderSqlDataAdapterSqlTransactionSqlCommandBuilderPara manter os componentes críticos de desempenho tão reduzidos quanto possível, os seguintes elementos não são cronometrados: SqlDataReaderthis[] operator (todas as substituições)GetBooleanGetCharGetDateTimeGetDecimalGetDoubleGetFloatGetGuidGetInt16GetInt32GetInt64GetNameGetOrdinalGetSqlBinaryGetSqlBooleanGetSqlByteGetSqlDateTimeGetSqlDecimalGetSqlDoubleGetSqlGuidGetSqlInt16GetSqlInt32GetSqlInt64GetSqlMoneyGetSqlSingleGetSqlStringGetStringIsDBNull |
IduCount |
Devolve o número total de INSERT, DELETE, e UPDATE instruções executadas através da ligação assim que a aplicação começou a usar o fornecedor e ativou as estatísticas. |
IduRows |
Devolve o número total de linhas afetadas por INSERT, DELETE, e UPDATE instruções executadas através da ligação depois de a aplicação começar a usar o fornecedor e ter as estatísticas ativadas. |
NetworkServerTime |
Retorna a quantidade acumulada de tempo (em milissegundos) que o provedor gastou aguardando respostas do servidor depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
PreparedExecs |
Retorna o número de comandos preparados executados através da conexão depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
Prepares |
Retorna o número de instruções preparadas através da conexão depois de a aplicação ter começado a usar o fornecedor e ter ativado as estatísticas. |
SelectCount |
Retorna o número de SELECT instruções executadas através da ligação após a aplicação ativar estatísticas. Inclui FETCH instruções que recuperam linhas dos cursores. Para instruções SELECT, o prestador atualiza a contagem quando o SqlDataReader chega ao fim dos resultados. |
SelectRows |
Retorna o número de linhas selecionadas depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. Esse contador reflete todas as linhas geradas pelas instruções SQL, mesmo aquelas que não foram realmente consumidas pelo chamador. Por exemplo, fechar um leitor de dados antes de ler todo o conjunto de resultados não afetaria a contagem. Isto inclui as linhas recuperadas dos cursores através de instruções FETCH. |
ServerRoundtrips |
Retorna o número de vezes que a conexão enviou comandos para o servidor e obteve uma resposta de volta assim que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
SumResultSets |
Retorna o número de conjuntos de resultados que foram usados depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. Por exemplo, isso incluiria qualquer conjunto de resultados devolvido ao cliente. Para cursores, cada operação de busca ou busca em bloco é considerada um conjunto de resultados independente. |
Transactions |
Retorna o número de transações de usuário iniciadas depois que o aplicativo começou a usar o provedor e habilitou estatísticas, incluindo reversões. Se uma conexão estiver sendo executada com confirmação automática ativada, cada comando será considerado uma transação. Este contador incrementa a contagem de transações assim que uma BEGIN TRAN instrução é executada, independentemente de a transação ser confirmada ou revertida posteriormente. |
UnpreparedExecs |
Retorna o número de instruções não preparadas executadas por meio da conexão depois que o aplicativo começou a usar o provedor e habilitou as estatísticas. |
Recuperando um valor
O aplicativo de console a seguir mostra como habilitar estatísticas em uma conexão, recuperar quatro valores estatísticos individuais e gravá-los na janela do console.
Nota
O exemplo seguinte utiliza a base de dados de exemplo AdventureWorks incluída no SQL Server. A cadeia de conexão fornecida no código de exemplo pressupõe que o banco de dados esteja instalado e disponível no computador local. Modifique a cadeia de conexão conforme necessário para seu ambiente.
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 "...";
}
}
}
Recuperando todos os valores
O aplicativo de console a seguir mostra como habilitar estatísticas em uma conexão, recuperar todos os valores estatísticos disponíveis usando o enumerador e gravá-los na janela do console.
Nota
O exemplo seguinte utiliza a base de dados de exemplo AdventureWorks incluída no SQL Server. A cadeia de conexão fornecida no código de exemplo pressupõe que o banco de dados esteja instalado e disponível no computador local. Modifique a cadeia de conexão conforme necessário para seu ambiente.
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 "...";
}
}
}