Självstudie: Skapa en anpassad insiktswidget

Viktig

Azure Data Studio går i pension den 28 februari 2026. Vi rekommenderar att du använder Visual Studio Code. Mer information om hur du migrerar till Visual Studio Code finns i Vad händer med Azure Data Studio?

Den här handledningen visar hur du använder dina egna insiktsfrågor för att skapa anpassade widgetar.

I den här handledningen lär du dig att:

• Kör din egen fråga och visa den i ett diagram
• Skapa en anpassad insiktswidget från diagrammet
• Lägga till diagrammet på en server- eller databasinstrumentpanel
• Lägga till information i din anpassade insiktswidget

Förutsättningar

Den här handledningen kräver SQL Server eller Azure SQL Database TutorialDB. Om du vill skapa TutorialDB-databasen slutför du någon av följande snabbstarter:

• Anslut och ställ frågor till SQL Server med hjälp av Azure Data Studio
• Ansluta och skicka frågor till Azure SQL Database via Azure Data Studio

Kör din egen fråga och visa resultatet i en diagramvy

I det här steget kör du ett SQL-skript för att köra frågor mot de aktuella aktiva sessionerna.

1. Om du vill öppna en ny redigerare trycker du på Ctrl+N.

2. Ändra anslutningskontexten till TutorialDB.

3. Klistra in följande fråga i frågeredigeraren:

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

4. Spara frågan i redigeraren till en *.sql-fil. I den här handledningen sparar du skriptet som activeSession.sql.

5. Tryck på F5 för att köra frågan.

6. När frågeresultatet har visats klickar du på Visa som diagram och sedan på fliken Diagramvisning .

7. Ändra diagramtyp till antal. Dessa inställningar renderar ett räknediagram.

Lägg till en anpassad insikt på databasens dashboard

1. Om du vill öppna konfigurationen av insiktswidgeten klickar du på Skapa insikt i diagramvisaren:

   

2. Kopiera insiktskonfigurationen (JSON-data).

3. Tryck på Ctrl+Komma för att öppna Användarinställningar.

4. Skriv instrumentpanelen i Sökinställningar.

5. Klicka på Redigera för dashboard.database.widgets.

   

6. Klistra in insiktskonfigurationens JSON i dashboard.database.widgets. Inställningarna för databasinstrumentpanelen ser ut så här:

    "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. Spara filen Användarinställningar och öppna instrumentpanelen för TutorialDB-databasen för att se widgeten för aktiva sessioner:

   

Lägg till detaljer till anpassad insikt

1. Om du vill öppna en ny redigerare trycker du på Ctrl+N.

2. Ändra anslutningskontexten till TutorialDB.

3. Klistra in följande fråga i frågeredigeraren:

    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. Spara frågan i redigeraren till en *.sql-fil. I den här självstudien sparar du skriptet som activeSessionDetail.sql.

5. Tryck på Ctrl+Komma för att öppna Användarinställningar.

6. Redigera den befintliga noden dashboard.database.widgets i inställningsfilen :

    "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. Spara filen Användarinställningar och öppna den TutorialDB-databasens instrumentpanel. Klicka på ellipsknappen (...) bredvid My-Widget för att visa informationen:

   

Nästa steg

I den här självstudiekursen lärde du dig att:

• Kör din egen fråga och visa den i ett diagram
• Skapa en anpassad insiktswidget från diagrammet
• Lägg till diagrammet på en server- eller databas-panel
• Lägga till information i din anpassade insiktswidget

Om du vill lära dig hur du säkerhetskopierar och återställer databaser slutför du nästa självstudie:

Säkerhetskopiera och återställa databaser.