次の方法で共有


Database Experimentation Assistant で分析レポートを作成する (SQL Server)

手記

このツールは、2024 年 12 月 15 日 廃止されました。 発生した問題については、このツールのサポートを停止しており、バグ修正やそれ以降の更新プログラムは発行されません。

両方のターゲット サーバーでソース トレースを再生した後、データベース実験アシスタント (DEA) で分析レポートを生成できます。 分析レポートは、提案された変更のパフォーマンスへの影響に関する分析情報を得るのに役立ちます。

分析レポートを作成する

  1. DEA で、一覧アイコンを選択し、サーバー名と認証の種類を指定し、シナリオに応じて [接続 の暗号化] チェック ボックスと [サーバー証明書 を信頼する] チェック ボックスをオンまたはオフにして、[接続 選択します。

    トレース ファイルを使用したサーバーへの接続のスクリーンショット。

  2. [分析レポート] 画面で、[新しい分析レポート] を選択します。

    新しい分析レポートの作成のスクリーンショット。

  3. 新しい分析レポート 画面で、レポートの名前、保存場所、ターゲット 1 とターゲット 2 のトレース ファイルへのパスを指定し、[開始] 選択します。

    新しい分析レポートの詳細を指定するのスクリーンショット。

    入力した情報が有効な場合は、分析レポートが作成されます。

    新しく作成された分析レポートのスクリーンショット。

    手記

    入力した情報のいずれかが無効な場合は、正しくない情報を含むテキスト ボックスが赤で強調表示されます。 必要な修正を行い、次に 「開始」 をもう一度選択します。

分析レポートに関してよく寄せられる質問

分析レポートには何が表示されますか?

DEA では、統計テストを使用してワークロードを分析し、各クエリがターゲット 1 からターゲット 2 にどのように実行されたかを判断します。 各クエリのパフォーマンスの詳細が提供されます。 DEA の詳細については、「ワークロード比較プロセスの概要」を参照してください。

別のレポートの生成中に新しい分析レポートを作成できますか?

いいえ。 現在、競合を防ぐために一度に生成できるレポートは 1 つだけです。 ただし、複数のキャプチャを同時に実行して再生することはできます。

コマンド プロンプトを使用して分析レポートを生成できますか?

はい。 コマンド プロンプトで分析レポートを生成できます。 その後、UI でレポートを表示できます。 詳細については、「コマンド プロンプト でデータベース実験アシスタントを実行するを参照してください。

分析レポートのトラブルシューティング

サーバーで分析レポートを生成して表示するには、どのようなセキュリティアクセス許可が必要ですか?

DEA にログインしているユーザーは、分析サーバーに対する sysadmin 権限を持っている必要があります。 ユーザーがグループの一部である場合は、グループに sysadmin 権限があることを確認します。

考えられるエラー 解決
データベースに接続できません。 レポートを分析および表示するための sysadmin 権限があることを確認します。 サーバーまたはデータベースに対するアクセス権または sysadmin 権限がない可能性があります。 ログイン権限を確認して、もう一度やり直してください。
サーバー サーバー名でレポート名 を生成できません。 詳細については、レポート名 レポートを確認してください。 新しいレポートを生成するために必要な sysadmin 権限がない可能性があります。 詳細なエラーを表示するには、エラーが発生したレポートを選択し、\DEA %temp%ログを確認します。
現在のユーザーには、操作を実行するために必要なアクセス許可がありません。 トレースを実行してレポートを分析するための sysadmin 権限があることを確認します。 新しいレポートを生成するために必要な sysadmin 権限がありません。

SQL Server を実行しているコンピューターに接続できない

  • SQL Server を実行しているコンピューターの名前が有効であることを確認します。 確認するには、SQL Server Management Studio (SSMS) を使用してサーバーに接続してみてください。
  • ファイアウォール構成で、SQL Server を実行しているコンピューターへの接続がブロックしていないことを確認します。
  • ユーザーが必要なユーザー権限を持っていることを確認します。

詳細については、%temp%\DEA のログを参照してください。 問題が解決しない場合は、製品チームにお問い合わせください。

分析レポートを生成するときにエラーが表示される

DEA のインストール後に分析レポートを初めて生成するときは、インターネット アクセスが必要です。 統計分析に必要なパッケージをダウンロードするには、インターネット アクセスが必要です。

レポートの作成中にエラーが発生した場合、進行状況ページには、分析の生成に失敗した特定の手順が表示されます。 詳細については、%temp%\DEA のログを参照してください。 必要なユーザー権限を持つサーバーへの有効な接続があることを確認してから、再試行してください。 問題が解決しない場合は、製品チームにお問い合わせください。

考えられるエラー 解決
RInterop が起動時にエラーに達しました。 RInterop ログを確認し、もう一度やり直してください。 DEA では、依存する R パッケージをダウンロードするためのインターネット アクセスが必要です。 %temp%\RInterop ログと %temp%\DEA ログを確認します。 RInterop が正しく初期化されていない場合、または正しい R パッケージなしで初期化された場合、DEA ログの InitializeRInterop ステップの後に例外 "Failed to generate new analysis report" が表示されることがあります。

RInterop ログには、"使用可能な jsonlite パッケージがありません" のようなエラーが表示される場合もあります。コンピューターがインターネットにアクセスできない場合は、必要な jsonlite R パッケージを手動でダウンロードできます。
  • コンピューターのファイル システムの %userprofile%\DEARPackages フォルダーに移動します。 このフォルダーは、DEA 用に R によって使用されるパッケージで構成されます。

  • インストールされているパッケージの一覧に jsonlite フォルダーがない場合は、https://cran.r-project.org/web/packages/jsonlite/index.htmlから jsonlite_1.4.zip のリリース バージョンをダウンロードするには、インターネットにアクセスできるコンピューターが必要です。

  • .zip ファイルを、DEA を実行しているコンピューターにコピーします。 jsonlite フォルダーを抽出し、\DEARPackages %userprofile%にコピーします。 この手順では、jsonlite パッケージが R に自動的にインストールされます。このフォルダーには jsonlite 名前を付ける必要があり、内容はフォルダー内に直接存在する必要があります。1 つ下のレベルではありません。

  • DEA を閉じ、もう一度開き、もう一度分析を試してください。

  • RGUI を使用することもできます。 パッケージ に移動して、>を zipからインストールします。 前にダウンロードしたパッケージに移動し、インストールします。
    RInterop が初期化され、正しく設定されている場合は、RInterop ログに "依存する R パッケージ jsonlite のインストール" と表示されます。
    SQL Server インスタンスに接続できません。サーバー名が正しいことを確認し、ログインしているユーザーに必要なアクセス権を確認します。 サーバーへのアクセス権またはユーザー権限がない場合や、サーバー名が正しくない可能性があります。
    RInterop プロセスがタイムアウトしました。DEA ログと RInterop ログを確認し、タスク マネージャーで RInterop プロセスを停止してから、もう一度やり直してください。

    又は
    RInterop がエラー状態です。 タスク マネージャーで RInterop プロセスを停止し、もう一度やり直してください。
    \RInterop %temp%ログを確認して、エラーを確認します。 再試行する前に、タスク マネージャーから RInterop プロセスを削除します。 問題が解決しない場合は、製品チームにお問い合わせください。

    レポートが生成されますが、データが見つからないように見えます

    SQL Server を実行している分析コンピューター上のデータベースを調べて、データが存在することを確認します。 分析データベースが存在することを確認し、そのテーブルを確認します。 たとえば、TblBatchesA、TblBatchesB、TblSummaryStats の各テーブルを確認します。

    データが存在しない場合は、データが正しくコピーされていないか、データベースが破損している可能性があります。 一部のデータのみが不足している場合は、キャプチャまたは再生で作成されたトレース ファイルによってワークロードが正確にキャプチャされていない可能性があります。 データがある場合は、\DEA %temp%ログ ファイルを調べて、エラーがログに記録されたかどうかを確認します。 次に、もう一度試して分析レポートを生成します。

    その他の質問やフィードバック 左下隅にあるスマイリー アイコンを選択して、DEA ツールを使用してフィードバックを送信します。