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

Вы можете запрашивать представления метрик, такие как стандартные представления из любого редактора SQL, подключенного к хранилищу SQL или вычислительному ресурсу, работающему в поддерживаемой среде выполнения. Представления метрик позволяют гибко группировать и фильтровать. Можно анализировать показатели по любой комбинации полей (также называемых измерениями) во время выполнения без предварительного вычисления каждой агрегации. Запросы на этой странице демонстрируют распространенные шаблоны запросов.

Меры и поля запросов

Все оценки мер в запросе представления метрик должны использовать агрегатную функцию MEASURE . Полные сведения и синтаксис см. в разделеmeasure агрегатной функции. В Databricks Runtime 18.1 и более поздних версий можно также использовать agg.

Note

Чтобы выбрать все поля и показатели из представления метрик, явно перечислите каждое поле и оберните каждый показатель в агрегатную функцию MEASURE(). Поскольку меры требуют правильной MEASURE() оценки функции, необходимо указать отдельные столбцы, а не использовать SELECT *.

Запрос с группировкой

SELECT
  `Order Month`,
  `Order Status`,
  MEASURE(`Order Count`),
  MEASURE(`Total Revenue`)
FROM orders_metric_view
GROUP BY ALL
ORDER BY `Order Month`;

Запрос с фильтрацией

SELECT
  o_orderpriority,
  MEASURE(`Total Revenue`),
  MEASURE(`Total Revenue per Customer`)
FROM orders_metric_view
WHERE `Order Status` = 'Fulfilled'
GROUP BY o_orderpriority;

Запрос с другими таблицами

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

WITH orders AS (
  SELECT
    o_custkey,
    MEASURE(`Order Count`) AS order_count,
    MEASURE(`Total Revenue`) AS total_revenue
  FROM orders_metric_view
  GROUP BY o_custkey
)
SELECT
  c.c_mktsegment,
  orders.order_count,
  orders.total_revenue
FROM orders
JOIN samples.tpch.customer c ON orders.o_custkey = c.c_custkey
ORDER BY c.c_mktsegment;

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

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

Просмотр определения и метаданных представления метрик

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

DESCRIBE TABLE EXTENDED <catalog.schema.metric_view_name> AS JSON

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

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

Представления метрик также можно использовать в рабочей области Azure Databricks и во внешних средствах:

инструмент Description
Панели мониторинга ИИ/BI Используйте представления метрик для предоставления точной, объясняемой аналитики. Функция MEASURE() применяется автоматически, а метаданные агента, такие как синонимы, отображаемые имена и форматирование, отображаются в пользовательском интерфейсе.
Агенты Genie Используйте представления метрик в агентах Genie, чтобы включить точную, объясняемую аналитику на основе ИИ.
Оповещения Отслеживайте меры представления метрик и запускайте уведомления при пересечении пороговых значений.
Анализ запросов Используйте профиль запроса для устранения неполадок и оптимизации запросов представления метрик.
JDBC и ODBC Доступ к представлениям метрик через подключения JDBC и ODBC. API метаданных предоставляют структуру представления метрик внешним средствам бизнес-аналитики и аналитики.
Внешние средства бизнес-аналитики Запрашивайте представления метрик из Power BI, Tableau, Sigma и других BI-инструментов с помощью пользовательского SQL или режима совместимости с BI.
надстройка Excel Запрашивать представления метрик из Microsoft Excel с помощью надстройки Azure Databricks для Excel.
Google Sheets Запрос представлений метрик из Google Sheets с помощью соединителя Databricks.

Дополнительные ресурсы