Compartilhar via


Como analisar dados de desempenho de driver (ODBC)

A estrutura SQLPERF é definida em Odbcss.h.

Está disponível um exemplo que mostra tanto a criação de um arquivo de log de dados de desempenho quanto a exibição direta dos dados de desempenho da estrutura de dados SQLPERF. O exemplo de código completo está no arquivo CreateAndDisplayPerformanceLog.cpp, que você pode baixar na página de Downloads do SQL Server do MSDN. Esse exemplo foi desenvolvido com o Microsoft Visual C++ 2005 para o ODBC versão 3.0 ou posterior.

Observação sobre segurançaObservação sobre segurança

Quando possível, use a Autenticação do Windows. Se a Autenticação do Windows não estiver disponível, solicite aos usuários que digitem suas credenciais em tempo de execução. Evite armazenar as credenciais em um arquivo. Se for necessário manter as credenciais, criptografe-as com a API de criptografia Win32.

Para registrar dados de desempenho de driver usando o Administrador ODBC

  1. Em Painel de Controle, clique duas vezes em Ferramentas Administrativas e clique duas vezes em Fontes de Dados (ODBC). Como alternativa, você pode invocar odbcad32.exe.

  2. Clique na guia DSN do Usuário, DSN de Sistema ou DSN de Arquivo.

  3. Clique na fonte de dados para a qual você registrará o desempenho.

  4. Clique em Configurar.

  5. No Assistente de Configuração do DSN do Microsoft SQL Server, navegue até a página com a caixa de seleção Registrar estatísticas de driver ODBC no arquivo de log.

  6. Selecione Registrar estatísticas de driver ODBC no arquivo de log. Na caixa, coloque o nome do arquivo em que as estatísticas deveriam ser registradas. Outra opção é clicar em Procurar para procurar no sistema de arquivos pelo log de estatísticas.

Para registrar os dados de desempenho de driver por programação

  1. Chame SQLSetConnectAttr com SQL_COPT_SS_PERF_DATA_LOG e o caminho completo e nome do arquivo de log de dados de desempenho. Por exemplo:

    "C:\\Odbcperf.log"
    
  2. Chame SQLSetConnectAttr com SQL_COPT_SS_PERF_DATA e SQL_PERF_START para iniciar o log dos dados de desempenho.

  3. Outra opção é chamar SQLSetConnectAttr com SQL_COPT_SS_LOG_NOW e NULL para gravar um registro delimitado por tabulação dos dados de desempenho no arquivo de log de dados de desempenho. Isso pode ser feito várias vezes enquanto o aplicativo é executado.

  4. Chame SQLSetConnectAttr com SQL_COPT_SS_PERF_DATA e SQL_PERF_STOP para parar o log dos dados de desempenho.

Para receber os dados de desempenho de driver em um aplicativo

  1. Chame SQLSetConnectAttr com SQL_COPT_SS_PERF_DATA e SQL_PERF_START para iniciar a análise dos dados de desempenho.

  2. Chame SQLGetConnectAttr com SQL_COPT_SS_PERF_DATA e o endereço de um ponteiro para uma estrutura SQLPERF. A primeira chamada define o ponteiro como o endereço de uma estrutura SQLPERF válida que contém os dados de desempenho atuais. O driver não atualiza os dados continuamente na estrutura de desempenho. O aplicativo precisa repetir a chamada para SQLGetConnectAttr sempre que precisa atualizar a estrutura com mais dados de desempenho atuais.

  3. Chame SQLSetConnectAttr com SQL_COPT_SS_PERF_DATA e SQL_PERF_STOP para parar o log dos dados de desempenho.