Delen via

RML-hulpprogramma's (Replay Markup Language) voor SQL Server

  • Artikel

In dit artikel wordt een groep hulpprogramma's besproken die door ondersteuningsprofessionals worden gebruikt voor het oplossen van problemen met Microsoft SQL Server.

Originele productversie: SQL Server
Origineel KB-nummer: 944837

Inleiding

Het SQL Server-ondersteuningsteam gebruikt verschillende intern geschreven hulpprogramma's om typische klantondersteuningscases te verwerken. RML-hulpprogramma's (Replay Markup Language) voor SQL Server is een specifieke hulpprogrammasuite die databaseontwikkelaars en systeembeheerders kunnen gebruiken.

Meer informatie

U kunt RML-hulpprogramma's voor SQL Server gebruiken om de volgende taken uit te voeren:

  • Bepaal welke toepassing, database, SQL Server aanmelding of query het maximum aantal resources gebruikt.
  • Bepaal of het uitvoeringsplan voor een batch wordt gewijzigd wanneer u de tracering voor de batch vastlegt. Daarnaast kunt u RML-hulpprogramma's voor SQL Server gebruiken om te bepalen hoe SQL Server deze plannen uitvoert.
  • Bepaal welke query's langzaam worden uitgevoerd.

Nadat u een tracering hebt vastgelegd voor een exemplaar van SQL Server, kunt u RML-hulpprogramma's voor SQL Server gebruiken om het traceringsbestand opnieuw af te spelen op een ander exemplaar van SQL Server. Als u ook de tracering vastlegt tijdens de herhaling, kunt u RML-hulpprogramma's voor SQL Server gebruiken om het nieuwe traceringsbestand te vergelijken met het oorspronkelijke traceringsbestand. U kunt deze techniek gebruiken om te testen hoe SQL Server zich gedraagt nadat u wijzigingen hebt toegepast. U kunt deze techniek bijvoorbeeld gebruiken om te testen hoe SQL Server zich gedraagt nadat u de volgende taken hebt uitgevoerd:

  • Een SQL Server servicepack installeren
  • Een hotfix voor SQL Server installeren
  • Een opgeslagen procedure of functie bijwerken
  • Een index bijwerken of een index maken

Versiegeschiedenis

Versienummer Beschrijving
09.04.0102 Geeft de huidige webrelease aan die beschikbaar is in het Microsoft Downloadcentrum. Het ondersteunt alle uitgebrachte versies van SQL Server (SQL Server 2022, SQL Server 2019, SQL Server 2017, SQL Server 2016, SQL Server 2014, SQL Server 2012, SQL Server 2008 R2 en SQL Server 2008).
9.04.0100 Is de vorige webrelease beschikbaar via het Microsoft Downloadcentrum. Het ondersteunt alle uitgebrachte versies van 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 en SQL Server 2000).
9.04.0098 Geeft het huidige releasepakket aan dat deel uitmaakt van het hulpprogramma Database Experimentation Assistant. Het ondersteunt alle uitgebrachte versies van SQL Server.
9.04.0097 Geeft de huidige versie aan die beschikbaar is vanaf de SQL Nexus-site die alle uitgebrachte versies van SQL Server ondersteunt.
9.04.0051 Is de vorige webrelease beschikbaar in het Microsoft Downloadcentrum die ondersteuning biedt voor SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 en SQL Server 2000.
9.04.0004 Is de vorige webversie die ondersteuning biedt voor SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 en SQL Server 2000.
9.01.0109 Is de vorige webversie die ondersteuning biedt voor SQL Server 2008 R2, SQL Server 2008, SQL Server 2005 en SQL Server 2000.
9.00.0023 Is de vorige webrelease die ondersteuning biedt voor SQL Server 2005 en SQL Server 2000.
8.10.0010 Is de eerste webrelease die ondersteuning biedt voor SQL Server 2000 en SQL Server 7.0.

De huidige versie van RML Utilities voor SQL Server vervangt eerdere versies. U moet een eerdere versie van RML Utilities voor SQL Server verwijderen voordat u de huidige versie installeert. De huidige versie van het hulpprogrammapakket bevat belangrijke software-updates, verbeterde functies ( trc- en .xel-bestanden verwerken) en rapporten, en verbeteringen van de prestaties en schaalbaarheid.

De RML-hulpprogramma's voor SQL Server

  • RML-hulpprogramma's voor SQL Server kunt u downloaden in het Microsoft Downloadcentrum.

  • Nadat u de Database Experimentation Assistant hebt geïnstalleerd, vindt u de RML-hulpprogramma's (ReadTrace en OStress) in de C:\Program Files (x86)\Microsoft Corporation\Database Experimentation Assistant\Dependencies\X64\ map.

Opmerking

Microsoft biedt RML-hulpprogramma's voor SQL Server. Microsoft Customer Support Services (CSS) biedt geen ondersteuning of updates voor de suite. Als u een suggestie hebt of als u een fout wilt melden, kunt u het e-mailadres gebruiken in het onderwerp Problemen en hulp in het Help-bestand (RML Help.pdf). Het Help-bestand is opgenomen in de RML-hulpprogramma's voor SQL Server.

Voordelen van RML-hulpprogramma's voor SQL Server

