Tutorial: creare un widget di informazioni dettagliate personalizzato

Questa esercitazione illustra come usare query di informazioni dettagliate per creare widget di informazioni dettagliate personalizzati.

In questa esercitazione verranno illustrate le procedure per:

Prerequisiti

Per questa esercitazione è necessario il database di SQL Server o il database SQL di Azure TutorialDB. Per creare il database TutorialDB, completare uno degli argomenti di avvio rapido seguenti:

• Connettersi a SQL Server ed eseguire query con Azure Data Studio
• Connettersi al database SQL di Azure ed eseguire query con Azure Data Studio

Eseguire una query e visualizzare il risultato in un grafico

In questo passaggio si eseguirà uno script SQL per applicare una query alle sessioni attive correnti.

1. Premere CTRL + N per aprire un nuovo editor.

2. Modificare il contesto di connessione in TutorialDB.

3. Incollare la query seguente nell'editor di query:

   SELECT count(session_id) as [Active Sessions]
   FROM sys.dm_exec_sessions
   WHERE status = 'running'
   

4. Salvare la query nell'editor in un file *.sql. Per questa esercitazione, salvare lo script come activeSession.sql.

5. Premere F5 per eseguire la query.

6. Quando vengono visualizzati i risultati della query, fare clic su View as Chart (Visualizza come grafico) e quindi sulla scheda Visualizzatore grafico.

7. Modificare Tipo di grafico in conteggio. Con queste impostazioni viene generato un grafico di conteggio.

Aggiungere informazioni dettagliate personalizzate al dashboard del database

1. Per aprire la configurazione del widget di informazioni dettagliate, fare clic su Create Insight (Crea informazioni dettagliate) nella scheda Visualizzatore grafico:

   

2. Copiare la configurazione dell'analisi (i dati JSON).

3. Premere CTRL + virgola per aprire Impostazioni utente.

4. Digitare dashboard in Impostazioni di ricerca.

5. Fare clic su Modifica per dashboard.database.widgets.

   

6. Incollare il JSON di configurazione di insight in dashboard.database.widgets. Le impostazioni del dashboard del database saranno disposte nel modo seguente:

    "dashboard.database.widgets": [
        {
            "name": "My-Widget",
            "gridItemConfig": {
                "sizex": 2,
                "sizey": 1
            },
            "widget": {
                "insights-widget": {
                    "type": {
                        "count": {
                            "dataDirection": "vertical",
                            "dataType": "number",
                            "legendPosition": "none",
                            "labelFirstColumn": false,
                            "columnsAsLabels": false
                        }
                    },
                    "queryFile": "{your file folder}/activeSession.sql"
                }
            }
        }
    ]
   

7. Salvare il file Impostazioni utente e aprire il dashboard del database TutorialDB per visualizzare il widget delle sessioni attive:

   

Aggiungere dettagli all'intuizione personalizzata

1. Premere CTRL + N per aprire un nuovo editor.

2. Modificare il contesto di connessione in TutorialDB.

3. Incollare la query seguente nell'editor di query:

    SELECT session_id AS [SID], login_time AS [Login Time], host_name AS [Host Name], program_name AS [Program Name], login_name AS [Login Name]
    FROM sys.dm_exec_sessions
    WHERE status = 'running'
   

4. Salvare la query nell'editor in un file *.sql. Per questa esercitazione, salvare lo script come activeSessionDetail.sql.

5. Premere CTRL + virgola per aprire Impostazioni utente.

6. Modificare il nodo dashboard.database.widgets esistente nel file delle impostazioni:

    "dashboard.database.widgets": [
        {
            "name": "My-Widget",
            "gridItemConfig": {
                "sizex": 2,
                "sizey": 1
            },
            "widget": {
                "insights-widget": {
                    "type": {
                        "count": {
                            "dataDirection": "vertical",
                            "dataType": "number",
                            "legendPosition": "none",
                            "labelFirstColumn": false,
                            "columnsAsLabels": false
                        }
                    },
                    "queryFile": "{your file folder}/activeSession.sql",
                    "details": {
                        "queryFile": "{your file folder}/activeSessionDetail.sql",
                        "label": "SID",
                        "value": "Login Name"
                    }
                }
            }
        }
    ]
   

7. Salvare il file Impostazioni utente e aprire il dashboard del database TutorialDB. Fare clic sul pulsante di ellissi (...) accanto a My-Widget per visualizzare i dettagli:

   

Passaggi successivi

In questo tutorial, hai imparato come:

Per informazioni su come eseguire il backup e ripristino di un database, completare l'esercitazione successiva: