RML-Hilfsprogramme (Replay Markup Language) für SQL Server

  • Artikel

In diesem Artikel wird eine Gruppe von Tools erläutert, die von Supportexperten zur Problembehandlung von Microsoft SQL Server verwendet werden.

Ursprüngliche Produktversion: SQL Server
Ursprüngliche KB-Nummer: 944837

Einführung

Das SQL Server-Supportteam verwendet mehrere intern geschriebene Tools, um typische Kundensupportfälle zu verarbeiten. RmL-Hilfsprogramme (Replay Markup Language) für SQL Server ist eine spezielle Toolsuite, die Datenbankentwickler und Systemadministratoren verwenden können.

Weitere Informationen

Sie können RML-Hilfsprogramme für SQL Server verwenden, um die folgenden Aufgaben auszuführen:

  • Bestimmen Sie, welche Anwendung, Datenbank, SQL Server Anmeldung oder Abfrage die maximalen Ressourcen verwendet.
  • Bestimmen Sie, ob der Ausführungsplan für einen Batch geändert wird, wenn Sie die Ablaufverfolgung für den Batch erfassen. Darüber hinaus können Sie RML-Hilfsprogramme für SQL Server verwenden, um zu bestimmen, wie SQL Server diese Pläne ausführt.
  • Bestimmen Sie, welche Abfragen langsam ausgeführt werden.

Nachdem Sie eine Ablaufverfolgung für eine instance SQL Server erfasst haben, können Sie rml Utilities for SQL Server verwenden, um die Ablaufverfolgungsdatei für eine andere instance SQL Server wiederzuverwenden. Wenn Sie die Ablaufverfolgung auch während der Wiedergabe erfassen, können Sie RML Utilities for SQL Server verwenden, um die neue Ablaufverfolgungsdatei mit der ursprünglichen Ablaufverfolgungsdatei zu vergleichen. Sie können diese Technik verwenden, um zu testen, wie sich SQL Server verhält, nachdem Sie Änderungen angewendet haben. Sie können diese Technik beispielsweise verwenden, um zu testen, wie sich SQL Server verhält, nachdem Sie die folgenden Aufgaben ausgeführt haben:

  • Installieren eines SQL Server Service Packs
  • Installieren eines SQL Server Hotfixes
  • Aktualisieren einer gespeicherten Prozedur oder funktion
  • Aktualisieren eines Index oder Erstellen eines Indexes

Versionsverlauf

Versionsnummer Beschreibung
09.04.0102 Gibt das aktuelle Webrelease an, das im Microsoft Download Center verfügbar ist. Es unterstützt alle veröffentlichten Versionen von SQL Server (SQL Server 2022, SQL Server 2019, SQL Server 2017, SQL Server 2016, SQL Server 2014, SQL Server 2012, SQL Server 2008 R2 und SQL Server 2008).
9.04.0100 Das vorherige Webrelease, das im Microsoft Download Center verfügbar ist. Es unterstützt alle veröffentlichten Versionen von SQL Server (SQL Server 2019, SQL Server 2017, SQL Server 2016, SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 und SQL Server 2000).
9.04.0098 Gibt das aktuelle Releasepaket an, das im Assistent für Datenbankexperimente-Tool enthalten ist. Es unterstützt alle veröffentlichten Versionen von SQL Server.
9.04.0097 Gibt die aktuelle Version an, die auf der SQL Nexus-Website verfügbar ist und alle veröffentlichten Versionen von SQL Server unterstützt.
9.04.0051 Das vorherige Webrelease, das im Microsoft Download Center verfügbar ist und SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 und SQL Server 2000 unterstützt.
9.04.0004 Das vorherige Webrelease, das SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 und SQL Server 2000 unterstützt.
9.01.0109 Das vorherige Webrelease, das SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 und SQL Server 2000 unterstützt.
9.00.0023 Das vorherige Webrelease, das SQL Server 2005 und SQL Server 2000 unterstützt.
8.10.0010 Das erste Webrelease, das SQL Server 2000 und SQL Server 7.0 unterstützt.

Die aktuelle Version von RML Utilities for SQL Server ersetzt alle früheren Versionen. Sie müssen alle früheren Versionen von RML Utilities for SQL Server deinstallieren, bevor Sie die aktuelle Version installieren. Die aktuelle Version der Toolsuite enthält wichtige Softwareupdates, verbesserte Features (Verarbeiten von TRC - und XEL-Dateien ) und Berichten sowie Leistungs- und Skalierbarkeitsverbesserungen.

Abrufen der RML-Hilfsprogramme für SQL Server

  • RML Utilities for SQL Server steht im Microsoft Download Center zum Download zur Verfügung.

  • Nachdem Sie die Assistent für Datenbankexperimente installiert haben, finden Sie die RML-Tools (ReadTrace und OStress) im C:\Program Files (x86)\Microsoft Corporation\Database Experimentation Assistant\Dependencies\X64\ Ordner.

Hinweis

Microsoft stellt RML-Hilfsprogramme für SQL Server bereit. Microsoft Customer Support Services (CSS) bietet keinen Support oder Updates für die Suite. Wenn Sie einen Vorschlag haben oder einen Fehler melden möchten, können Sie die E-Mail-Adresse im Thema "Probleme und Unterstützung" in der Hilfedatei (RML Help.pdf) verwenden. Die Hilfedatei ist in den RML-Hilfsprogrammen für SQL Server enthalten.

Vorteile von RML-Hilfsprogrammen für SQL Server

RML Utilities for SQL Server ist nützlich, wenn Sie Anwendungstests simulieren möchten, wenn es nicht praktikabel oder unmöglich ist, mit der realen Anwendung zu testen. In einer Testumgebung kann es schwierig sein, die gleiche Benutzerauslastung wie in der Produktionsumgebung zu generieren. Sie können RML-Hilfsprogramme für SQL Server verwenden, um eine Produktionsworkload in einer Testumgebung wiederzuverwenden und die Auswirkungen von Änderungen auf die Leistung zu bewerten. Sie können beispielsweise ein Upgrade auf SQL Server 2008 oder die Anwendung eines SQL Server Service Packs testen. Darüber hinaus können Sie RML-Hilfsprogramme für SQL Server verwenden, um verschiedene Wiedergabeworkloads zu analysieren und zu vergleichen. Diese Art der Regressionsanalyse wäre andernfalls ein schwieriger Prozess, den Sie manuell durchführen müssten.

Die Hilfedatei enthält ein Schnellstartthema. Dieses Thema enthält eine kurze Übung, in der Sie mit jedem RML-Tool vertraut gemacht werden. Um die Hilfedatei zu öffnen, wählen Sie Start aus, zeigen Sie auf Alle Programme, zeigen Sie auf RML-Hilfsprogramme für SQL Server, zeigen Sie auf Hilfe, und wählen Sie dann RML-Hilfe aus.

Tools in RML Utilities for SQL Server

RML Utilities for SQL Server enthält die folgenden Tools:

  • ReadTrace
  • Reporter
  • OStress
  • OStress Replay Control Agent (ORCA)

Eine vollständige Beschreibung aller Tools und Beispielverwendungen finden Sie in der RML-Hilfedatei, die in RML Utilities for SQL Server enthalten ist.

Abhängigkeiten für RML-Hilfsprogramme für SQL Server

Wichtig

Die Anwendungen, die als Teil der RML-Toolsuite bereitgestellt werden, erfordern, dass mehrere zusätzliche Steuerelemente verfügbar gemacht werden.

Abhängigkeiten für Reporter

  1. Sie müssen sicherstellen, dass die Berichts-Viewer-Steuerelemente entweder im gleichen Ordner wie Reporter.exe oder im globalen Assemblycache (GAC) verfügbar sind. Die DLLs, die Reporter.exe benötigt, sind:

    • Microsoft.ReportViewer.Common.dll
    • Microsoft.ReportViewer.DataVisualization.dll
    • Microsoft.ReportViewer.ProcessingObjectModel.dll
    • Microsoft.ReportViewer.WinForms.dll

    Sie können diese DLLs mithilfe des folgenden PowerShell-Skripts herunterladen:

    Register-PackageSource -Name MyNuGet -Location https://www.nuget.org/api/v2 -ProviderName NuGet
Get-PackageSource

Find-Package Microsoft.ReportViewer.Common -AllVersions
Install-Package Microsoft.ReportViewer.Common -RequiredVersion 10.0.40219.1

Copy-Item -Path "C:\Program Files\PackageManagement\NuGet\Packages\Microsoft.ReportViewer.Common.10.0.40219.1\lib\Microsoft.ReportViewer.Common.dll" -Destination "C:\Program Files\Microsoft Corporation\RMLUtils"
Copy-Item -Path "C:\Program Files\PackageManagement\NuGet\Packages\Microsoft.ReportViewer.Common.10.0.40219.1\lib\Microsoft.ReportViewer.DataVisualization.dll" -Destination "C:\Program Files\Microsoft Corporation\RMLUtils"
Copy-Item -Path "C:\Program Files\PackageManagement\NuGet\Packages\Microsoft.ReportViewer.Common.10.0.40219.1\lib\Microsoft.ReportViewer.ProcessingObjectModel.dll" -Destination "C:\Program Files\Microsoft Corporation\RMLUtils"

Find-Package Microsoft.ReportViewer.WinForms -AllVersions
Install-Package Microsoft.ReportViewer.WinForms -RequiredVersion 10.0.40219.1