RML Utilities voor SQL Server is handig als u toepassingstests wilt simuleren wanneer het onpraktisch of onmogelijk is om te testen met behulp van de echte toepassing. In een testomgeving kan het lastig zijn om dezelfde gebruikersbelasting te genereren als in de productieomgeving. U kunt RML-hulpprogramma's voor SQL Server gebruiken om een productieworkload in een testomgeving opnieuw af te spelen en het prestatie-effect van eventuele wijzigingen te beoordelen. U kunt bijvoorbeeld een upgrade naar SQL Server 2008 of de toepassing van een SQL Server servicepack testen. Daarnaast kunt u RML-hulpprogramma's voor SQL Server gebruiken om verschillende herspeelworkloads te analyseren en te vergelijken. Dit soort regressieanalyse zou anders een moeilijk proces zijn dat u handmatig moet uitvoeren.

Het Help-bestand bevat een snelstartonderwerp. Dit onderwerp bevat een korte oefening waarmee u vertrouwd wordt met elk RML-hulpprogramma. Als u het Help-bestand wilt openen, selecteert u Start, wijst u alle programma's aan, wijst u RML-hulpprogramma's aan voor SQL Server, wijst u Help aan en selecteert u vervolgens RML Help.

Hulpprogramma's in RML-hulpprogramma's voor SQL Server

RML-hulpprogramma's voor SQL Server bevat de volgende hulpprogramma's:

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

Zie het RML Help-bestand dat is opgenomen in RML-hulpprogramma's voor SQL Server voor een volledige beschrijving van elk hulpprogramma en voorbeeldgebruik.

Afhankelijkheden voor RML-hulpprogramma's voor SQL Server

Belangrijk

Voor de toepassingen die deel uitmaken van de RML-hulpprogrammasuite, moeten verschillende extra besturingselementen beschikbaar worden gesteld.

Afhankelijkheden voor Reporter

  1. U moet ervoor zorgen dat de besturingselementen van Rapportviewer beschikbaar zijn in dezelfde map als Reporter.exe of in de Global Assembly Cache (GAC). De DLL's die Reporter.exe vereist, zijn:

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

    U kunt deze DLL's downloaden met behulp van het volgende PowerShell-script:

    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. U moet een ReporterViewer-oplossing downloaden en installeren om koppelingen in de ReadTrace-rapporten correct te laten werken. Als u de oplossing voor ReporterViewer wilt downloaden, gaat u naar Microsoft Visual Studio 2010 Service Pack 1 Report Viewer (KB2549864).

Afhankelijkheden voor Expander

Zorg ervoor dat de besturingselementen voor compressie en decompressie beschikbaar zijn in dezelfde map als Expander.exe of in de GAC. De DLL's die Expander.exe vereist, zijn als volgt:

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

U kunt deze DLL's verkrijgen uit de respectieve softwarepakketten van de leveranciers:

Afhankelijkheden voor ReadTrace en Ostress

ReadTrace en Ostress gebruiken de ODBC- en OLEDB-stuurprogramma's die worden geleverd als onderdeel van de SQL Server Native Client. Als u van plan bent uitgebreide gebeurtenisbestanden (*.xel) te analyseren, controleert u of Visual C++ 2010 Redistributable op het systeem is geïnstalleerd.

Bekende problemen en oplossingen

Probleem Oplossing
ReadTrace ondervindt "ERROR: Event Runtime Check: Detected missing column [cached_text] in event [sp_cache_remove] at event sequence 209494" Opgelost in versie 09.04.0102. Als tijdelijke oplossing kunt u traceringsvlagken (-T28 -T29) toevoegen aan de ReadTrace-opdrachtregel.
Reporter ondervindt 'Kan bestand of assembly 'Reporter, Version=9.4.10000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' of een van de bijbehorende afhankelijkheden niet laden. Validatie van sterke naam is mislukt. (Uitzondering op HRESULT: 0x8013141A)" Opgelost in versie 09.04.0102. Als tijdelijke oplossing kunt u de volgende registersleutel maken om de sterke naamverificatie te overschrijven: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\StrongName\Verification\Reporter,31BF3856AD364E35.
ReadTrace mislukt met de fout 'Kan geen verbinding maken met de opgegeven server. Eerste HRESULT: 0x80040154'. Ostress mislukt met de fout 'Poging tot stand te brengen verbinding is mislukt. SSL-beveiligingsfout.' Zie de instructies voor het installeren van SQL Server Native Client.
U ziet de uitzondering van ReadTrace 'Unhandled Exception: System.IO.FileNotFoundException: Kan bestand of assembly 'Microsoft.SqlServer.XEvent.Linq.dll' of een van de bijbehorende afhankelijkheden niet laden. Kan de opgegeven module niet vinden.' Visual C++ 2010 Redistributable installeren

Voorbeelden

In de volgende voorbeelden ziet u hoe u een aantal RML-hulpprogramma's gebruikt.

ReadTrace.exe gebruiken om Xevent-gegevens in een database te importeren

Gebruik ReadTrace.exe om een reeks Xevent-bestanden te importeren die zijn verzameld met behulp van hulpprogramma's zoals PSSDIAG/SQLDiag.exe of SQL LogScout. Gebruik de -I parameter om te verwijzen naar het eerste .xel-bestand dat op tijd is verzameld, als er meerdere bestanden aanwezig zijn. Gebruik voor alle opdrachtregelopties ReadTrace.exe /?:

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

Ostress.exe gebruiken om een query te testen

Gebruik OStress om een query te verzenden op een server waarop SQL Server wordt uitgevoerd door 30 gelijktijdige verbindingen uit te voeren en de query 10 keer uit te voeren op elke verbinding. Gebruik voor alle opdrachtregelopties Ostress.exe /?:

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

Disclaimerinformatie van derden

Microsoft verstrekt contactgegevens van derden om u te helpen aanvullende informatie over dit onderwerp te vinden. Deze contactinformatie kan zonder voorafgaande kennisgeving worden gewijzigd. Microsoft garandeert de juistheid van contactgegevens van derden niet.