Partager via

Fichier Lisezmoi pour l'exemple d'utilitaire ASTrace

L'utilitaire ASTrace vous permet de capturer une trace Analysis Services et de l'enregistrer dans une table SQL Server. Vous pouvez interroger la table ultérieurement ou la lire à l'aide de Générateur de profils SQL Server. L'utilitaire exécute un service Windows qui se connecte à Analysis Services, puis crée une trace, et enregistrer des événements de trace dans une table SQL Server à l'aide du format Générateur de profils SQL Server. L'utilitaire ASTrace crée la trace à l'aide d'un modèle de trace standard que vous pouvez créer à l'aide de Générateur de profils SQL Server.

Scénario

Analysis Services ne possède pas d'outil intégré pour extraire des traces et les enregistrer dans un fichier ou une table. Cet exemple d'utilitaire ASTrace illustre l'implémentation de la fonctionnalité de trace.

Langages

C#

Configuration requise

Avant d'exécuter cet exemple, vérifiez que le logiciel suivant est installé :

  • Microsoft SQL Server 2005, notamment les composants suivants :
    • Moteur de base de données
    • Analysis Services
    • SQL Server Management Studio
    • Business Intelligence Development Studio
    • Les exemples Moteur de base de données
  • Microsoft.NET Framework SDK 2.0 ou Visual Studio 2005

Génération de l'exemple

Option 1 : Pour créer l'exemple à l'aide de Visual Studio

  1. Localisez le dossier dans lequel est stocké le fichier de solution ASTrace.sln.

  2. Déplacez le fichier de signature ASTrace.snk vers le dossier de solution.

  3. Ouvrez Visual Studio.

  4. Sous l'onglet Projets récents, pour Ouvrir, cliquez sur Projet.

  5. Ouvrez le dossier où vous avez enregistré le fichier de solution ASTrace.sln, sélectionnez le fichier, puis cliquez sur Ouvrir.

  6. Appuyez sur F6 pour générer le projet.

Option 2 : Pour créer l'exemple à l'aide de msbuild.exe dans .Net Framework SDK

  1. Localisez le dossier dans lequel est stocké le fichier de solution ASTrace.sln.

  2. Déplacez le fichier de signature ASTracer.snk vers le dossier de solution.

  3. Ouvrez une fenêtre d'invite de commandes et choisissez le répertoire où le fichier de solution est enregistré. Configurez l'environnement d'après les caractéristiques de la rubrique du Guide du développeur .NET Framework Comment : compiler à l'invite de commandes.

  4. Tapez msbuild.exe ASTrace.sln, puis appuyez sur Entrée.

Installation de l'exemple

Les procédures suivantes décrivent l'installation de l'utilitaire ASTrace comme service.

Étape 1 : pour copier les fichiers exécutables

  • Copiez les fichiers suivants dans le dossier où vous envisagez d'exécuter le service sur votre ordinateur :

    • ASTrace.exe
    • ASTrace.exe.config
    • Standard.tdf

Étape 2 : Pour inscrire le service

  1. Localisez InstallUtil.exe dans votre version installée du Kit de développement Microsoft .NET Framework SDK 2.0.

  2. Ouvrez une fenêtre d'invite de commandes.

  3. Remplacez le répertoire en cours par le répertoire où vous avez copié les fichiers exécutables à l'étape précédente.

  4. Ajoutez le dossier qui contient InstallUtil.exe au chemin d'accès.

  5. Exécutez la commande suivante pour installer le service :

    InstallUtil.exe ASTrace.exe

  6. Dans Outils d'administration, ouvrez Gestion de l'ordinateur, développez Services et applications, puis cliquez sur Services.

  7. Recherchez ASTrace Service dans le volet droit et double-cliquez sur celui-ci. Vérifiez sous l'onglet Général que Chemin d'accès des fichiers exécutables affiche le chemin d'accès correct où vous avez copié les fichiers. Le service est maintenant inscrit et utilise vos fichiers.

    Bb283156.note(fr-fr,SQL.90).gifRemarque :
    Ne démarrez pas le service avant de l'avoir configuré à l'étape suivante.

Étape 3 : Pour configurer le service

  1. Ouvrez le fichier ASTrace.exe.config dans Bloc-notes ou tout autre éditeur de texte qui ne comprend pas des caractères de contrôle.

  2. Ajoutez le contenu aux champs suivants en fonction de leur définition :

    • AnalysisServerName—nom de l'instance d'Analysis Service à tracer.
    • SQLServer—nom de l'instance de SQL Server dans laquelle la trace doit être enregistrée.
    • SQLServerDatabase—nom de la base de données SQL Server qui doit contenir les tables de trace.
    • TraceTableName—nom de la table dans laquelle la trace doit être enregistrée.
    • TraceDefinition—nom du fichier contenant le modèle de trace que vous avez utilisé pour créer la trace Analysis Services. Si vous devez modifier le modèle ASTrace, utilisez le Générateur de profils SQL Server.

Exécution de l'exemple

Les procédures suivantes indiquent comment démarrer le service et configurer la sécurité.

Étape 1 : Pour démarrer le service

  • Ouvrez le Gestionnaire de contrôle des services Windows, accédez à l'utilitaire ASTrace et démarrez le service.

    Si le service démarre correctement, cela signifie qu'il a pu se connecter à une instance de Analysis Services et créer une trace ; et qu'il a pu également se connecter à SQL Server, créer une table de trace et commencer à y enregistrer des données.

    Si un problème se produit au démarrage, l'erreur est consignée dans le fichier ASTraceService.log créé dans votre répertoire d'installation local. Vérifiez à nouveau les noms pour vous assurer que tous les noms de serveur spécifiés sont corrects et que le service ASTrace dispose des autorisations de sécurité appropriées. L'utilitaire ASTrace est installé à l'aide du compte LocalSystem pour vous donner la possibilité de tester ses fonctionnalités.

Étape 2 : Pour configurer la sécurité

  1. Veillez à remplacer le compte de service ASTrace par un compte d'utilisateur de domaine ou un compte local approprié. Vous réduisez ainsi la surface d'exposition attaquable.

  2. Pour exécuter l'application du service ASTrace, vous devez vérifier que le compte de service qui exécute le service possède les droits suivants :

    • Autorisation d'administrateur Analysis Services.
    • Droits d'administrateur de base de données SQL Server pour créer une table dans la base de données spécifiée et enregistrer des événements.

Suppression de l'exemple

Suivez la procédure ci-dessous pour désinstaller le service.

Pour désinstaller le service ASTrace

  • Ouvrez une fenêtre d'invite de commandes et exécutez la commande ci-dessous :

    InstallUtil.exe ASTrace.exe

  • Last updated on