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

  • Статья

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

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

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

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

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

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

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

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

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

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

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

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

  1. Щелкните Значок шестеренки рядом с именем параметра. Откроется диалоговое окно сведений о параметрах.

    Диалоговое окно включает следующие параметры конфигурации:

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

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

Удаление параметра

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

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

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

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

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

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

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

(1) Значения вставляются с помощью format_string функции. См . format_string функцию.

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

  • Добавьте только записи до определенной даты.

    WHERE date_field < :date_param

  • Включите только цены ниже определенной цены.

    WHERE price < :max_price

  • Выберите таблицу, используемую в запросе.

    SELECT * FROM IDENTIFIER(:param)

  • Измените каталог, схему и таблицу, используемую в запросе.

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

  • Объедините два параметра с квадратными скобками для создания форматированных номеров телефонов.

    В следующем примере функция используется для вставки значений format_string . См . format_string функцию.

    format_string('(%d) %d', :area_code, :phone_number)

Внимание

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

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

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