Criando perfil de desempenho do driver ODBC

O driver ODBC do SQL Server Native Client pode criar o perfil de dois tipos de dados de desempenho:

• Consultas de execução longa.

  O driver pode gravar em um arquivo de log qualquer consulta que não obtenha uma resposta do servidor dentro de um período especificado. Os programadores de aplicativos ou administradores de banco de dados podem pesquisar cada instrução SQL registrada para determinar como eles podem melhorar seu desempenho.

• Dados de desempenho do driver.

  O driver pode registrar estatísticas de desempenho e gravá-las em um arquivo ou disponibilizá-las para um aplicativo por meio de uma estrutura de dados específica do driver chamada SQLPERF. O arquivo que contém as estatísticas de desempenho é um arquivo delimitado por tabulação que pode ser facilmente analisado com qualquer planilha que dê suporte a arquivos delimitados por tabulação, como o Microsoft Excel.

Qualquer tipo de criação de perfil pode ser ativado por:

• Conectando-se a uma fonte de dados que especifica o registro em log.

• Chamando SQLSetConnectAttr para definir atributos específicos do driver que controlam a criação de perfil.

Cada processo de aplicativo obtém sua própria cópia do driver ODBC do SQL Server Native Client e a criação de perfil é global para a combinação de uma cópia de driver e um processo de aplicativo. Quando qualquer coisa no aplicativo ativa a criação de perfil, a criação de perfil registra informações para todas as conexões ativas no driver desse aplicativo. Até mesmo conexões que não chamaram especificamente para criação de perfil estão incluídas.

Depois que o driver abrir um log de criação de perfil (os dados de desempenho ou o log de consultas de execução prolongada), ele não fechará o log até que o driver seja descarregado pelo Gerenciador de Driver ODBC, quando um aplicativo libera todo o ambiente que o manipula aberto no driver. Se o aplicativo abrir um novo identificador de ambiente, uma nova cópia do driver será carregada. Se o aplicativo se conectar a uma fonte de dados que especifica o mesmo arquivo de log ou definir os atributos específicos do driver para fazer logon no mesmo arquivo, o driver substituirá o log antigo.

Se um aplicativo iniciar a criação de perfil para um arquivo de log e um segundo aplicativo tentar iniciar a criação de perfil para o mesmo arquivo de log, o segundo aplicativo não poderá registrar nenhum dado de criação de perfil. Se o segundo aplicativo iniciar a criação de perfil depois que o primeiro aplicativo descarregar seu driver, o segundo aplicativo substituirá o arquivo de log do primeiro aplicativo.

Se um aplicativo se conectar a uma fonte de dados que tenha a criação de perfil habilitada, o driver retornará SQL_ERROR se o aplicativo chamar SQLSetConnectOption para iniciar o registro em log. Uma chamada para SQLGetDiagRec retorna o seguinte:

SQLState: 01000, pfNative = 0  
ErrorMsg: [Microsoft][SQL Server Native Client]  
   An error has occurred during the attempt to access  
   the log file, logging disabled.  

O driver para de coletar dados de desempenho quando um identificador de ambiente é fechado. Se um aplicativo SQL Server Native Client tiver várias conexões, cada uma com seu próprio identificador de ambiente, o driver interromperá a coleta de dados de desempenho quando qualquer um dos identificadores de ambiente associados for fechado.

Os dados de desempenho do driver podem ser armazenados na estrutura de dados SQLPERF ou registrados em um arquivo delimitado por tabulação. Os dados incluem as seguintes categorias de estatísticas:

• Perfil do aplicativo

• Conexão

• Rede

• Hora

Na tabela a seguir, as descrições dos campos na estrutura de dados SQLPERF também se aplicam às estatísticas registradas no arquivo de log de desempenho.

Estatísticas de perfil de aplicativo

Estatísticas de Tempo

Consulte Também

SQL Server Native Client (ODBC)
Criação de perfil de tópicos de instruções de desempenho do driver ODBC (ODBC)