Criar e editar vistas métricas

Esta página explica como criar e editar vistas de métricas usando a interface Catalog Explorer ou SQL. A interface do Explorador de Catálogos inclui um editor low-code e um editor YAML. A interface low-code é um bom ponto de partida se preferires não escrever SQL.

Para um exemplo mais complexo, veja Tutorial: Constrói uma vista métrica completa com joins.

Pré-requisitos

Antes de criar ou editar uma vista métrica, verifique se tem as seguintes permissões:

SELECT privilégios no asset semelhante a uma tabela ou na consulta SQL usada como fonte.
CREATE TABLE e USE SCHEMA privilégios no esquema onde se quer criar a vista métrica.
USE CATALOG Privilégio no catálogo principal.
CAN USE permissão num SQL warehouse ou outro recurso de computação a correr Databricks Runtime 17.3 ou superior.

Um administrador da metastore ou proprietário do catálogo pode conceder todos estes privilégios. Um proprietário ou utilizador de esquema com MANAGE privilégio pode conceder USE SCHEMA e CREATE TABLE privilégios sobre o esquema.

Criar uma vista métrica

Pode criar uma vista métrica usando a interface do Catalog Explorer, SQL ou o editor YAML.

UI do Explorador de Catálogo

A interface low-code do Catalog Explorer permite-lhe definir dimensões e medidas de forma interativa sem escrever diretamente em YAML.

Clique no Catálogo na barra lateral do espaço de trabalho.
Usa a barra de pesquisa para encontrares a tua tabela de origem. Por exemplo, procure por samples.tpch.orders.
Clique no nome da tabela para mostrar os detalhes da tabela.
Clique em Criar>visualização de métrica. No diálogo Criar vista métrica , introduza um nome e selecione um catálogo e destino de esquema. Depois clica em Criar.
Clique em UI para abrir o editor low-code, se necessário.

Definir dimensões

As dimensões são atributos categóricos usados para agrupamento e filtragem, como o mês da encomenda ou o estado da encomenda. Todas as colunas de origem são adicionadas automaticamente como dimensões.

Clique Adicionar em Dimensões.
Para definir uma expressão dimensional, escreva uma expressão SQL no campo de expressão. Por exemplo, digite DATE_TRUNC('month', o_orderdate) para agrupar encomendas por mês.
Opcionalmente, clique em Gerar com IA para usar o Código Génio para sugerir uma expressão dimensional.
Opcionalmente, insira um Nome de Exibição, Comentário, Sinónimos, Formato ou Etiquetas. O formato está disponível apenas para colunas numéricas, de data e de data-hora.

Definir medidas

As medidas são expressões agregadas que produzem métricas de negócio, como receita total ou contagem de encomendas.

Clique no e depois em Adicionar em Medidas.
Introduza uma expressão agregada SQL no campo de expressão. Por exemplo, digite SUM(o_totalprice) para calcular a receita total.
Opcionalmente, clique em Gerar com IA para usar o Código Génio e sugerir uma expressão de medida.
Opcionalmente, insira um Nome de Exibição, Comentário, Sinónimos, Formato ou Etiquetas.

Para pré-visualizar uma medida, clique em Pré-visualizar ao lado do nome da medida. A pré-visualização mostra os resultados das medidas para uma janela temporal e dimensão selecionadas.
Clique em Salvar.

SQL

Use CREATE VIEW com a WITH METRICS cláusula para criar uma exibição métrica. Especifique a definição YAML entre $$ delimitadores:

CREATE OR REPLACE VIEW orders_metric_view WITH METRICS LANGUAGE YAML AS
$$
  version: 1.1
  comment: "Orders KPIs for sales analysis"
  source: samples.tpch.orders
  filter: o_orderdate > '1990-01-01'

  dimensions:
    - name: Order Month
      expr: DATE_TRUNC('MONTH', o_orderdate)
      comment: "Month of order"

    - name: Order Status
      expr: CASE
        WHEN o_orderstatus = 'O' THEN 'Open'
        WHEN o_orderstatus = 'P' THEN 'Processing'
        WHEN o_orderstatus = 'F' THEN 'Fulfilled'
        END
      comment: "Status of order"

    - name: o_orderdate
      expr: o_orderdate
      comment: "Original order date"

    - name: o_orderkey
      expr: o_orderkey
      comment: "Order key"

    - name: o_custkey
      expr: o_custkey
      comment: "Customer key"

    - name: o_orderpriority
      expr: o_orderpriority
      comment: "Order priority"

    - name: o_clerk
      expr: o_clerk
      comment: "Clerk"

    - name: o_shippriority
      expr: o_shippriority
      comment: "Ship priority"

    - name: o_comment
      expr: o_comment
      comment: "Order comment"

  measures:
    - name: Order Count
      expr: COUNT(1)
      comment: "Total number of orders"

    - name: Total Revenue
      expr: SUM(o_totalprice)
      comment: "Sum of all order prices"

    - name: Total Revenue per Customer
      expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
      comment: "Average revenue per unique customer"
$$

Para detalhes completos da sintaxe YAML, veja Vista métrica Referência da sintaxe YAML.

