SQL Serverのマークアップ言語 (RML) ユーティリティを再生する
この記事では、サポート 担当者が Microsoft SQL Serverのトラブルシューティングに使用するツールのグループについて説明します。
元の製品バージョン: SQL Server
元の KB 番号: 944837
概要
SQL Server サポート チームは、一般的なカスタマー サポート ケースの処理に役立つ、内部で記述された複数のツールを使用します。 SQL Server用のマークアップ言語再生 (RML) ユーティリティは、データベース開発者とシステム管理者が使用できる特定のツール スイートの 1 つです。
詳細
SQL Serverには RML ユーティリティを使用して、次のタスクを実行できます。
- 最大リソースを使用しているアプリケーション、データベース、SQL Server ログイン、またはクエリを決定します。
- バッチのトレースをキャプチャするときに、バッチの実行計画が変更されるかどうかを判断します。 さらに、SQL Serverの RML ユーティリティを使用して、これらのプランSQL Server実行する方法を決定できます。
- どのクエリの実行速度が遅いかを判断します。
SQL Serverのインスタンスのトレースをキャプチャした後、SQL Serverに RML ユーティリティを使用して、SQL Serverの別のインスタンスに対してトレース ファイルを再生できます。 また、再生中にトレースをキャプチャする場合は、SQL Serverに RML ユーティリティを使用して、新しいトレース ファイルを元のトレース ファイルと比較できます。 この手法を使用して、変更を適用した後SQL Serverの動作をテストできます。 たとえば、この手法を使用して、次のタスクを実行した後SQL Serverの動作をテストできます。
- SQL Server サービス パックをインストールする
- SQL Server修正プログラムをインストールする
- ストアド プロシージャまたは関数を更新する
- インデックスを更新するか、インデックスを作成する
バージョン履歴
| バージョン番号 | 説明 |
|---|---|
| 09.04.0102 | Microsoft ダウンロード センターから入手できる現在の Web リリースを示します。 SQL Serverのすべてのリリースバージョン (SQL Server 2022、SQL Server 2019、SQL Server 2017、SQL Server 2016、SQL Server 2014、SQL Server 2012、SQL Server 2008 R2、およびSQL Server 2008)。 |
| 9.04.0100 | Microsoft ダウンロード センターから入手できる以前の Web リリースです。 SQL Server (SQL Server 2019、SQL Server 2016、SQL Server 2016、SQL Server 2014、SQL Server 2012、SQL Server 2008 R2、SQL Server 2008、SQL Server 2005、SQL Server 2000)。 |
| 9.04.0098 | Database Experimentation Assistant ツールに含まれている現在のリリース パッケージを示します。 リリースされたすべてのバージョンのSQL Serverがサポートされます。 |
| 9.04.0097 | リリースされたすべてのバージョンのSQL Serverをサポートする SQL Nexus サイトから利用可能な現在のリリースを示します。 |
| 9.04.0051 | SQL Server 2014、SQL Server 2012、SQL Server 2008 R2、SQL Server 2008、SQL Server 2005、SQL Server 2000 をサポートする Microsoft ダウンロード センターから入手できる以前の Web リリースです。 |
| 9.04.0004 | SQL Server 2014、SQL Server 2012、SQL Server 2008 R2、SQL Server 2008、SQL Server 2005、SQL Server 2000 をサポートする以前の Web リリースです。 |
| 9.01.0109 | SQL Server 2008 R2、SQL Server 2008、SQL Server 2005、SQL Server 2000 をサポートする以前の Web リリースです。 |
| 9.00.0023 | SQL Server 2005 および SQL Server 2000 をサポートする以前の Web リリースです。 |
| 8.10.0010 | SQL Server 2000 と SQL Server 7.0 をサポートする初期 Web リリースです。 |
SQL Serverの RML ユーティリティの現在のバージョンは、以前のバージョンよりも優先されます。 現在のバージョンをインストールする前に、以前のバージョンの RML ユーティリティをアンインストールしてSQL Serverする必要があります。 ツール スイートの現在のバージョンには、重要なソフトウェア更新プログラム、改善された機能 ( .trc ファイルと .xel ファイルの処理) とレポート、パフォーマンスとスケーラビリティの向上が含まれています。
SQL Serverの RML ユーティリティを取得する
SQL Server用の RML ユーティリティは、Microsoft ダウンロード センターからダウンロードできます。
Database Experimentation Assistantをインストールすると、フォルダーに RML ツール (
ReadTraceとOStress) が表示C:\Program Files (x86)\Microsoft Corporation\Database Experimentation Assistant\Dependencies\X64\されます。
注:
Microsoft では、SQL Server用の RML ユーティリティをそのまま提供しています。 Microsoft カスタマー サポート サービス (CSS) では、スイートのサポートや更新プログラムは提供されません。 提案がある場合、またはバグを報告する場合は、ヘルプ ファイル (RML Help.pdf) の 「問題と支援」トピックの電子メール アドレスを使用できます。 ヘルプ ファイルは、SQL Serverの RML ユーティリティに含まれています。
SQL Serverの RML ユーティリティの利点
SQL Server用の RML ユーティリティは、実際のアプリケーションを使用してテストするのが実用的でない場合や不可能な場合にアプリケーション テストをシミュレートする場合に便利です。 テスト環境では、運用環境に存在するのと同じユーザー 負荷を生成することが困難な場合があります。 SQL Serverに RML ユーティリティを使用して、テスト環境で運用環境のワークロードを再生し、変更のパフォーマンス効果を評価できます。 たとえば、SQL Server 2008 へのアップグレードや、SQL Server サービス パックのアプリケーションをテストできます。 さらに、SQL Serverに RML ユーティリティを使用して、さまざまな再生ワークロードを分析および比較できます。 この種の回帰分析は、手動で行う必要がある困難なプロセスです。
ヘルプ ファイルにはクイック スタート トピックが含まれています。 このトピックには、すべての RML ツールについて理解できる簡単な演習が含まれています。 ヘルプ ファイルを開くには、[スタート] を選択し、[すべてのプログラム] をポイントし、[SQL Serverの RML ユーティリティ] をポイントし、[ヘルプ] をポイントして、[RML ヘルプ] を選択します。
SQL Server用 RML ユーティリティのツール
SQL Serverの RML ユーティリティには、次のツールが含まれています。
- ReadTrace
- 記者
- OStress
- OStress 再生制御エージェント (ORCA)
すべてのツールとサンプルの使用方法の詳細については、SQL Serverの RML ユーティリティに含まれている RML ヘルプ ファイルを参照してください。
SQL Serverの RML ユーティリティの依存関係
重要
RML ツール スイートの一部として提供されるアプリケーションでは、いくつかの追加のコントロールを使用できるようにする必要があります。
Reporter の依存関係
レポート ビューアー コントロールが、 Reporter.exe と同じフォルダーまたはグローバル アセンブリ キャッシュ (GAC) で使用できることを確認する必要があります。 Reporter.exe 必要な DLL は次のとおりです。
- Microsoft.ReportViewer.Common.dll
- Microsoft.ReportViewer.DataVisualization.dll
- Microsoft.ReportViewer.ProcessingObjectModel.dll
- Microsoft.ReportViewer.WinForms.dll
これらの DLL は、次の PowerShell スクリプトを使用してダウンロードできます。
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"ReadTrace レポート内のリンクを正常に動作させるには、ReporterViewer 修正プログラムをダウンロードしてインストールする必要があります。 ReporterViewer の修正プログラムをダウンロードするには、 Microsoft Visual Studio 2010 Service Pack 1 レポート ビューアー (KB2549864) に移動します。
Expander の依存関係
圧縮と展開のコントロールが、 Expander.exe と同じフォルダー内または GAC 内で使用できることを確認します。 Expander.exe 必要な DLL は次のとおりです。
- BRICOLSOFTZipx64.dll
- UnRar64.dll
- XceedZipX64.dll
これらの DLL は、ベンダーの各ソフトウェア パッケージから取得できます。
https://www.rarlab.com/rar_add.htm - Windows ソフトウェア開発者向けの UnRAR.dll 動的ライブラリを見つける
ReadTrace と Ostress の依存関係
ReadTrace と Ostress では、SQL Server Native Clientの一部として配布される ODBC ドライバーと OLEDB ドライバーが使用されます。 拡張イベント ファイル (*.xel) を分析する予定の場合は、 Visual C++ 2010 再頒布可能ファイル がシステムにインストールされていることを確認します。
既知の問題と修正
| 問題 | 解決方法 |
|---|---|
| ReadTrace で"ERROR: イベント ランタイム チェック: イベント シーケンス 209494でイベント [sp_cache_remove] で列 [cached_text] が検出されました | バージョン 09.04.0102 で修正されました。 回避策として、ReadTrace コマンド ラインにトレース フラグ (-T28 -T29) を追加できます。 |
| レポーターが "ファイルまたはアセンブリ 'Reporter, Version=9.4.10000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' またはその依存関係の 1 つを読み込めませんでした。 厳密な名前の検証に失敗しました。 (HRESULT からの例外: 0x8013141A)" | バージョン 09.04.0102 で修正されました。 回避策として、次のレジストリ キーを作成して、厳密な名前の検証をオーバーライドできます。 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\StrongName\Verification\Reporter,31BF3856AD364E35 |
| ReadTrace が失敗し、エラー "指定したサーバーに接続できません。 初期 HRESULT: 0x80040154" Ostress が失敗し、エラー "接続の確立が失敗しました。 SSL セキュリティ エラー"。 | 「SQL Server Native Clientをインストールする」の手順を参照してください。 |
| ReadTrace の例外 "未処理の例外: System.IO.FileNotFoundException: ファイルまたはアセンブリ 'Microsoft.SqlServer.XEvent.Linq.dll' またはその依存関係のいずれかを読み込めませんでした。 指定されたモジュールが見つかりませんでした。 | Visual C++ 2010 再頒布可能パッケージをインストールする |
例
次の例は、一部の RML ツールを使用する方法を示しています。
ReadTrace.exe を使用して Xevent データをデータベースにインポートする
ReadTrace.exe を使用して、PSSDIAG/SQLDiag.exe や SQL LogScout などのツールを使用して収集された一連の Xevent ファイルをインポートします。 複数の -I ファイルが存在する場合は、 パラメーターを使用して、時間内に収集された最初の .xel ファイルを指します。 すべてのコマンド ライン スイッチの場合は、 を使用します ReadTrace.exe /?。
ReadTrace.exe -Iserver_instance_20220211T1319480819_xevent_LogScout_target_0_132890707717540000.xel -oc:\temp\output -f -dPerfAnalysisDb -S.
Ostress.exe を使用したクエリのストレス テスト
OStress を使用して、30 個の同時接続を実行し、各接続でクエリを 10 回実行することで、SQL Serverを実行しているサーバーに対してクエリを送信します。 すべてのコマンド ライン スイッチの場合は、 を使用します Ostress.exe /?。
ostress.exe -E -dmaster -Q"select name from sys.databases" -n30 -r10
サードパーティのお問い合わせ窓口に関する免責事項
Microsoft では、このトピックに関する追加情報を見つけるのに役立つサード パーティの連絡先情報を提供しています。 将来予告なしに変更されることがあります。 Microsoft は、第三者の連絡先情報の正確性を保証しません。