Поделиться через

Работа с параметрами панели мониторинга

  • Статья

В этой статье объясняется, как использовать параметры на панелях мониторинга ИИ/BI. Если вы хотите узнать о фильтрах полей, см. раздел "Фильтрация по полям".

Параметры панели мониторинга AI/BI позволяют заменить различные значения в запросы набора данных во время выполнения. Это позволяет фильтровать данные по таким критериям, как даты и категории продуктов, прежде чем данные агрегируются в SQL-запросе, что приводит к более эффективному запросу и точному анализу. Параметры можно использовать с мини-приложениями фильтра, чтобы сделать панели мониторинга интерактивными или с мини-приложениями визуализации, чтобы упростить повторное использование наборов данных.

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

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

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

Чтобы добавить параметр в набор данных панели мониторинга, необходимо иметь по крайней мере разрешения CAN EDIT на черновике. Параметры можно добавлять непосредственно в запросы набора данных на вкладке "Данные ".

Gif показывает пример следующих шагов.

Чтобы добавить параметр в запрос, выполните приведенные действия.

  1. Поместите курсор в расположение параметра в запросе.

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

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

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

Чтобы изменить параметр, выполните приведенные действия.

  1. Щелкните Значок шестеренки рядом с именем параметра. Откроется диалоговое окно сведений о параметрах и включает следующие параметры конфигурации:

    • Ключевое слово: ключевое слово, представляющее параметр в запросе. Это можно изменить только путем непосредственного обновления текста в запросе.

    • Отображаемое имя: имя в редакторе фильтров. По умолчанию заголовок совпадает с ключевым словом.

    • Тип: поддерживаемые типы включают String, Date, Date и Time, Numeric.

      • Тип по умолчанию — String.
      • Числовый тип данных позволяет указать между десятичным и целым числом. Числовой тип по умолчанию — Десятичный.

    • Разрешить несколько вариантов выбора: установите флажок, чтобы разрешить пользователям выбирать несколько параметров во время выполнения.

      Примечание.

      Для этого выбора может потребоваться дополнительное изменение запроса. См. раздел "Разрешить несколько выборок".

  2. Щелкните другую часть пользовательского интерфейса, чтобы закрыть диалоговое окно.

Установка значения параметра по умолчанию

Чтобы выполнить запрос, выберите значение по умолчанию для параметра, введя его в текстовое поле под именем параметра. Запустите запрос, чтобы просмотреть результаты запроса с примененным значением параметра. При выполнении запроса также сохраняется значение по умолчанию. При установке этого параметра с помощью мини-приложения фильтра на холсте используется значение по умолчанию, если в мини-приложении фильтра не указано новое значение по умолчанию. См. раздел "Использование фильтров".

Разрешить несколько выборок

Запросы, разрешающие несколько выборов, должны включать ARRAY_CONTAINS функцию в запрос.

В следующем примере показан SQL-запрос, позволяющий выбрать несколько значений для вставки в запрос во время выполнения. Предложение WHERE использует функцию ARRAY_CONTAINS . Эта функция принимает ключевое слово параметра и имя столбца в качестве аргументов. При выполнении запроса возвращает все строки, содержащие выбранные значения параметров.

SELECT
  *
FROM
  samples.tpch.lineitem
WHERE array_contains(:parameter, l_quantity)

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

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

Применение параметров диапазона дат

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

  • Диапазон дат
  • Диапазон даты и времени

В следующем примере показан SQL-запрос, который создает параметр диапазона дат с именем date_param.

SELECT * FROM samples.tpch.lineitem
WHERE l_shipdate BETWEEN :date_param.min and :date_param.max

Чтобы создать параметр диапазона дат, выполните приведенные действия.

  1. Нажмите кнопку "Добавить параметр".

  2. Щелкните Значок шестеренки рядом с именем параметра. Введите ключевое слово и отображаемое имя. Не включать .min или .max суффиксы.

  3. Выберите диапазон дат или диапазон даты и времени в качестве типа.

  4. Вставьте предложение, определяющее WHERE диапазон в запрос. Чтобы определить диапазон, используйте BETWEEN предложение с .min и .max значениями. Например:

     WHERE date_col BETWEEN :date_param.min AND :date_param.max

  5. Введите значения даты по умолчанию и запустите запрос для его тестирования. Используйте значок календаря, чтобы выбрать предварительные параметры, такие как на прошлой неделе или в прошлом месяце.

Параметры на основе запросов

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

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

  1. Создайте набор данных, результирующий набор которого ограничен списком возможных значений параметров.
  2. Создайте запрос набора данных, использующий параметр.
  3. Настройте мини-приложение фильтра на холсте, который фильтрует поле и использует параметр.
    • Конфигурации полей должны быть заданы для использования поля с требуемым списком допустимых значений параметров.
    • Для выбора значения параметра необходимо задать конфигурацию параметров .

Примечание.

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

Сведения о добавлении параметра и визуализации на основе запросов см . в пошаговом руководстве по использованию параметров на основе запросов.

