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

Уведомления Databricks SQL

Внимание

Эта функция доступна в общедоступной предварительной версии.

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

Чтобы узнать, как работать с устаревшими оповещениями, см. статью "Что такое устаревшие оповещения?".

Включение оповещений в рабочей области

Администраторы рабочей области могут управлять доступом к этой предварительной версии на странице «Предварительные версии». Включение этой предварительной версии не влияет на существующие оповещения; Эти и устаревшие оповещения можно продолжать параллельно.

Просмотр и упорядочивание оповещений

Щелкните значок оповещенийОповещения на боковой панели, чтобы открыть страницу списка оповещений.

Страница описания оповещений.

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

  • На вкладке "Устаревшие оповещения" отображаются оповещения, созданные с помощью предыдущей системы оповещений.

  • Имя отображает строковое имя каждого оповещения.

  • Состояние показывает, является ли состояние оповещения TRIGGERED, OK или ERROR.

  • Расписание показывает последнее обновленное время или дату.

  • Владелец отображает имя пользователя, которому принадлежит оповещение.

  • Время создания отображает дату и время создания оповещения.

    • TRIGGERED означает, что в последнем выполнении столбец Value в целевом запросе соответствует заданному условию и порогу . Если ваше оповещение проверяет, превышает ли "кошки" 1500, ваше оповещение будет срабатывать, пока "кошки" выше 1500.
    • OK означает, что в последнем выполнении запроса столбец "Значение " не соответствовал заданному условию и порогу . Это не означает, что оповещение не было активировано ранее. Если ваше значение "cats" теперь равно 1470, оповещение будет отображаться как OK.
    • ERROR указывает, что во время оценки оповещений произошла ошибка.

Создание оповещения

В этом разделе описано, как создать оповещение, показанное на следующем рисунке. Используйте метки и объяснения для понимания каждого компонента.

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

  1. Редактор запросов: Напишите и проверьте запрос, на который нужно включить оповещение.

  2. Расписание: Задайте периодическое расписание для запуска оповещения.

  3. Состояние: Выберите пороговое значение, которое должно активировать уведомление об оповещении. Запрос можно запустить, чтобы проверить условие из этого раздела.

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

  5. Продвинутый: Используйте дополнительные параметры для оповещения о специальных значениях и условиях.

Внимание

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

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

  1. Щелкните значок оповещенийОповещения на боковой панели и нажмите Создать оповещение.

  2. Скопируйте и вставьте следующий запрос в редакторе запросов. Нажмите кнопку "Выполнить все" (1000). Дополнительные сведения о работе с редактором SQL см. в статье "Написание запросов" и изучение данных в новом редакторе SQL.

    SELECT
  to_date(tpep_pickup_datetime) as date,
  SUM(fare_amount) as amount
FROM
  `samples`.`nyctaxi`.`trips`
GROUP BY
  ALL
ORDER BY
  1 DESC

  3. В поле "Условие" задайте условия, которые должны активировать оповещение.

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

    Примените следующие параметры, как показано ниже.

    • Выберите Sum в качестве значения данных для проверки. Условия генерации оповещений можно задать в первом значении столбца в результате запроса или задать агрегирование во всех строках одного столбца, например SUM или AVERAGE.
    • Выберите сумму в качестве проверяемого столбца.
    • Выберите > (больше) в качестве логического оператора для применения.
    • Задайте для порогового значения значение Static value 4000. По умолчанию выбрано статическое значение. Введите 4000 в поле значения.

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

  5. В разделе "Уведомления" найдите имя пользователя и щелкните его при появлении.

  6. Щелкните значок , чтобы открыть диалоговое окно "Изменить расписание ". Используйте раскрывающиеся меню, чтобы задать оповещение, чтобы оно выполнялось каждые 5минут с 0 минут за час. Нажмите кнопку Сохранить. При необходимости установите флажок Показать синтаксис cron, чтобы изменить расписание в Синтаксиса Cron вCron.

  7. Щелкните "Просмотреть оповещение".

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

Просмотр сведений об оповещении

Откроется страница для отображения сведений о оповещении. Кроме того, история оповещений отображается с подробными сведениями об истории оценки. Нажмите кнопку "Запустить сейчас ", чтобы немедленно запустить запрос оповещения и вернуть результат на этом экране.

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

Расширенные настройки

