Consultar exibições de métricas

Você pode consultar exibições de métricas como exibições padrão de qualquer editor de SQL anexado a um warehouse SQL ou recurso de computação executando um runtime com suporte. As exibições de métrica habilitam o agrupamento e a filtragem flexíveis. Você pode analisar medidas em qualquer combinação de campos (também chamadas de dimensões) em runtime sem pré-computar cada agregação. As consultas nesta página demonstram padrões de consulta comuns.

Medidas e campos de consulta

Todas as avaliações de medida em uma consulta de exibição de métrica devem usar a MEASURE função de agregação. Para obter detalhes completos e sintaxe, consulte measure a função de agregação. No Databricks Runtime 18.1 e superior, você também pode usar agg.

Consulta com agrupamento

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

Consulta com filtragem

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

Consulta com outras tabelas

As exibições de métrica não podem ser diretamente unidas a outras tabelas no momento da consulta. Para unir uma visualização de métrica com outra tabela, encapsule a consulta da visualização de métrica em um CTE e, em seguida, una o resultado do 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;

Consultar uma visualização de métrica com parâmetros

Para consultar uma exibição de métrica que define parâmetros, chame-a como uma função com valor de tabela e passe cada parâmetro como um argumento nomeado. Para obter detalhes e exemplos, consulte Consultar uma exibição de métrica com parâmetros.

Exibir metadados e definição de exibição de métrica

A consulta a seguir retorna a definição de YAML completa para uma exibição de métrica, incluindo medidas, campos, junções e metadados do agente. O AS JSON parâmetro é opcional. Para obter detalhes completos da sintaxe, consulte a saída formatada em JSON.

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

A definição de YAML completa é mostrada no campo Exibir Texto nos resultados. Cada coluna contém um campo de metadados que contém metadados do agente.

Consumir exibições de métricas em ferramentas

Você também pode usar exibições de métrica em todo o workspace Azure Databricks e em ferramentas externas:

Recursos adicionais

• Gerenciar exibições de métrica
• Exibições de métrica do modelo
• Usar exibições de métrica
• Criar um Agente Genie