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


Что такое параметры панели мониторинга?

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

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

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

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

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

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

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

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

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

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

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

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

  1. Щелкните Значок шестеренки рядом с именем параметра. Откроется диалоговое окно сведений о параметрах и включает следующие параметры конфигурации:
    • Ключевое слово: ключевое слово, представляющее параметр в запросе. Это можно изменить только путем непосредственного обновления текста в запросе.
    • Отображаемое имя: имя в редакторе фильтров. По умолчанию заголовок совпадает с ключевым словом.
    • Тип: поддерживаемые типы включают String, Date, Date и Time, Numeric.
      • Тип по умолчанию — String.
      • Числовый тип данных позволяет указать между десятичным и целым числом. Числовой тип по умолчанию — Десятичный.
  2. Щелкните другую часть пользовательского интерфейса, чтобы закрыть диалоговое окно.

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

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

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

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

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

  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)

Типы фильтров

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

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

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

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

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

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

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

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

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

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

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

Вставка даты

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


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  sum(o_totalprice) AS `Total Price`
FROM
  samples.tpch.orders
WHERE
  o_orderdate > :date_param
GROUP BY
  1,
  2

Вставка числа

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


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  o_totalprice AS Price
FROM
  samples.tpch.orders
WHERE
  o_totalprice > :num_param

Вставка имени поля

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


SELECT
  *
FROM
  samples.tpch.orders
WHERE
  IDENTIFIER(:field_param) < 10000

Вставка объектов базы данных

В следующем примере создаются три параметра: catalog, schemaи table. Средства просмотра панелей мониторинга могут использовать мини-приложения фильтра на холсте для выбора значений параметров.


SELECT
  *
FROM
  IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

См . предложение IDENTIFIER.

Внимание

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

Объединение нескольких параметров

Параметры можно включить в другие функции SQL. В этом примере средство просмотра позволяет выбрать название сотрудника и идентификатор номера. Запрос использует format_string функцию для объединения двух строк и фильтрации по строкам, которые соответствуют. См . format_string функцию.


SELECT
  o_orderkey,
  o_clerk
FROM
  samples.tpch.orders
WHERE
  o_clerk LIKE format_string('%s%s', :title, :emp_number)

Параметры панели мониторинга и параметры SQL Databricks

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