Infodatei für das Beispieldienstprogramm ASTrace

  • Artikel

Mithilfe des Dienstprogramms ASTrace können Sie eine Analysis Services-Ablaufverfolgung aufzeichnen und sie in einer SQL Server-Tabelle protokollieren. Die Tabelle kann zu einem späteren Zeitpunkt abgefragt oder mithilfe von SQL Server Profiler gelesen werden. Das Dienstprogramm ASTrace wird als ein Windows-Dienst ausgeführt, von dem eine Verbindung mit Analysis Services hergestellt wird, dann eine Ablaufverfolgung erstellt wird und die Ablaufverfolgungsereignisse mit dem SQL Server Profiler-Format in einer SQL Server-Tabelle protokolliert werden. Die Ablaufverfolgung wird vom Dienstprogramm ASTrace mithilfe einer Standard-Ablaufverfolgungsvorlage erstellt, die Sie mithilfe von SQL Server Profiler erstellen können.

Szenario

Analysis Services verfügt über kein integriertes Tool, um Ablaufverfolgungen zu extrahieren und diese in einer Datei oder einer Tabelle zu speichern. Mit dem Beispieldienstprogramm ASTrace wird veranschaulicht, wie diese Ablaufverfolgungsfunktionalität implementiert wird.

Sprachen

C#

Voraussetzungen

Stellen Sie vor dem Ausführen dieses Beispiels sicher, dass die folgende Software installiert ist:

  • Microsoft SQL Server 2005, einschließlich der folgenden Komponenten:
    • Datenbankmodul
    • Analysis Services
    • SQL Server Management Studio
    • Business Intelligence Development Studio
    • Datenbankmodul-Beispiele
  • Microsoft.NET Framework SDK 2.0 oder Visual Studio 2005

Erstellen des Beispiels

Option 1: So erstellen Sie das Beispiel mithilfe von Visual Studio

  1. Suchen Sie den Ordner, in dem die Projektmappendatei ASTrace.sln gespeichert ist.

  2. Verschieben Sie die Signaturdatei ASTrace.snk in den Projektmappenordner.

  3. Öffnen Sie Visual Studio.

  4. Klicken Sie auf der Registerkarte Zuletzt geöffnete Projekte für Öffnen auf Projekt.

  5. Öffnen Sie den Ordner, in dem die Projektmappendatei ASTrace.sln gespeichert wurde, wählen Sie die Datei aus, und klicken Sie dann auf Öffnen.

  6. Drücken Sie F6, um die Projektmappe zu erstellen.

Option 2: So erstellen Sie das Beispiel mithilfe von msbuild.exe von .Net Framework SDK

  1. Suchen Sie den Ordner, in dem die Projektmappendatei ASTrace.sln gespeichert ist.

  2. Verschieben Sie die Signaturdatei ASTrace.snk in den Projektmappenordner.

  3. Öffnen Sie das Eingabeaufforderungsfenster, und wechseln Sie in das Verzeichnis in dem die Projektmappendatei gespeichert ist. Konfigurieren Sie die Umgebung gemäß den Angaben im .NET Framework-Thema des Developer's Guide, How to: Compile at the Command Prompt.

  4. Geben Sie msbuild.exe ASTrace.sln ein, und drücken Sie dann die EINGABETASTE.

Installieren des Beispiels

Im Folgenden wird beschrieben, wie das Dienstprogramm ASTrace als Dienst installiert wird.

Schritt 1: So kopieren Sie ausführbare Dateien

  • Kopieren Sie die im Folgenden aufgeführten Dateien in den Ordner, in dem der Dienst auf Ihrem Computer ausgeführt werden soll:

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

Schritt 2: So registrieren Sie den Dienst

  1. Suchen Sie in Ihrer installierten Version von Microsoft .NET Framework SDK 2.0 die Datei InstallUtil.exe.

  2. Öffnen Sie ein Eingabeaufforderungsfenster.

  3. Wechseln Sie vom aktuellen Verzeichnis in das Verzeichnis, in das die ausführbaren Dateien im vorherigen Schritt kopiert wurden.

  4. Fügen Sie dem Pfad den Ordner hinzu, in dem InstallUtil.exe enthalten ist.

  5. Führen Sie den folgenden Befehl aus, um den Dienst zu installieren:

    InstallUtil.exe ASTrace.exe

  6. Öffnen Sie unter Verwaltung das Fenster Computerverwaltung, erweitern Sie Dienste und Anwendungen, und wählen Sie dann Dienste aus.

  7. Suchen Sie im rechten Bereich nach ASTrace Service, und doppelklicken Sie darauf. Überprüfen Sie auf der Registerkarte Allgemein, ob unter Pfad zur ausführbaren Datei der richtige Pfad zu dem Speicherort angezeigt wird, an den die Dateien kopiert wurden. Der Dienst ist jetzt registriert, und Ihre Dateien werden verwendet.

    Bb283156.note(de-de,SQL.90).gifHinweis:
    Starten Sie den Dienst erst dann, wenn er im nächsten Schritt konfiguriert wurde.

Schritt 3: So konfigurieren Sie den Dienst

  1. Öffnen Sie die Datei ASTrace.exe.config in Editor oder einem anderen Text-Editor, in dem keine Steuerzeichen berücksichtigt werden.

  2. Fügen Sie den im Folgenden aufgeführten Feldern entsprechend ihrer Definition Inhalt hinzu:

    • AnalysisServerName – Name der Analysis Service-Instanz, für die eine Ablaufverfolgung durchgeführt werden soll.
    • SQLServer – Name der SQL Server-Instanz, in der die Ablaufverfolgung protokolliert wird.
    • SQLServerDatabase – Name der SQL Server-Datenbank, die die Ablaufverfolgungstabellen enthält.
    • TraceTableName – Name der Tabelle, in der die Ablaufverfolgung protokolliert werden soll.
    • TraceDefinition – Name der Datei mit der Ablaufverfolgungsvorlage, mit der Sie die Analysis Services-Ablaufverfolgung erstellt haben. Verwenden Sie SQL Server Profiler, wenn Sie die ASTrace-Vorlage ändern müssen.

Ausführen des Beispiels

Im Folgenden wird veranschaulicht, wie der Dienst gestartet und die Sicherheit konfiguriert wird.

Schritt 1: So starten Sie den Dienst

  • Öffnen Sie den Windows-Dienststeuerungs-Manager, navigieren Sie zum Dienstprogramm ASTrace, und starten Sie den Dienst.

    Wenn der Dienst erfolgreich gestartet wird, bedeutet dies, dass er eine Verbindung mit einer Instanz von Analysis Services herstellen und eine Ablaufverfolgung erstellen konnte; außerdem konnte er eine Verbindung mit SQL Server herstellen und eine Ablaufverfolgungstabelle erstellen, in die er bereits protokolliert.

    Wenn beim Starten Probleme auftreten, wird der Fehler in der Datei ASTraceService.log protokolliert, die im lokalen Installationsverzeichnis erstellt wurde. Überprüfen Sie die Namen erneut, um sicherzustellen, dass alle Servernamen richtig angegeben wurden und dass der ASTrace-Dienst die entsprechenden Sicherheitsberechtigungen besitzt. Das Dienstprogramm ASTrace wird mit dem LocalSystem-Konto installiert, damit Sie seine Funktionalität testen können.

Schritt 2: So konfigurieren Sie die Sicherheit

  1. Stellen Sie sicher, dass Sie das Dienstkonto ASTrace in ein entsprechendes lokales Benutzerkonto oder Domänenbenutzerkonto ändern. Dadurch wird die Angriffsfläche verringert.

  2. Zum Ausführen der Dienstanwendung ASTrace muss sichergestellt werden, dass das Dienstkonto, unter dem der Dienst ausgeführt wird, über folgende Berechtigungen verfügt:

    • Analysis Services-Verwaltungsberechtigungen
    • SQL Server-Datenbankadministratorrechte zum Erstellen einer Tabelle in der angegebenen Datenbank und zum Protokollieren von Ereignissen.

Entfernen des Beispiels

Gehen Sie wie folgt vor, um den Dienst zu deinstallieren.

So deinstallieren Sie den ASTrace-Dienst

  • Öffnen Sie ein Eingabeaufforderungsfenster, und führen Sie den folgenden Befehl aus:

    InstallUtil.exe ASTrace.exe