Руководство. Создание пользовательского мини-приложения аналитики

В этом руководстве показано, как создавать настраиваемые аналитические мини-приложения с помощью собственных аналитических запросов.

В этом руководстве вы узнаете, как выполнять следующие задачи.

• выполнение собственного запроса и его просмотр на диаграмме;
• создание настраиваемого аналитического мини-приложения на основе диаграммы;
• добавление диаграммы на панель мониторинга сервера или базы данных;
• добавление сведений в настраиваемое аналитическое мини-приложение.

Необходимые компоненты

Для работы с этим руководством требуется SQL Server или база данных SQL Azure TutorialDB. Чтобы создать базу данных TutorialDB, выполните инструкции, приведенные в одном из следующих кратких руководств:

• Подключение и отправка запроса к SQL Server с помощью Azure Data Studio
• Подключение и обращение к базе данных SQL Azure с помощью Azure Data Studio

Выполнение собственного запроса и просмотр результата в представлении диаграммы

На этом этапе вы выполните скрипт SQL для запроса текущих активных сеансов.

1. Чтобы открыть новое окно редактора, нажмите клавиши CTRL+N.

2. Измените контекст подключения на TutorialDB.

3. Вставьте следующий запрос в редактор запросов:

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

4. Сохраните запрос в редакторе в файле *.sql. Для данного руководства сохраните скрипт в файле activeSession.sql.

5. Чтобы выполнить запрос, нажмите клавишу F5.

6. После того как отобразятся результаты запроса, щелкните Показать как диаграмму, а затем перейдите на вкладку Средство просмотра диаграмм.

7. Измените тип диаграммы на счетчик. В результате будет построена диаграмма подсчета.

Добавление настраиваемого аналитического мини-приложения на панель мониторинга базы данных

1. Чтобы открыть конфигурацию аналитического мини-приложения, щелкните Создать аналитику на вкладке Средство просмотра диаграмм:

   

2. Скопируйте конфигурацию аналитики (данные JSON).

3. Нажмите клавиши CTRL+запятая, чтобы открыть параметры пользователя.

4. В параметрах поиска введите панель мониторинга.

5. Щелкните Изменить для элемента dashboard.database.widgets.

   

6. Вставьте данные JSON конфигурации аналитики в dashboard.database.widgets. Параметры панели мониторинга базы данных имеют следующий вид:

    "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. Сохраните файл настроек пользователя и откройте панель мониторинга базы данных TutorialDB, чтобы увидеть мини-приложение активных сеансов:

   

Добавление сведений в настраиваемое аналитическое мини-приложение

1. Чтобы открыть новое окно редактора, нажмите клавиши CTRL+N.

2. Измените контекст подключения на TutorialDB.

3. Вставьте следующий запрос в редактор запросов:

    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. Сохраните запрос в редакторе в файле *.sql. Для данного руководства сохраните скрипт в файле activeSessionDetail.sql.

5. Нажмите клавиши CTRL+запятая, чтобы открыть параметры пользователя.

6. Измените раздел dashboard.database.widgets в файле параметров:

    "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. Сохраните файл настроек пользователя и откройте панель мониторинга базы данных TutorialDB. Нажмите кнопку с многоточием (...) рядом со свойством My-Widget, чтобы просмотреть сведения:

   

Следующие шаги

Из этого руководства вы узнали, как:

• выполнение собственного запроса и его просмотр на диаграмме;
• создание настраиваемого аналитического мини-приложения на основе диаграммы;
• добавление диаграммы на панель мониторинга сервера или базы данных;
• добавление сведений в настраиваемое аналитическое мини-приложение.

Чтобы научиться выполнять резервное копирование и восстановление баз данных, пройдите следующее руководство:

Резервное копирование и восстановление баз данных