Copy-Item -Path "C:\Program Files\PackageManagement\NuGet\Packages\Microsoft.ReportViewer.WinForms.10.0.40219.1\lib\Microsoft.ReportViewer.WinForms.dll" -Destination "C:\Program Files\Microsoft Corporation\RMLUtils"

  2. Sie müssen einen ReporterViewer-Fix herunterladen und installieren, damit Links in den ReadTrace-Berichten ordnungsgemäß funktionieren. Um den ReporterViewer-Fix herunterzuladen, wechseln Sie zu Microsoft Visual Studio 2010 Service Pack 1 Report Viewer (KB2549864).

Abhängigkeiten für Expander

Stellen Sie sicher, dass die Komprimierungs- und Dekomprimierungssteuerelemente entweder im selben Ordner wie Expander.exe oder im GAC verfügbar sind. Die DLLs, die Expander.exe benötigt, sind wie folgt:

  • BRICOLSOFTZipx64.dll
  • UnRar64.dll
  • XceedZipX64.dll

Sie können diese DLLs aus den jeweiligen Softwarepaketen der Anbieter beziehen:

Abhängigkeiten für ReadTrace und Ostress

ReadTrace und Ostress verwenden die ODBC- und OLEDB-Treiber, die im Rahmen der SQL Server Native Client ausgeliefert werden. Wenn Sie dateien für erweiterte Ereignisse (*.xel) analysieren möchten, stellen Sie sicher, dass Visual C++ 2010 Redistributable auf dem System installiert ist.

Bekannte Probleme und Fehlerbehebungen

Problem Lösung
ReadTrace erkennt "FEHLER: Überprüfung der Ereignislaufzeit: Fehlende Spalte [cached_text] im Ereignis [sp_cache_remove] bei ereignissequenzbasiertem 209494 erkannt" Behoben in Version 09.04.0102. Als Problemumgehung können Sie ablaufverfolgungsflags (-T28 -T29) zur ReadTrace-Befehlszeile hinzufügen.
Reporter stößt auf "Die Datei oder Assembly 'Reporter, Version=9.4.10000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' oder eine ihrer Abhängigkeiten konnte nicht geladen werden. Fehler bei der Überprüfung des starken Namens. (Ausnahme von HRESULT: 0x8013141A)" Behoben in Version 09.04.0102. Als Problemumgehung können Sie den folgenden Registrierungsschlüssel erstellen, um die Überprüfung des starken Namens zu überschreiben: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\StrongName\Verification\Reporter,31BF3856AD364E35.
ReadTrace schlägt mit dem Fehler "Verbindung mit dem angegebenen Server kann nicht hergestellt werden. Anfängliches HRESULT: 0x80040154". Ostress schlägt mit dem Fehler "Fehler beim Herstellen der Verbindung. SSL-Sicherheitsfehler.". Weitere Informationen finden Sie unter Installieren von SQL Server Native Client.
Es tritt die Ausnahme von ReadTrace "Unhandled Exception: System.IO.FileNotFoundException: Die Datei oder Assembly 'Microsoft.SqlServer.XEvent.Linq.dll' oder eine ihrer Abhängigkeiten konnte nicht geladen werden. Das angegebene Modul konnte nicht gefunden werden. Installieren von Visual C++ 2010 Redistributable

Beispiele

Die folgenden Beispiele veranschaulichen die Verwendung einiger der RML-Tools.

Verwenden von ReadTrace.exe zum Importieren von Xevent-Daten in eine Datenbank

Verwenden Sie ReadTrace.exe , um eine Reihe von Xevent-Dateien zu importieren, die mit Tools wie PSSDIAG/SQLDiag.exe oder SQL LogScout gesammelt werden. Verwenden Sie den -I -Parameter, um auf die erste XEL-Datei zu verweisen, die rechtzeitig erfasst wurde, wenn mehrere Dateien vorhanden sind. Verwenden Sie ReadTrace.exe /?für alle Befehlszeilenoptionen :

ReadTrace.exe -Iserver_instance_20220211T1319480819_xevent_LogScout_target_0_132890707717540000.xel -oc:\temp\output -f -dPerfAnalysisDb -S.

Verwenden von Ostress.exe zum Stresstest einer Abfrage

Verwenden Sie OStress, um eine Abfrage für einen Server zu übermitteln, auf dem SQL Server ausgeführt wird, indem Sie 30 gleichzeitige Verbindungen ausführen und die Abfrage bei jeder Verbindung 10 Mal ausführen. Verwenden Sie Ostress.exe /?für alle Befehlszeilenoptionen :

ostress.exe -E -dmaster -Q"select name from sys.databases" -n30 -r10

Haftungsausschluss für Kontaktinformationen von Drittanbietern

Die Kontaktinformationen zu den in diesem Artikel erwähnten Drittanbietern sollen Ihnen helfen, zusätzliche Informationen zu diesem Thema zu finden. Diese Kontaktinformationen können ohne vorherige Ankündigung geändert werden. Sie werden von Microsoft ohne jede Gewähr weitergegeben.