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

Создание представления метрик

Это важно

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

Узнайте, как создать представление метрик для централизации бизнес-логики и последовательно определять ключевые показатели производительности в поверхностях отчетов. Смотрите представления метрик каталога Unity. В этом руководстве показано, как создать представление метрик с помощью пользовательского интерфейса обозревателя каталогов. Сведения об определении представлений метрик с помощью SQL см. в статье CREATE VIEW.

Предпосылки

  • У вас должны быть SELECT права на объекты исходных данных.
  • Необходимо иметь привилегиюCREATE TABLE и USE SCHEMA привилегию в схеме, где вы хотите создать представление метрик.
  • Необходимо также иметь привилегии USE CATALOG в родительском каталоге схемы.
  • РАЗРЕШЕНИЯ CAN USE в хранилище SQL или другом вычислительном ресурсе, работающем под управлением Databricks Runtime 16.4 или более поздней версии.

Администратор хранилища метаданных или владелец каталога может предоставить вам все эти привилегии. Владелец схемы или пользователь с привилегией MANAGE может предоставить вам привилегии USE SCHEMA и CREATE TABLE в схеме.

Шаг 1. Выбор источника данных

Представление метрик может основываться на таблице, представлении или SQL-запросе. В этом руководстве используется таблица orders в схеме samples каталога tpch.

  1. Щелкните значок данных.Каталог на боковой панели рабочей области.
  2. Используйте панель поиска в браузере схем, чтобы найти таблицу samples.tpch.orders. Щелкните заказы, чтобы отобразить подробности таблицы.
  3. Нажмите кнопку "Создать>представление метрик". Откроется редактор YAML.

Шаг 2. Определение метрик

Определение YAML для этого представления метрик включает следующие поля верхнего уровня:

  • version: По умолчанию 0.1. Это версия спецификации представления метрик.
  • source:samples.tpch.orders — это полностью квалифицированное имя таблицы. Все измерения и меры в этом представлении метрик используют указанную таблицу в качестве источника данных.
  • filter: все запросы этого представления возвращают записи с o_orderdate после 1 января 1990 года.
  • dimensions:Order Month, Order Statusи Order Priority определяются как измерения.
  • measures: определены четыре меры (Order Count, Total Revenueи Total Revenue per CustomerTotal Revenue for Open Orders) с указанным выражением агрегирования.

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

  2. Введите имя представления метрик. Имена представлений метрик могут включать альфа-числовые значения и символы подчеркивания.

  3. Замените содержимое редактора следующим определением:

    version: 0.1

source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)

  - name: Order Status
    expr: CASE
      WHEN o_orderstatus = 'O' then 'Open'
      WHEN o_orderstatus = 'P' then 'Processing'
      WHEN o_orderstatus = 'F' then 'Fulfilled'
      END

  - name: Order Priority
    expr: SPLIT(o_orderpriority, '-')[1]

measures:
  - name: Order Count
    expr: COUNT(1)

  - name: Total Revenue
    expr: SUM(o_totalprice)

  - name: Total Revenue per Customer
    expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)

  - name: Total Revenue for Open Orders
    expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')

  4. Нажмите кнопку Создать.

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

Шаг 3. Добавление описания, комментариев и тегов

На вкладке обзора:

  • Нажмите кнопку "Добавить описание ", чтобы добавить описание в метаданные представления.
  • Чтобы добавить примечания, наведите указатель мыши на столбец "Комментарий " для строки, в которой требуется добавить комментарий.
  • Чтобы добавить теги в метрику или измерение, наведите указатель мыши на столбец "Теги", в котором нужно добавить тег.
  • Чтобы добавить тег в представление, нажмите кнопку "Добавить теги " справа от страницы.

Шаг 4. Изменение определения YAML (необязательно)

Определение YAML можно просмотреть и открыть редактор YAML на вкладке "Сведения ".

  1. Нажмите кнопку "Сведения".
  2. Щелкните ... дополнительные строки для просмотра полного определения.
  3. Нажмите кнопку "Изменить", чтобы открыть редактор YAML.
  4. Добавление или удаление измерений или мер. Нажмите кнопку Сохранить.

Шаг 5. Установка разрешений (необязательно)

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

  1. Щелкните "Разрешения".
  2. Используйте пользовательский интерфейс для предоставления и отзыва разрешений для других пользователей Azure Databricks.

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

Запрос представления метрик

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

В следующем примере запроса вычисляются три перечисленные меры и они агрегируются по Order Month и Order Status. Он возвращает результаты, отсортированные по Order Month.

Все меры должны быть обёрнуты в функцию MEASURE. См. агрегатную функцию measure.


SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC

Дальнейшие шаги