Tutorial: Adicionar o widget de exemplo de cinco consultas mais lentas ao painel do banco de dados

Important

O Azure Data Studio será desativado em 28 de fevereiro de 2026. Recomendamos que utilizes a extensão MSSQL para o Visual Studio Code. Para obter mais informações sobre como migrar para o Visual Studio Code, visite O que está acontecendo com o Azure Data Studio?

Este tutorial demonstra o processo de adicionar um dos widgets de exemplo internos do Azure Data Studio ao painel do banco de dados para exibir rapidamente as cinco consultas mais lentas de um banco de dados. Você também aprenderá a exibir os detalhes das consultas lentas e dos planos de consulta usando os recursos do Azure Data Studio. Durante este tutorial, você aprenderá a:

• Ativar o Repositório de Consultas numa base de dados
• Adicionar um widget de insight pré-criado ao painel do banco de dados
• Exibir detalhes sobre as consultas mais lentas do banco de dados
• Exibir planos de execução de consulta para consultas lentas

O Azure Data Studio inclui vários widgets de insight prontos para uso. Este tutorial mostra como adicionar o widget query-data-store-db-insight , mas as etapas são basicamente as mesmas para adicionar qualquer widget.

Prerequisites

Este tutorial requer o SQL Server ou o Banco de Dados SQL do Azure TutorialDB. Para criar o banco de dados TutorialDB , conclua um dos seguintes inícios rápidos:

• Conectar e consultar o SQL Server usando o Azure Data Studio

• Conectar e consultar o Banco de Dados SQL do Azure usando o Azure Data Studio

Ativar o Repositório de Consultas para a sua base de dados

O widget neste exemplo requer que o Repositório de Consultas esteja habilitado.

1. Clique com o botão direito do mouse no banco de dados TutorialDB (na barra lateral SERVERS ) e selecione Nova consulta.

2. Cole a seguinte instrução Transact-SQL (T-SQL) no editor de consultas e clique em Executar:

    ALTER DATABASE TutorialDB SET QUERY_STORE = ON
   

Adicione o widget de consultas lentas ao painel do banco de dados

Para adicionar o widget de consultas lentas ao seu painel, edite a configuração dashboard.database.widgets no arquivo Configurações do usuário .

1. Abra as Configurações do Usuário pressionando Ctrl+Shift+P para abrir a Paleta de Comandos.

2. Digite configurações na caixa de pesquisa e selecione Preferências: Abrir configurações do usuário.

   

3. Digite dashboard na caixa de pesquisa de configurações, localize dashboard.database.widgets e clique em editar em settings.json.

   

4. No settings.json, adicione o seguinte código abaixo:

   "dashboard.database.widgets": [
       {
           "name": "slow queries widget",
           "gridItemConfig": {
               "sizex": 2,
               "sizey": 1
           },
           "widget": {
               "query-data-store-db-insight": null
           }
       },
       {
           "name": "Tasks",
           "gridItemConfig": {
               "sizex": 1,
               "sizey": 1
           },
           "widget": {
               "tasks-widget": {}
           }
       },
       {
           "gridItemConfig": {
               "sizex": 1,
               "sizey": 2
           },
           "widget": {
               "explorer-widget": {}
           }
       }
   ]
   

5. Pressione Ctrl+S para salvar as Configurações do usuário modificadas.

6. Abra o painel Banco de dados navegando até TutorialDB na barra lateral SERVIDORES , clique com o botão direito do mouse e selecione Gerenciar.

   

7. O widget de insights aparece no painel de controlo.

   

Veja os detalhes do insight para obter mais informações

1. Para visualizar informações adicionais para um widget de insight, clique nas reticências (...) no canto superior direito e selecione Mostrar detalhes.

2. Para mostrar mais detalhes de um item, selecione qualquer item na lista Dados do Gráfico .

   

3. Feche o painel Insights.

Exibir o plano de consulta

1. Clique com o botão direito do mouse no banco de dados TutorialDB e selecione Gerenciar

2. No widget de consulta lenta Para visualizar informações adicionais para um widget de insight, clique nas reticências (...) no canto superior direito e selecione Executar consulta.

   

3. Agora você verá uma nova janela de consulta com os resultados.

   

4. Clique em Explicar.

   

5. Veja o plano de execução da consulta:

   

Próximos passos

Neste tutorial, você aprendeu como:

• Habilitar o Repositório de Consultas num banco de dados
• Adicionar um widget de insight ao painel do banco de dados
• Exibir detalhes sobre as consultas mais lentas do banco de dados
• Exibir planos de execução de consulta para consultas lentas

Para saber como habilitar o exemplo de visão do uso do espaço de tabela, conclua o próximo tutorial:

Ativar o widget de amostra de insights do espaço de tabelas