Pular para o conteúdo principal

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 TABLE e USE SCHEMA no schema em que você cria a view de métricas e USE CATALOG no seu catalog. Para criar o schema Ouro, você também precisa de CREATE SCHEMA no starterjourney_catalog.
  • SELECT em bakehouse_silver.transactions e bakehouse_silver.franchises.
  • CAN USE em um SQL Warehouse, como o Starter warehouse , ou em compute com execução do Databricks Runtime 18.1 e acima.
nota

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:

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

  1. No Catalog Explorer, abra o esquema bakehouse_gold e clique em Criar > View de métrica .
  2. Na caixa de diálogo Criar view de métrica , insira o nome franchise_sales_metrics, selecione o catálogo starterjourney_catalog e o esquema bakehouse_gold e 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:

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 a bakehouse_silver.franchises em franchise_id, muitos para um.
  • Os campos são franchise, sales_date (em nível de dia) e product.
  • As métricas são total_sales como SUM(total_price), order_count como COUNT(1) e avg_order_value como MEASURE(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.

YAML
version: 1.1
comment: 'Franchise sales KPIs for the Bakehouse journey'
source: starterjourney_catalog.bakehouse_silver.transactions
joins:
- name: franchise_dim
source: starterjourney_catalog.bakehouse_silver.franchises
'on': source.franchise_id = franchise_dim.franchise_id
rely:
at_most_one_match: true
fields:
- name: franchise
expr: franchise_dim.franchise_name
comment: 'Franchise name'
- name: sales_date
expr: DATE(source.transaction_timestamp)
comment: 'Calendar day of the transaction'
- name: product
expr: source.product
comment: 'Product sold'
measures:
- name: total_sales
expr: SUM(source.total_price)
comment: 'Sum of transaction total price'
synonyms: ['revenue', 'sales']
- name: order_count
expr: COUNT(1)
comment: 'Number of transactions'
- name: avg_order_value
expr: MEASURE(total_sales) / MEASURE(order_count)
comment: 'Average order value'
synonyms: ['AOV']

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 *.

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