Skip to content

tutorial-qds-sql-server.md

Latest commit

 

History

History
132 lines (81 loc) · 5.76 KB

tutorial-qds-sql-server.md

File metadata and controls

132 lines (81 loc) · 5.76 KB
Error in user YAML: (<unknown>): mapping values are not allowed in this context at line 1 column 16
---
title: Tutorial: Monitor Query Performance with SQL Operations Studio  | Microsoft Docs
description: This tutorial demonstrates how to monitor a database by adding a pre-built query performance widget to the database dashboard that shows the five slowest queries.
keywords: 
ms.custom: "tools|sos"
ms.date: "11/08/2017"
ms.prod: "sql-non-specified"
ms.reviewer: "alayu; erickang; sstein"
ms.suite: "sql"
ms.tgt_pltfrm: ""
ms.topic: "tutorial"
author: "erickangMSFT"
ms.author: "erickang"
manager: craigg
ms.workload: "Inactive"
---

Tutorial: Add the pre-built five slowest queries widget to the database dashboard

This tutorial demonstrates the process of adding one of [!INCLUDEname-sos]'s built-in insight widgets to the database dashboard. to quickly view a database's five slowest queries using Query Store. You also learn how to view the details of the slow queries and query plans using [!INCLUDEname-sos]'s features. During this tutorial, you learn how to:

[!div class="checklist"]

  • Enable Query Store on a database
  • Add a pre-built insight widget to the database dashboard
  • View details about the database's slowest queries
  • View query execution plans for the slow queries

This tutorial details the process of adding [!INCLUDEname-sos]'s built-in insight widgets to the database management dashboard.

[!INCLUDEname-sos] includes several insight widgets out-of-the-box. This tutorial shows how to add the query-data-store-db-insight widget, but the steps are basically the same for adding any widget.

Prerequisites

This tutorial requires the TutorialDB database. To create the TutorialDB database, complete one of the following quickstarts:

  • [Connect and query SQL Server using [!INCLUDEname-sos-short]](quickstart-sql-server.md)
  • [Connect and query Azure SQL Database using [!INCLUDEname-sos-short]](quickstart-sql-database.md)
  • [Connect and query SQL Data Warehouse using [!INCLUDEname-sos-short]](quickstart-sql-dw.md)

Turn on Query Store for your database

The widget in this example requires Query Store to be enabled so run the following T-SQL statement against your database:

 ALTER DATABASE TutorialDB SET QUERY_STORE = ON

Add an insight widget to your Database Dashboard

To add an insight widget to your dashboard, edit the dashboard.database.widgets setting in your User Settings file.

  1. Open User Settings by pressing Ctrl+Shift+P to open the Command Palette.

  2. Type settings in the search box and from the available settings files, select Preferences: Open User Settings.

    Open user settings command

  3. Type dashboard in the settings search box and locate the dashboard.database.widgets.

    Search settings

  4. To customize the dashboard.database.widgets setting, hover over the pencil icon to the left of the dashboard.database.widgets text, click Edit > Copy to Settings.

  5. Using [!INCLUDEname-sos]'s insight settings IntelliSense, configure name for the widget title, gridItemConfig for the widget size, and widget by selecting query-data-store-database-insight from the list as shown in the following screenshot:

    Insight qds settings

  6. Press CTRL + s to save the modified User Settings.

  7. Open the Database dashboard by navigating to TutorialDB in the Servers sidebar, right-click, and select Manage.

    Open dashboard

  8. The insight widget appears on the dashboard:

    QDS widget

View insight details for more information

  1. To view additional information for an insight widget, click the ellipses (...) in the upper right, and select Show Details:

    Insight detail dialog

  2. To show more details for an item, select any item in Chart Data list.

  3. Right-click query_sql_txt in Item Details and click Copy Cell.

  4. Close the Insights pane.

View the query plan

  1. Open a new query editor by pressing Ctrl + N.

  2. Paste the query_sql_txt from the previous steps into the editor.

  3. Click Explain.

    Insight QDS Explain

  4. View the query's execution plan:

    showplan

View the query plan in Query Data Store

??THIS OPENS AS TEXT FOR ME??

  1. Open the insight detail dialog again.

  2. Right-click query_plan value and select Copy Cell

    Insights QDS plan

  3. Press Ctrl-N to open a new editor.

  4. Paste the copied plan into the editor.

  5. Press Ctrl-S to save the file, and change the file extension to *.showplan.

  6. The query plan opens in [!INCLUDEname-sos]'s query plan viewer.

    TBD - screenshot

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

  • Enable Query Store on a database
  • Add an insight widget to the database dashboard
  • View details about the database's slowest queries
  • View query execution plans for the slow queries

To learn how to build a custom insight widget, see [Build a custom insight widget]](tutorial-build-custom-insight-sql-server.md).