Создание динамического списка параметров

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

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Создание списка статических параметров

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

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

Удаление параметра запроса

Чтобы удалить параметр, удалите его из запроса.

Параметры статических мини-приложений

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

Пример в этом разделе основан на наборе данных, который запрашивает таблицу samples.nyctaxi.trips . Предоставленный запрос возвращает расстояние каждой поездки и классифицирует день сбора как Weekday или Weekend. Параметр запроса фильтрует результаты на основе того, произошло ли получение в будний день или выходные дни.

Текст запроса представлен в следующем блоке кода, но инструкции в этом разделе ограничены настройкой связанных визуализаций, настроенных со статическими параметрами мини-приложения. Инструкции по настройке набора данных с параметрами см. в разделе "Добавление параметра в запрос".


  WITH DayType AS (
    SELECT
      CASE
        WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
        ELSE 'Weekday'
      END AS day_type,
      trip_distance
    FROM samples.nyctaxi.trips
  )
  SELECT day_type, trip_distance
  FROM DayType
  WHERE day_type = :day_type_param

Чтобы добавить статический параметр мини-приложения в визуализацию:

  1. Добавьте мини-приложение визуализации на черновик панели мониторинга.

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

  3. Нажмите кнопку "Показать фильтры". Для наборов данных, включающих параметры, на панели конфигурации появится раздел "Параметры ".

    Панель конфигурации визуализации, показывающая параметр для выбора парамтера.

  4. Щелкните знак "плюс" справа от заголовка "Параметры" и выберите параметр в раскрывающемся списке.

  5. По умолчанию значение параметра отражает то, что задано в запросе на вкладке "Данные ". Его можно сохранить или выбрать новое значение для замены в набор данных. Перейдите от текстового поля, чтобы отобразить визуализацию с примененным новым параметром.

  6. Просмотрите панель мониторинга.

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

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

Сравнение данных с помощью условия фильтра

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

Следующий пример расширяет предыдущий запрос, чтобы включить условие фильтра, в котором указанное значение Allпараметра не отображается в данных. Первая часть условия фильтра работает так же, как и в предыдущем примере, фильтрация результатов, где day_type находится либо Weekday Weekend. Вторая часть условия фильтра проверяет, задан ли сам параметр определенное значение, в данном случае Allоно не отображается в данных. При установке значения по умолчанию для этого параметра в редакторе наборов данных вы эффективно обходят фильтр, если ни в качестве значений не Weekday Weekend передаются.


WITH DayType AS (
  SELECT
    CASE
      WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
      ELSE 'Weekday'
    END AS day_type,
    trip_distance
  FROM
    samples.nyctaxi.trips
)
SELECT
  day_type,
  trip_distance
FROM
  DayType
WHERE
  day_type = :day_type_param
  OR :day_type_param = 'All'

Этот набор данных можно использовать для настройки трех мини-приложений визуализации с заданным значением day_type_param AllWeekday и Weekend соответственно. Затем средства просмотра панелей мониторинга могут сравнить каждый набор данных, отфильтрованный по типу дня, со всем набором данных.

В следующем GIF-файле показано, как быстро создавать три диаграммы из набора данных, созданного с помощью этого запроса.

  1. Первая диаграмма настроена для отображения набора данных "Расстояние поездки по дням " со значением параметра, равным Weekday.
  2. Клонируйте диаграмму для поддержания всех примененных конфигураций.
  3. Чтобы отобразить данные для поездок, выполненных в выходные дни, настройте статический параметр на Выходные.
  4. Клонируйте новую диаграмму для поддержания всех ранее примененных конфигураций.
  5. Задайте для параметра в новой диаграмме значение All , чтобы отобразить общее количество поездки по расстоянию для поездок по выходным и выходным дням.

Gif, как описано в предыдущем тексте.

Отображение параметров на панели мониторинга

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

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

  1. Нажмите кнопку "Значок фильтраДобавить фильтр" (поле или параметр).
  2. Щелкните Значок добавления поля рядом с параметрами на панели конфигурации.
  3. Щелкните имя параметра, которое будет использоваться средством просмотра с этим мини-приложением.

Работа с мини-приложениями фильтра и статическими параметрами

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

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


CASE WHEN :static_param != 'All' THEN :static_param ELSE :dash_param END

В этом примере :static_param относится к статическому параметру, который должен иметь значение All как в мини-приложении визуализации, так и в редакторе наборов данных. Параметр :dash_param — это динамическое значение, управляемое мини-приложением фильтра на холсте панели мониторинга. Эта инструкция проверяет значение, предоставленное как статический параметр. Если параметр панели мониторинга не задан, он возвращается к значению параметра панели мониторинга, выбранного средством просмотра.

Включение параметров в URL-адрес

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

Параметры панели мониторинга и параметры запроса mustache

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

Примеры синтаксиса

Распространенные способы использования параметров включают вставку дат, чисел, текста, объектов базы данных и значений из строк JSON. Примеры использования параметров в этих случаях см . в примерах синтаксиса именованных параметров.

Внимание

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