Criar uma exibição de métrica usando a interface do usuário do Catalog Explorer

Saiba como criar uma visualização métrica para centralizar a lógica de negócios e definir consistentemente indicadores-chave de desempenho em superfícies de relatórios. Este tutorial demonstra como criar uma exibição de métrica usando a interface do usuário do Catalog Explorer. Para definir exibições métricas usando SQL, consulte Usar SQL para criar e gerenciar exibições métricas e CREATE VIEW.

Pré-requisitos

• Você deve ter SELECT privilégios nos objetos de dados de origem.
• Você deve ter o privilégio CREATE TABLE e o privilégio USE SCHEMA no esquema onde deseja criar a vista métrica.
• Você também deve ter o USE CATALOG privilégio no catálogo pai do esquema.
• PODE USAR permissões em um SQL warehouse ou outro recurso de computação executando o Databricks Runtime 17.2 ou superior.

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

Etapa 1: escolha uma fonte de dados

Sua exibição métrica pode ser baseada em uma tabela, exibição ou consulta SQL. Este tutorial usa a orders tabela no samples esquema do tpch catálogo.

1. Clique no Catálogo na barra lateral do espaço de trabalho.
2. Use a barra de pesquisa no navegador de esquema para localizar a samples.tpch.orders tabela. Clique em Pedidos para mostrar os detalhes da tabela.
3. Clique em Criar>visualização de métrica. O editor YAML é aberto.

Etapa 2: definir métricas

A definição de YAML para esta vista métrica inclui os seguintes campos de nível superior:

• version: O padrão é 1.1. Esta é a versão da especificação da visualização métrica.
• source:samples.tpch.orders é um nome de tabela totalmente qualificado. Todas as dimensões e medidas nessa exibição métrica usam a tabela especificada como fonte de dados.
• filter: Todas as consultas nesta exibição retornam registros com um o_orderdate após 1º de janeiro de 1990.
• dimensions:Order Month, Order Status, e Order Priority são definidas como dimensões.
• measures: Quatro medidas (Order Count, Total Revenue, Total Revenue per Customer, e Total Revenue for Open Orders) são definidas, cada uma com uma expressão de agregação especificada.

1. Use o menu suspenso catálogo e esquema para escolher onde deseja salvar sua exibição métrica. Os usuários que consultam devem ter pelo menos USE CATALOG e USE SCHEMA privilégios para acessar a exibição métrica.

2. Insira um nome para sua visualização métrica. Os nomes das vistas métricas podem incluir valores alfanuméricos e sublinhados.

3. Substitua o conteúdo do editor pela seguinte definição:

   version: 1.1
   
   source: samples.tpch.orders
   filter: o_orderdate > '1990-01-01'
   
   dimensions:
     - name: Order Month
       expr: DATE_TRUNC('MONTH', o_orderdate)
   
     - name: Order Status
       expr: CASE
         WHEN o_orderstatus = 'O' then 'Open'
         WHEN o_orderstatus = 'P' then 'Processing'
         WHEN o_orderstatus = 'F' then 'Fulfilled'
         END
   
     - name: Order Priority
       expr: SPLIT(o_orderpriority, '-')[1]
   
   measures:
     - name: Order Count
       expr: COUNT(1)
   
     - name: Total Revenue
       expr: SUM(o_totalprice)
   
     - name: Total Revenue per Customer
       expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
   
     - name: Total Revenue for Open Orders
       expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
   

4. Clique em Criar.

Sua visualização métrica está pronta para consumo por qualquer usuário com pelo menos SELECT privilégios na visualização métrica. Consulte Privilégios do catálogo Unity e objetos protegíveis para saber mais sobre como gerenciar permissões. Para saber mais sobre como os usuários podem consultar essa exibição de métrica, consulte Consultar uma exibição de métrica.

Depois de criar uma exibição de métrica, você pode revisar a origem, o filtro e as medidas e dimensões especificadas na guia Visão geral que é aberta.

Etapa 3: adicionar uma descrição, comentários e tags

Você pode adicionar descrições, comentários e tags na definição de YAML ou na guia Visão geral .

Para adicionar usando YAML (recomendado para controle de versão):

Adicione comment campos diretamente na sua definição de YAML. Consulte Registro de alterações de especificação de versão para obter detalhes de sintaxe.

version: 1.1
comment: 'Orders metrics for revenue analysis'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month when the order was placed'

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

Para adicionar usando a guia Visão geral:

• Clique em Adicionar descrição para adicionar uma descrição aos metadados da visualização métrica.
• Para adicionar comentários, passe o mouse sobre a coluna Comentário da linha em que deseja adicionar um comentário.
• Para adicionar etiquetas a uma medida ou dimensão, passe o rato sobre a coluna Etiquetas onde pretende adicionar uma etiqueta.
• Para adicionar uma etiqueta à vista métrica, clique em Adicionar etiquetas no lado direito da página.

Etapa 4: (Opcional) Editar a definição de YAML

Você pode visualizar a definição de YAML e abrir o editor de YAML na guia Detalhes .

1. Clique em Detalhes.
2. Clique em ... mais linhas para ver a definição completa.
3. Clique em Editar para abrir o editor YAML.
4. Adicionar ou eliminar dimensões ou medidas. Clique em Salvar.

Etapa 5: (Opcional) Definir permissões

As visualizações de métricas respeitam o mesmo modelo de permissões hierárquicas que outros objetos seguros do Unity Catalog. Nenhuma nova permissão será necessária se a vista métrica estiver armazenada num esquema ao qual os destinatários tenham acesso de leitura. Você pode atribuir permissões explicitamente na exibição de métrica na guia Permissões .

1. Clique em Permissões.
2. Use a interface do usuário para conceder e revogar permissões para outros usuários do Azure Databricks.

Para obter mais detalhes, consulte Conceder permissões em um objeto.

Consultar uma vista métrica

Pode consultar uma vista métrica a partir do editor SQL incorporado da área de trabalho ou de qualquer editor SQL que possa aceder aos seus dados no Azure Databricks. Para consultar uma exibição de métrica, você deve estar anexado a um SQL warehouse ou outro recurso de computação que execute o Databricks Runtime 17.2 ou superior.

A consulta de exemplo a seguir avalia as três medidas listadas e agrega sobre Order Month e Order Status. Ele retorna resultados classificados por Order Month.

Todas as medidas devem ser envolvidas na função MEASURE. Consulte a função agregada measure.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC

Próximos passos

Agora que você criou uma exibição de métrica usando SQL, explore estes tópicos relacionados:

Consultar e consumir visualizações métricas

• Consultar uma visualização de métricas.
• Use visualizações métricas com painéis de IA/BI.
• Use visualizações métricas com o AI/BI Genie.
• Defina alertas em visualizações métricas.

Recursos avançados de visualização de métricas

• Use metadados semânticos em exibições métricas.
• Utilize junções em visões métricas.
• Use medidas de janela em visões métricas.
• Referência de sintaxe YAML.

Métodos alternativos de criação

• Use SQL para criar e gerenciar exibições de métricas.
• CREATE VIEW.
• ALTER VIEW.
• DESCRIBE TABLE.

Governação e segurança

• Gerencie privilégios no Catálogo Unity.
• Grupos.
• Privilégios do Unity Catalog e objetos protegíveis.