• Article

Procédure : définir le profil des données de performances du pilote (ODBC)

La structure SQLPERF est définie dans Odbcss.h.

Un exemple complet et disponible décrit à la fois la création d'un fichier journal des données de performances et l'affichage de ces données directement à partir de la structure de données SQLPERF. L'exemple de code complet se trouve dans le fichier CreateAndDisplayPerformanceLog.cpp que vous pouvez télécharger depuis la page des Téléchargements SQL Server sur MSDN Cet exemple a été développé à l'aide de Microsoft Visual C++ 2005 et conçu pour la version 3.0 ou ultérieure d'ODBC.

Remarque relative à la sécuritéRemarque relative à la sécurité

Si possible, utilisez l'authentification Windows. Si l'authentification Windows n'est pas disponible, invitez les utilisateurs à entrer leurs informations d'identification au moment de l'exécution. Évitez de stocker ces informations dans un fichier. Si vous devez rendre les informations d'identification persistantes, chiffrez-les avec l'API de chiffrement Win32.

Pour enregistrer les données de performances du pilote à l'aide de l'Administrateur ODBC

  1. Dans le Panneau de configuration, double-cliquez sur Outils d'administration, puis sur Sources de données (ODBC). Vous pouvez également appeler l'exécutable odbcad32.exe.

  2. Cliquez sur l'onglet Utilisateur DSN, Système DSN ou Fichier DSN.

  3. Cliquez sur la source de données dont vous souhaitez consigner les performances.

  4. Cliquez sur Configurer.

  5. Dans l'Assistant Configuration DSN de Microsoft SQL Server, accédez à la page munie de l'option Enregistrer les statistiques de pilote ODBC dans le fichier journal.

  6. Sélectionnez Enregistrer les statistiques de pilote ODBC dans le fichier journal. Dans la zone, tapez le nom du fichier dans lequel les statistiques sont à enregistrer. Éventuellement, cliquez sur Parcourir pour rechercher le système de fichiers pour le journal des statistiques.

Pour enregistrer les données de performances du pilote par programme

  1. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA_LOG et spécifiez le chemin d'accès complet et le nom du fichier journal des données de performances. Par exemple :

    "C:\\Odbcperf.log"

  2. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA et SQL_PERF_START pour commencer à enregistrer les données de performances.

  3. Si besoin, appelez SQLGetConnectAttr avec SQL_COPT_SS_LOG_NOW et NULL pour écrire un enregistrement délimité par des tabulations des données de performances dans le fichier journal de ces dernières. Vous pouvez effectuer plusieurs fois cette opération en cours d'exécution de l'application.

  4. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA et SQL_PERF_STOP pour arrêter l'enregistrement des données de performances.

Pour extraire les données de performances du pilote dans une application

  1. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA et SQL_PERF_START pour commencer à définir le profil des données de performances.

  2. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA et l'adresse d'un pointeur vers une structure SQLPERF. Le premier appel définit le pointeur sur l'adresse d'une structure SQLPERF valide qui contient les données de performances actuelles. Le pilote n'actualise pas en permanence les données dans la structure de performance. L'application doit réitérer l'appel à SQLGetConnectAttr chaque fois qu'elle doit actualiser la structure avec des données de performances plus à jour.

  3. Appelez SQLGetConnectAttr avec SQL_COPT_SS_PERF_DATA et SQL_PERF_STOP pour arrêter l'enregistrement des données de performances.