Samouczek: tworzenie niestandardowego widżetu szczegółowych informacji

W tym samouczku pokazano, jak używać własnych zapytań szczegółowych informacji do tworzenia niestandardowych widżetów szczegółowych informacji.

Z tego samouczka dowiesz się, jak wykonywać następujące działania:

• Uruchamianie własnego zapytania i wyświetlanie go na wykresie
• Tworzenie niestandardowego widżetu szczegółowych informacji na podstawie wykresu
• Dodawanie wykresu do pulpitu nawigacyjnego serwera lub bazy danych
• Dodawanie szczegółów do niestandardowego widżetu szczegółowych informacji

Wymagania wstępne

Ten samouczek wymaga bazy danych TutorialDB programu SQL Server lub usługi Azure SQL Database. Aby utworzyć bazę danych TutorialDB , wykonaj jeden z następujących przewodników Szybki start:

• Nawiązywanie połączenia z programem SQL Server i wykonywanie zapytań względem programu SQL Server przy użyciu narzędzia Azure Data Studio
• Nawiązywanie połączenia z usługą Azure SQL Database i wykonywanie zapytań względem usługi Azure SQL Database przy użyciu narzędzia Azure Data Studio

Uruchamianie własnego zapytania i wyświetlanie wyniku w widoku wykresu

W tym kroku uruchom skrypt sql, aby wykonać zapytanie dotyczące bieżących aktywnych sesji.

1. Aby otworzyć nowy edytor, naciśnij Ctrl+N.

2. Zmień kontekst połączenia na TutorialDB.

3. Wklej następujące zapytanie do edytora zapytań:

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

4. Zapisz zapytanie w edytorze w pliku *.sql. Na potrzeby tego samouczka zapisz skrypt jako activeSession.sql.

5. Aby wykonać zapytanie, naciśnij F5.

6. Po wyświetleniu wyników zapytania kliknij pozycję Wyświetl jako wykres, a następnie kliknij kartę Podgląd wykresu.

7. Zmień typ wykresu na liczbę. Te ustawienia renderuje wykres liczbowy.

Dodawanie szczegółowych informacji niestandardowych do pulpitu nawigacyjnego bazy danych

1. Aby otworzyć konfigurację widżetu szczegółowych informacji, kliknij pozycję Utwórz szczegółowe informacje w przeglądarce wykresów:

   

2. Skopiuj konfigurację szczegółowych informacji (dane JSON).

3. Naciśnij Ctrl+Przecinek, aby otworzyć ustawienia użytkownika.

4. Wpisz pulpit nawigacyjny w obszarze Ustawienia wyszukiwania.

5. Kliknij pozycję Edytuj dla elementu dashboard.database.widgets.

   

6. Wklej kod JSON konfiguracji szczegółowych informacji do pliku dashboard.database.widgets. Ustawienia pulpitu nawigacyjnego bazy danych wyglądają następująco:

    "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. Zapisz plik Ustawienia użytkownika i otwórz pulpit nawigacyjny bazy danych TutorialDB, aby wyświetlić widżet aktywnych sesji:

   

Dodawanie szczegółów do szczegółowych informacji niestandardowych

1. Aby otworzyć nowy edytor, naciśnij Ctrl+N.

2. Zmień kontekst połączenia na TutorialDB.

3. Wklej następujące zapytanie do edytora zapytań:

    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. Zapisz zapytanie w edytorze w pliku *.sql. Na potrzeby tego samouczka zapisz skrypt jako activeSessionDetail.sql.

5. Naciśnij Ctrl+Przecinek, aby otworzyć ustawienia użytkownika.

6. Edytuj istniejący węzeł dashboard.database.widgets w pliku ustawień:

    "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. Zapisz plik Ustawienia użytkownika i otwórz pulpit nawigacyjny bazy danych TutorialDB. Kliknij przycisk wielokropka (...) obok pozycji Mój widżet , aby wyświetlić szczegóły:

   

Następne kroki

W tym samouczku zawarto informacje na temat wykonywania następujących czynności:

• Uruchamianie własnego zapytania i wyświetlanie go na wykresie
• Tworzenie niestandardowego widżetu szczegółowych informacji na podstawie wykresu
• Dodawanie wykresu do pulpitu nawigacyjnego serwera lub bazy danych
• Dodawanie szczegółów do niestandardowego widżetu szczegółowych informacji

Aby dowiedzieć się, jak tworzyć kopie zapasowe i przywracać bazy danych, wykonaj następny samouczek:

Tworzenie kopii zapasowych i przywracanie baz danych.