Нажмите кнопку "Дополнительные параметры" , чтобы применить следующие параметры:

  • Уведомление о порядке: Отправьте уведомление, когда оповещение возвращается как OK.
  • Частота уведомлений: Периодически отправлять уведомления по оповещению до тех пор, пока состояние не вернётся к OK.
  • Пустое состояние результата: Задайте специальное состояние, чтобы возвращать, когда запрос не возвращает результаты.
  • Шаблон: Вы можете отправлять уведомления с помощью шаблона по умолчанию или пользовательского шаблона. В следующем списке объясняется каждый тип шаблона.
    • Использовать шаблон по умолчанию: уведомление по оповещению представляет собой сообщение со ссылками на экран настройки оповещений и экран запроса.
    • Использовать пользовательский шаблон: уведомление по оповещению включает подробные сведения об оповещении.

      1. При этом отображается набор полей для ввода темы и текста. Допустимо любое статическое содержимое, и вы даже можете внедрять встроенные переменные шаблона.

        • ALERT_STATUS: состояние оцененного оповещения (строка).
        • ALERT_CONDITION: оператор условия оповещения (строка).
        • ALERT_THRESHOLD: пороговое значение оповещения (строка или число).
        • ALERT_COLUMN: имя столбца оповещения (строка).
        • ALERT_NAME: имя оповещения (строка).
        • ALERT_URL: URL-адрес страницы оповещения (строка).
        • QUERY_RESULT_TABLE: таблица HTML результатов запроса (строка). Результаты ограничены первыми 100 строками. Только адресаты уведомлений по электронной почте могут отображать HTML.
        • QUERY_RESULT_VALUE: значение результата запроса (строка или число).
        • QUERY_RESULT_ROWS: строки результатов запроса (массив значений).
        • QUERY_RESULT_COLS: столбцы результатов запроса (строковый массив).

        Примером темы может быть Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

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

        • Допустимые теги: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thread>, <tbody>, <td>, <th>, <tr>, <u>, <ul>

        • Допустимые атрибуты:

          Атрибут Поддерживаемые теги
          href <a>
          title <img>
          target <a>
          alt <img>
          src <img>
          start <b>, <blockquote><code><del><em><hr><i><pre><u>

      3. Нажмите кнопку Предварительный просмотр, чтобы просмотреть результат.

        Внимание

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

Администраторы рабочей области могут настроить новые назначения уведомлений. См. статью "Управление назначениями уведомлений".

Агрегаты оповещений

Агрегирование оповещений работает путем изменения исходного SQL-запроса Databricks SQL, присоединенного к оповещению. Оповещение упаковывает исходный текст запроса в общее табличное выражение (CTE) и выполняет в нем запрос агрегирования, чтобы агрегировать результат запроса.

Например, агрегирование оповещений, присоединенных к запросу с текстомSUM, означает, SELECT 1 AS column_name что при обновлении оповещения измененный SQL, который выполняется, будет: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q

Это означает, что исходный результат запроса (предварительно агрегированный) не может отображаться в пользовательском теле оповещения (с такими параметрами, как QUERY_RESULT_ROWS и QUERY_RESULT_COLS) всякий раз, когда есть агрегирование в оповещении. Вместо этого эти переменные будут отображать только окончательный результат запроса после агрегирования.

Примечание.

Все условия триггера, связанные с агрегатами, не поддерживаются API.

Оповещение по нескольким столбцам

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

SELECT CASE WHEN drafts_count > 10000 AND archived_count > 5000 THEN 1 ELSE 0 END
FROM (
SELECT sum(CASE WHEN is_archived THEN 1 ELSE 0 END) AS archived_count,
sum(CASE WHEN is_draft THEN 1 ELSE 0 END) AS drafts_count
FROM queries) data

Этот запрос возвращает 1, если drafts_count > 10000 and archived_count > 5000. Затем вы можете настроить срабатывание оповещения при значении 1.

Оповещение о просмотрах метрик

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

Как интеграция Git работает с оповещениями

Папки Databricks Git можно использовать для отслеживания изменений оповещений и управления ими. Чтобы отслеживать оповещения с помощью Git, поместите их в папку Databricks Git. Клонированные оповещения появляются на странице списка оповещений или API после взаимодействия пользователя с ними. Они приостановили расписания и должны быть явно возобновлены пользователями.

Папки Databricks Git предоставляют централизованный способ управления общими операциями Git для оповещений и других объектов рабочей области. Дополнительные сведения см. в папках Azure Databricks Git.

Различия от устаревших оповещений

Последняя версия оповещений Databricks SQL ведет себя по-разному от устаревших оповещений несколькими ключевыми способами:

  • Интеграция заданий: Последняя версия пока не поддерживает прямую ссылку на оповещение в конвейере заданий. Эта функция скоро появится. Устаревшие уведомления поддерживают тип задания "Оповещения" в задачах.
  • Повторное использование запроса: Существующий сохраненный SQL-запрос нельзя повторно использовать при создании оповещения. Каждое оповещение владеет определением запроса, которое можно создать непосредственно в новом редакторе оповещений.
  • Значения состояния оповещений: Состояния оповещений становятся более простыми, и оповещения больше не поддерживают состояние UNKNOWN из устаревших оповещений. Оценки разрешаются в OK, TRIGGERED, или ERROR.

При переходе можно продолжать использовать последние оповещения и устаревшие оповещения.

Настройка разрешений оповещений и владение оповещениями

Уровни разрешений генерации оповещений см. в разделе "Списки управления доступом для оповещений".

  1. На боковой панели нажмите кнопку "Оповещения".

  2. Щелкните оповещение.

  3. Щелкните "Общий доступ " в правом верхнем углу страницы сведений об оповещении, чтобы открыть диалоговое окно "Общий доступ ".

    Управление разрешениями оповещений

  4. Найдите и выберите группы и пользователей и назначьте уровень разрешений.

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

Передача прав владения оповещением

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

  1. Войдите в рабочую область Azure Databricks как администратор рабочей области.

  2. На боковой панели нажмите кнопку "Оповещения".

  3. Щелкните оповещение.

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

  5. Щелкните значок шестеренки в правом верхнем углу и нажмите кнопку "Назначить нового владельца".

    Назначение нового владельца

  6. Выберите пользователя, которому нужно передать права собственности.

  7. Нажмите кнопку Подтвердить.

  • Last updated on