Defina métricas de ventas como uma view de métricas
A página Query e explorar seus dados computa a receita diária da franquia com uma query salva. Uma view de métricas transforma essa lógica em um objeto governado. Você define Total de Ventas, Contagem de Pedidos e Valor Médio do Pedido em um só lugar, e dashboards, agentes Genie e clientes SQL leem a mesma definição. Altere uma medida nessa definição, e as queries com execução após a alteração usarão essa definição.
A fonte é a sua camada silver. A saída é starterjourney_catalog.bakehouse_gold.franchise_sales_metrics.
Requisitos
Você precisa do seguinte antes de criar a view de métricas:
CREATE TABLEeUSE SCHEMAno schema em que você cria a view de métricas eUSE CATALOGno seu catalog. Para criar o schema Ouro, você também precisa deCREATE SCHEMAnostarterjourney_catalog.SELECTembakehouse_silver.transactionsebakehouse_silver.franchises.CAN USEem um SQL Warehouse, como o Starter warehouse , ou em compute com execução do Databricks Runtime 18.1 e acima.
Você pode criar uma view de métrica no Databricks Runtime 16.4 e acima. Os exemplos nesta página precisam da versão 18.1 e acima, pois o YAML define rely.at_most_one_match no join. Sinônimos e comentários em campos e medidas também precisam da especificação YAML 1.1. Os SQL Warehouses atendem a ambos os requisitos.
Construir a view de métricas
Crie o esquema Ouro, defina a view da métrica com o Genie Code ou o YAML de fallback e verifique seus totais em relação à query salva.
Criar o esquema ouro
No editor SQL, anexe um SQL warehouse, como o Starter Warehouse , e faça a execução:
CREATE SCHEMA IF NOT EXISTS starterjourney_catalog.bakehouse_gold;
Criar a view de métricas
Crie uma view de métrica vazia no esquema bakehouse_gold e, em seguida, abra-a no editor:
- No Catalog Explorer, abra o esquema
bakehouse_golde clique em Criar > View de métrica . - Na caixa de diálogo Criar view de métrica , insira o nome
franchise_sales_metrics, selecione o catálogostarterjourney_cataloge o esquemabakehouse_golde clique em Criar .
Gerar a definição com Genie Code
No editor, abra o Genie Code no ícone no canto superior direito e cole este prompt:
Tell Genie Code to do this for you:
Create a metric view on starterjourney_catalog.bakehouse_silver.transactions joined to starterjourney_catalog.bakehouse_silver.franchises on franchise_id, many-to-one. Add fields: franchise (the franchise_name from the join), sales_date (the transaction_timestamp truncated to a day), and product. Add measures: total_sales as SUM(total_price), order_count as COUNT(1), and avg_order_value as total_sales divided by order_count. Add the synonyms "revenue" and "sales" to total_sales, and "AOV" to avg_order_value.
Revise a definição
Verifique a definição gerada em relação a esta lista:
- A fonte é
bakehouse_silver.transactions, unida abakehouse_silver.franchisesemfranchise_id, muitos para um. - Os campos são
franchise,sales_date(em nível de dia) eproduct. - As métricas são
total_salescomoSUM(total_price),order_countcomoCOUNT(1)eavg_order_valuecomoMEASURE(total_sales) / MEASURE(order_count).
Os nomes de campos e métricas são importantes. As páginas do dashboard e do Genie Agent se referem a eles, então renomeie qualquer nome gerado que seja diferente da lista acima. Use the fallback YAML Open the YAML editor with the <> button, replace the definition with the following, and then continue.
Pré-visualizar e salvar
Clique em Visualizar para verificar os campos e medidas e, em seguida, clique em Salvar .
Validar com a query salva
No editor SQL, faça a execução desta query. Envolva cada medida em MEASURE() e liste cada coluna em vez de usar SELECT *.
SELECT
`sales_date`,
`franchise`,
MEASURE(`total_sales`) AS total_sales
FROM starterjourney_catalog.bakehouse_gold.franchise_sales_metrics
GROUP BY ALL
ORDER BY `sales_date`, `franchise`;
Os totais diários por franquia devem corresponder à query de receita diária da franquia que você salvou. Consulte Salvar a query. Se não corresponderem, verifique o join e as medidas.
Certificar e entregar
Depois que os números corresponderem, aplique a tag governada pelo sistema system.certification_status com o valor certified à view de métrica. Você precisa da permissão ASSIGN nessa tag. Consulte Marcar dados como certificados ou obsoletos.
Somente o proprietário pode editar a definição de uma view de métrica. Para que uma equipe possa mantê-la, conceda ao grupo SELECT nas tabelas de origem e, em seguida, transfira a propriedade da view de métrica para o grupo. Cada membro do grupo pode então editar a definição. O Databricks não oferece suporte à transferência de propriedade para views de métricas materializadas. Consulte Habilitar edição colaborativa.
Solução de problemas
Use essas entradas para solucionar problemas na caixa de diálogo de criação, totais, nomes de campo e a função MEASURE().
A criação da view de métrica falhou ou a opção está indisponível
Vincule um SQL Warehouse ou compute com execução do Databricks Runtime 18.1 ou acima, e confirme que você tem CAN USE nele.
Os totais parecem inflados
A cardinalidade de join default é many_to_one, que trata a tabela unida como uma pesquisa de dimensão. Os totais aumentam quando você define rely.at_most_one_match: true em um join de franquia que tem mais de uma linha por franchise_id. O Databricks não valida a configuração rely em Runtime, portanto, as correspondências duplicadas fazem com que SUM e COUNT retornem resultados errados. Confirme se o join de franquia é muitos para um em franchise_id e se franchises tem uma linha por franquia.
O Genie Code usou nomes de campo diferentes
As páginas de dashboard e Genie Agent usam franchise, sales_date, product, total_sales, order_count e avg_order_value. Renomeie os campos e medidas gerados para corresponder ou cole o YAML de fallback.
Totais diários não correspondem à query salva
Verifique se sales_date trunca transaction_timestamp para um dia e se total_sales soma total_price. Reconcilie qualquer diferença de fuso horário entre as duas queries.
Uma query falha com um erro sobre a função MEASURE
Envolva todas as medidas em MEASURE() e passe o name da medida, não seu nome de exibição. Se o nome contiver espaços, envolva-o em crases, como MEASURE(`Total Revenue`). Veja Views de métricas de query.
Os passos seguintes
-
- Crie e compartilhe o painel de desempenho da franquia
- Crie o painel de desempenho da franquia Bakehouse nessa view de métrica
-
- Referência de sintaxe YAML de view de métrica
- Procure todas as keys YAML para views de métricas, incluindo joins,
rely, sinônimos e materialização