Crie uma view de métricas usando a interface do usuário do Catalog Explorer

Aprenda a criar uma viewde métricas para centralizar a lógica de negócios e definir consistentemente key indicadores de desempenho em todas as superfícies de relatórios. Este tutorial demonstra como criar uma view de métricas usando a interface do usuário do Catalog Explorer. Para definir a visualização de métricas usando SQL, consulte Usar SQL para criar e gerenciar a visualização de métricas e CREATE VIEW.

Pré-requisitos

• Você deve ter privilégios SELECT nos objetos de dados de origem.
• Você deve ter o privilégioCREATE TABLE e o privilégio USE SCHEMA no esquema onde deseja criar a view de métricas.
• Você também deve ter o privilégio USE CATALOG no catálogo pai do esquema.
• Permissões CAN USE em um SQL warehouse ou outro recurso compute executando Databricks Runtime 17.2 ou superior.

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

o passo 1: Escolha uma fonte de dados

Sua view de métricas pode ser baseada em uma tabela, view ou consulta SQL . Este tutorial usa a tabela orders no esquema tpch do catálogo samples .

1. Clique Catálogo na barra lateral workspace .
2. Use a barra de pesquisa no navegador de esquemas para encontrar a tabela samples.tpch.orders . Clique em pedidos para mostrar detalhes da mesa.
3. Clique em Criar > viewde métricas . O editor YAML é aberto.

o passo 2: Definir métricas

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

• version: padrão para 1.1. Esta é a versão da especificação view de métricas.
• source: samples.tpch.orders é um nome de tabela totalmente qualificado. Todas as dimensões e medidas nesta view de métricas usam a tabela especificada como a fonte de dados.
• filter: Todas as consultas nesta view retornam registros com o_orderdate após 1º de janeiro de 1990.
• dimensions: Order Month, Order Status e Order Priority são definidos 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 de catálogo e esquema para escolher onde deseja salvar sua view de métricas. Os usuários que realizam consultas devem ter pelo menos privilégios USE CATALOG e USE SCHEMA para acessar a view de métricas.

2. Insira um nome para sua view de métricas. Os nomes view de métricas podem incluir valores alfanuméricos e sublinhado.

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

   YAML

   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 view de métricas está pronta para consumo por qualquer usuário com pelo menos SELECT privilégios na view de métricas. Consulte Privilégios e objetos protegíveisUnity Catalog para saber mais sobre como gerenciar permissões. Para saber mais sobre como os usuários podem consultar esta view de métricas, consulte Consultar uma viewde métricas.

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

o passo 3: Adicione uma descrição, comentários e tags

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

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

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

YAML

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 tabVisão geral :

• Clique em Adicionar descrição para adicionar uma descrição aos metadados da view de métricas.
• Para adicionar comentários, passe o mouse sobre a coluna Comentário da linha onde você deseja adicionar um comentário.
• Para adicionar tags a uma medida ou dimensão, passe o mouse sobre a coluna de tags onde você deseja adicionar uma tag.
• Para adicionar uma tag à view de métricas, clique em Adicionar tags no lado direito da página.

o passo 4: (Opcional) Edite a definição YAML

Você pode view a definição YAML e abrir o editor YAML na tab Detalhes .

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

o passo 5: (Opcional) Definir permissões

A visualização de métricas respeita o mesmo modelo de permissões hierárquicas que outros objetos protegíveis Unity Catalog . Nenhuma nova permissão será necessária se sua view de métricas estiver armazenada em um esquema ao qual os consumidores pretendidos tenham acesso de leitura. Você pode atribuir permissões explicitamente na view de métricas na tab 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 Databricks.

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

Consultar uma viewde métricas

Você pode consultar uma view de métricas no editorSQL integrado do workspace ou em qualquer editor SQL que possa acessar seus dados no Databricks. Para consultar uma view de métricas, você deve estar conectado a um SQL warehouse ou outro recurso compute executando Databricks Runtime 17.2 ou superior.

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

Todas as medidas devem ser encapsuladas na função MEASURE . Veja measure função agregada.

SQL

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 view de métricas usando SQL, explore estes tópicos relacionados:

Consultar e consumir visualização de métricas

• Consultar uma viewde métricas.
• Utilize a visualização de métricas com dashboards AI/BI.
• Use a visualização de métricas com AI/BI Genie.
• Definir alerta na visualização de métricas.

Medições avançadas view recurso

• Use metadados semânticos na visualização de métricas.
• Use join na visualização métricas.
• Use medidas de janela na visualização de métricas.
• Referência de sintaxe YAML.

Métodos alternativos de criação

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

Governança e segurança

• gerenciar privilégios no Unity Catalog.
• Grupos.
• PrivilégiosUnity Catalog e objetos protegíveis.