Editor YAML

Clique no Catálogo na barra lateral do espaço de trabalho.
Usa a barra de pesquisa para encontrares a tua tabela de origem. Por exemplo, procure por samples.tpch.orders.
Clique no nome da tabela para mostrar os detalhes da tabela.
Clique em Criar>visualização de métrica. No diálogo Criar vista métrica , introduza um nome e selecione um catálogo e destino de esquema. Depois clica em Criar.
Clique em YAML para abrir o editor YAML.

Introduza a definição do seu YAML e clique em Criar. A seguinte definição é usada no exemplo no separador SQL.

version: 1.1
comment: 'Orders KPIs for sales analysis'
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month of order'

  - name: Order Status
    expr: CASE
      WHEN o_orderstatus = 'O' THEN 'Open'
      WHEN o_orderstatus = 'P' THEN 'Processing'
      WHEN o_orderstatus = 'F' THEN 'Fulfilled'
      END
    comment: 'Status of order'

  - name: o_orderdate
    expr: o_orderdate
    comment: 'Original order date'

  - name: o_orderkey
    expr: o_orderkey
    comment: 'Order key'

  - name: o_custkey
    expr: o_custkey
    comment: 'Customer key'

  - name: o_orderpriority
    expr: o_orderpriority
    comment: 'Order priority'

  - name: o_clerk
    expr: o_clerk
    comment: 'Clerk'

  - name: o_shippriority
    expr: o_shippriority
    comment: 'Ship priority'

  - name: o_comment
    expr: o_comment
    comment: 'Order comment'

measures:
  - name: Order Count
    expr: COUNT(1)
    comment: 'Total number of orders'

  - name: Total Revenue
    expr: SUM(o_totalprice)
    comment: 'Sum of all order prices'

  - name: Total Revenue per Customer
    expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
    comment: 'Average revenue per unique customer'

Para detalhes completos da sintaxe YAML, veja Vista métrica Referência da sintaxe YAML.

Qualquer utilizador com pelo menos SELECT privilégios pode agora consultar a vista métrica. Para saber mais sobre a gestão de permissões, consulte Definir permissões.

Gerar uma vista métrica com o Genie Code

O Genie Code pode gerar uma definição de vista métrica a partir de uma descrição em linguagem simples:

Clique no ícone do Código Génio no canto superior direito do seu espaço de trabalho.
Descreve a vista métrica que queres criar. O Genie Code devolve SQL DDL.
Copia o SQL e cola-o no editor SQL. Clique em Executar.
Edite o SQL ou abra o editor de exibição de métricas para fazer ajustes. Veja Editar uma vista métrica.

Editar uma vista métrica

Tens de ser o proprietário de uma vista métrica para editar a sua definição. Para permitir a edição colaborativa, transfira a propriedade para um grupo. Ver Permitir edição colaborativa.

UI do Explorador de Catálogo

Encontre a visão métrica no Explorador de Catálogos.
Clica em Editar para abrir o editor.
Clique em UI para ver a interface de baixo código.
Clique na medida ou dimensão que pretende editar. Faz as tuas alterações e clica em Guardar.
Para adicionar uma nova dimensão ou medida, clique em Adicionar na secção que pretende editar. Consulte Criar uma vista métrica para instruções detalhadas sobre a definição de novas medidas e dimensões.

SQL

Use ALTER VIEW com uma definição YAML atualizada:

ALTER VIEW catalog.schema.orders_metric_view
AS $$
version: 1.1
comment: "Orders KPIs for sales analysis"
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'

dimensions:
 - name: Order Month
   expr: DATE_TRUNC('MONTH', o_orderdate)
   comment: "Month of order"

 - name: Order Status
   expr: CASE
     WHEN o_orderstatus = 'O' THEN 'Open'
     WHEN o_orderstatus = 'P' THEN 'Processing'
     WHEN o_orderstatus = 'F' THEN 'Fulfilled'
     END
   comment: "Status of order"

measures:
 - name: Order Count
   expr: COUNT(1)
   comment: "Total number of orders"

 - name: Total Revenue
   expr: SUM(o_totalprice)
   comment: "Sum of all order prices"

 - name: Total Revenue per Customer
   expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
   comment: "Average revenue per unique customer"

 - name: Total Revenue for Open Orders
   expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
   comment: "Revenue from open orders"
$$

Editor YAML

Navegue até à vista métrica no Explorador de Catálogos.
Clica em Editar e depois em YAML para abrir o editor YAML.
Modifica a definição do YAML e clica em Guardar.

Passos seguintes

Depois de criar uma vista métrica, utilize os seguintes recursos para consultar, gerir e expandir o seu trabalho.

Criar e editar vistas métricas

Pré-requisitos

Criar uma vista métrica

UI do Explorador de Catálogo

SQL

Editor YAML

Gerar uma vista métrica com o Genie Code

Editar uma vista métrica

UI do Explorador de Catálogo

SQL

Editor YAML

Passos seguintes

Consultar e consumir

Gerir e governar

Funcionalidades avançadas

Exemplos

Comentários

Recursos adicionais