Pular para o conteúdo principal

Visualização de métricas de consulta

Você pode consultar a visualização de métricas como se fosse uma visualização padrão a partir de qualquer editor SQL conectado a um SQL warehouse ou recurso compute que execute um ambiente de execução compatível. A visualização de métricas oferece suporte a agrupamento e filtragem flexíveis, permitindo analisar métricas em qualquer combinação de dimensões em tempo de execução, sem a necessidade de pré-calcular cada agregação. As consultas nesta página demonstram padrões de consulta comuns.

Medidas e dimensões da consulta

Todas as avaliações de medidas em uma consulta view de métricas devem usar a função de agregação MEASURE . Para obter detalhes completos e sintaxe, consulte a função agregadameasure.

nota

Para selecionar todas as dimensões e medidas de uma view de métricas, liste explicitamente cada dimensão e envolva cada medida com a função de agregação MEASURE() . Como as medidas exigem que a função MEASURE() seja avaliada corretamente, você deve especificar colunas individuais em vez de usar SELECT *.

Consulta com agrupamento

SQL
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

SQL
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

A visualização de métricas não pode ser diretamente combinada com outras tabelas no momento da consulta. Para join uma view de métricas com outra tabela, envolva a consulta view métricas em uma CTE (Common Table Expression) e, em seguida, join o resultado da CTE:

SQL
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;

visualizar métricas view definição e metadados

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

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

A definição YAML completa é exibida no campo de texto da visualização nos resultados. Cada coluna contém um campo de metadados que armazena metadados do agente.

Consumir visualização de métricas em ferramentas

Você também pode usar a visualização de métricas em todo o workspace Databricks e em ferramentas externas:

Ferramenta

Descrição

Painéis de AI/BI

Use a visualização de métricas para fornecer análises precisas e explicáveis. A função MEASURE() é aplicada automaticamente e os metadados do agente, como sinônimos, nomes de exibição e formatação, são apresentados na interface do usuário.

Espaços Genie

Utilize a visualização de métricas no Genie Spaces para habilitar análises precisas e explicáveis com tecnologia AI .

Alertas

O Monitor Métricas view as métricas e aciona notificações quando os limites são ultrapassados.

Análise de consultas

Utilize o perfil de consulta para solucionar problemas e otimizar as consultas view de métricas.

JDBC e ODBC

Acesse as métricas de visualização por meio de conexões JDBC e ODBC . APIs de metadados expõem a estrutura view de métricas para ferramentas externas BI e análise.

Ferramentas externas de BI

Visualize as métricas de consulta de ferramentas BI externas usando o modo de compatibilidade BI .

Suplemento do Excel

Visualize métricas de consulta no Microsoft Excel usando o suplemento Databricks Excel .

Planilhas do Google

Visualize as métricas de consulta do Google Sheets usando o conector Databricks .

Próximos passos