Criar e editar visualização de métricas

Esta página explica como criar e editar visualizações de métricas usando a interface do usuário do Catalog Explorer ou SQL. A interface do Explorador de Catálogo inclui um editor de baixo código e um editor YAML. A interface de usuário com pouco código é um bom ponto de partida se você preferir não escrever SQL.

Para um exemplo mais complexo, consulte o tutorial: Criar uma view de métricas completa com join.

Pré-requisitos

Antes de criar ou editar uma view de métricas, verifique se você possui as seguintes permissões:

• SELECT privilégios na tabela ativa ou na consulta SQL usada como fonte.
• privilégios CREATE TABLE e USE SCHEMA no esquema onde você deseja criar a view de métricas.
• USE CATALOG privilégio no catálogo pai.
• CAN USE Permissão em um SQL warehouse ou outro recurso compute executando Databricks Runtime 17.3 ou superior.

Um administrador do metastore ou proprietário do catálogo pode conceder todos esses privilégios. Um proprietário de esquema ou usuário com privilégio MANAGE pode conceder privilégios USE SCHEMA e CREATE TABLE no esquema.

Criar uma viewde tempo

Você pode criar uma view de métricas usando a interface do usuário do Catalog Explorer, SQL ou o editor YAML.

Catalog Explorer UI

A interface de usuário de baixo código do Catalog Explorer permite definir dimensões e medidas interativamente, sem precisar escrever YAML diretamente.

1. Clique Catálogo na barra lateral workspace .

2. Utilize a barra de pesquisa para encontrar a sua tabela de origem. Por exemplo, pesquise por samples.tpch.orders.

3. Clique no nome da tabela para exibir os detalhes da tabela.

4. Clique em Criar > viewde métricas . Na caixa de diálogo Criar viewde métricas , insira um nome e selecione um catálogo e um destino de esquema. Em seguida, clique em Criar .

   

5. Clique em UI para abrir o editor de baixo código, se necessário.

Defina as dimensões

As dimensões são atributos categóricos usados para agrupar e filtrar, como mês do pedido ou status do pedido. Todas as colunas de origem são adicionadas automaticamente como dimensões.

1. Clique Adicione em Dimensões .
2. Para definir uma expressão de dimensão, digite uma expressão SQL no campo de expressão. Por exemplo, digite DATE_TRUNC('month', o_orderdate) para agrupar os pedidos por mês.
3. Opcionalmente, clique Gere com AI para usar Genie Code e sugerir uma expressão dimensional.
4. Opcionalmente, insira um Nome de exibição , Comentário , Sinônimos , Formato ou tags . O formato está disponível apenas para colunas numéricas, de data e de data e hora.

Definir medidas

As métricas são expressões agregadas que produzem indicadores de negócios, como receita total ou número de pedidos.

1. Clique Adicione em Medidas .

2. Insira uma expressão agregada SQL no campo de expressão. Por exemplo, digite SUM(o_totalprice) para calcular a receita total.

3. Opcionalmente, clique Gere com AI para usar Genie Code e sugerir uma expressão de medida.

4. Opcionalmente, insira um Nome de exibição , Comentário , Sinônimos , Formato ou tags .

   

   Para pré-visualizar uma medida, clique Pré-visualização ao lado do nome da medida. A pré-visualização mostra os resultados da medição para um intervalo de tempo e dimensão selecionados.

   

5. Clique em Salvar .

SQL

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

SQL

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 obter detalhes completos sobre a sintaxe YAML, consulte métricas view YAML syntax reference.

YAML editor

1. Clique Catálogo na barra lateral workspace .

2. Utilize a barra de pesquisa para encontrar a sua tabela de origem. Por exemplo, pesquise por samples.tpch.orders.

3. Clique no nome da tabela para exibir os detalhes da tabela.

4. Clique em Criar > viewde métricas . Na caixa de diálogo Criar viewde métricas , insira um nome e selecione um catálogo e um destino de esquema. Em seguida, clique em Criar .

   

5. Clique em YAML para abrir o editor YAML.

6. Insira sua definição YAML e clique em Criar . A seguinte definição é usada no exemplo da tab SQL .

   YAML

   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 obter detalhes completos sobre a sintaxe YAML, consulte métricas view YAML syntax reference.

Qualquer usuário com pelo menos SELECT privilégios agora pode consultar a view de métricas. Para saber mais sobre como gerenciar permissões, consulte Definir permissões.

Gere uma view em formato de tela com Genie Code

Genie Code pode gerar uma definição view de métricas a partir de uma descrição em linguagem simples:

1. Clique no ícone Genie Code no canto superior direito da sua workspace.
2. Descreva a view de métricas que você deseja criar. O Genie Code retorna o DDL SQL.
3. Copie o código SQL e cole-o no editor SQL. Click execução .
4. Edite o SQL ou abra o editor view de métricas para fazer ajustes. Consulte Editar uma viewde métricas.

Editar uma viewde tempo

Você precisa ser o proprietário de uma view de métricas para editar sua definição. Para permitir a edição colaborativa, transfira a propriedade para um grupo. Consulte Ativar edição colaborativa.

Catalog Explorer UI

1. Encontre a view de métricas no Explorador de Catálogo.
2. Clique em Editar para abrir o editor.
3. Clique em UI para view a interface de usuário com pouco código.
4. Clique na medida ou dimensão que deseja editar. Faça as alterações e clique em Salvar .
5. Para adicionar uma nova dimensão ou medida, clique Adicione a seção que deseja editar. Consulte Criar uma viewde métricas para obter instruções detalhadas sobre como definir novas medidas e dimensões.

SQL

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

SQL

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"
$$

YAML editor

1. Navegue até a view de métricas no Explorador de Catálogo.
2. Clique em Editar e, em seguida, clique em YAML para abrir o editor YAML.
3. Modifique a definição YAML e clique em Salvar .

Próximos passos

Após criar uma view de métricas, use o seguinte recurso para consultar, gerenciar e estender seu trabalho.

Consultar e consumir

• Visualização de métricas de consulta
• Use a visualização de métricas em painéis.
• Crie um espaço Genie
• alerta na visualização de Olhos

gerenciar e governar

• Visão geral
• Consulte Gerenciar privilégios no Unity Catalog

Recurso avançado

• Vista do modelo
• Técnicas avançadas para visualização de Métis
• Metadados do agente na visualização de métricas
• métricas view referência de sintaxe YAML

Exemplos

• Tutorial: Crie uma view completa do Mesh com junção.