Использование параметров на основе запросов

В этой статье описывается, как создать интерактивную панель мониторинга, использующую параметры на основе запросов. В нем предполагается базовое знакомство с созданием панелей мониторинга в Azure Databricks. Ознакомьтесь с основными инструкциями по созданию панелей мониторинга.

Требования

• Вы вошли в рабочую область Azure Databricks.
• У вас есть право НА SQL в этой рабочей области.
• У вас есть по крайней мере ВОЗМОЖНОСТЬ ИСПОЛЬЗОВАТЬ доступ к одному или нескольким хранилищам SQL.

Создание набора данных панели мониторинга

В этом руководстве используются созданные данные из каталога примеров в Azure Databricks.

1. Щелкните "Создать" на боковой панели и выберите панель мониторинга в меню.

2. Перейдите на вкладку Данные .

3. Нажмите кнопку "Создать из SQL " и вставьте следующий запрос в редактор. Затем нажмите кнопку "Выполнить" , чтобы вернуть результаты.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Только что определенный набор данных автоматически сохранен с именем неустранимого набора данных. Дважды щелкните название, а затем переименуйте его сегмент "Маркетинг".

Добавление параметра

Чтобы отфильтровать возвращаемые значения, можно добавить параметр в этот набор данных. В этом примере используется :segmentпараметр. Дополнительные сведения о синтаксисе параметров см. в разделе "Что такое параметры панели мониторинга?"

1. Вставьте следующее WHERE предложение в нижней части запроса. Текстовое поле с именем segment параметра отображается под запросом.

   WHERE
     c_mktsegment = :segment
   

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

3. Повторно выполните запрос, чтобы проверить результаты.

Настройка мини-приложения визуализации

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

1. Щелкните вкладку "Холст ".
2. Нажмите кнопку "Добавить визуализацию", чтобы добавить мини-приложение визуализации и поместить ее на холст.

Настройка оси X

1. При необходимости выберите панель в раскрывающемся меню "Визуализация ".
2. Щелкните , чтобы выбрать данные, представленные вдоль оси X. Панель поиска можно использовать для поиска поля по имени. Выберите c_nationkey.
3. Щелкните имя поля, выбранное для просмотра дополнительных параметров конфигурации.
   • В качестве типа масштабирования выберите категориальный.
   • В поле "Преобразование" выберите "Нет".

Настройка оси Y

1. Щелкните рядом с осью Y, а затем выберите c_acctbal.
2. Щелкните имя поля, выбранное для просмотра дополнительных параметров конфигурации.
   • В качестве типа масштабирования выберите "Количественный".
   • Для выбора преобразования выберите SUM.

Визуализация автоматически обновляется при его настройке. Отображаемые данные содержат только записи, в которых находится BUILDINGобъектsegment.

Добавить фильтр

Настройте фильтр, чтобы средства просмотра панелей мониторинга могли контролировать, на какой маркетинговый сегмент сосредоточиться.

1. Нажмите кнопку "Добавить фильтр" (поле или параметр), чтобы добавить мини-приложение фильтра. Поместите его на холст.
2. В раскрывающемся меню "Фильтр" на панели конфигурации выберите одно значение.
3. Установите флажок "Заголовок", чтобы отобразить поле заголовка в мини-приложении фильтра.
4. Щелкните заголовок заполнителя в мини-приложении и введите "Сегмент ", чтобы повторить попытку фильтра.
5. Щелкните рядом с параметрами на панели конфигурации.
6. Выберите сегмент из набора данных сегмента маркетинга.

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

Определение выбора значений

Созданный фильтр является функциональным, но зритель должен знать доступный диапазон вариантов, прежде чем они смогут ввести выбор. Кроме того, требуется, чтобы пользователи соответствовали регистру и орфографии при вводе требуемого значения параметра.

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

1. Перейдите на вкладку Данные .

2. Нажмите кнопку "Создать из SQL ", чтобы создать новый набор данных.

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

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Запустите запрос и проверьте результаты. В результатах отображаются пять сегментов маркетинга из таблицы.

5. Дважды щелкните автоматически созданный заголовок, а затем переименуйте этот вариант сегмента набора данных.

Обновление фильтра

Обновите существующий фильтр, чтобы использовать только что созданный набор данных для заполнения раскрывающегося списка пользователей значений, которые можно выбрать.

1. Щелкните "Холст". Затем щелкните мини-приложение фильтра, созданное на предыдущем шаге.
2. Щелкните рядом с полями.
3. Выберите пункт "Сегмент", а затем щелкните имя c_mktsegmentполя.

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

Примечание.

В этом руководстве содержится упрощенный вариант использования, предназначенный для демонстрации использования параметров на основе запросов. Альтернативный подход к созданию этой панели мониторинга — применение фильтра к c_mktsegment полю.

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

Узнайте, как работать с панелями мониторинга со следующими статьями:

• Дополнительные сведения о применении фильтров. См. фильтры.
• Дополнительные сведения о параметрах панели мониторинга. См. раздел "Что такое параметры панели мониторинга?".
• Публикация и предоставление общего доступа к панели мониторинга. См. статью "Публикация панели мониторинга".