Exibições de métricas do Unity Catalog

As exibições de métrica fornecem uma maneira centralizada de definir e gerenciar métricas de negócios essenciais consistentes, reutilizáveis e governadas. Esta página explica as exibições de métrica, como defini-las, controlar o acesso e consultá-las em ferramentas downstream.

O que é uma visão de métrica?

As exibições de métrica abstraem a lógica de negócios complexa em uma definição centralizada, permitindo que as organizações definam indicadores de desempenho importantes uma vez e os usem consistentemente em ferramentas de relatório, como dashboards, espaços do Genie e alertas. As exibições de métrica são definidas no formato YAML e registradas no Catálogo do Unity. Você pode criá-los usando o SQL ou a interface do usuário do Catalog Explorer. Como qualquer outra tabela ou exibição, as exibições de métrica podem ser consultadas usando SQL.

Por que usar exibições de métrica

Ao contrário das exibições padrão que bloqueiam agregações e dimensões no momento da criação, as exibições de métrica separam definições de medida de agrupamentos de dimensões. Isso permite definir métricas uma vez e consultá-las de forma flexível em qualquer dimensão em runtime, enquanto o mecanismo de consulta gera automaticamente a computação correta.

As visualizações de métricas fornecem benefícios fundamentais.

• Padronizar definições de métrica entre equipes e ferramentas para evitar inconsistências.
• Manipule medidas complexas , como proporções e contagens distintas que não podem ser agregadas novamente com segurança em exibições padrão.
• Habilite a análise flexível dando suporte a esquemas de estrela e floco de neve com junções de vários níveis (por exemplo, pedidos → produtos → categorias).
• Acelere o desempenho da consulta com materialização interna que faz a pré-computação e atualiza incrementalmente as agregações.
• Simplifique a experiência do usuário , mantendo a transparência e a governança do SQL.

Exemplo

Suponha que você queira analisar a receita por cliente distinto em diferentes níveis geográficos. Com uma exibição padrão, você precisaria criar exibições separadas para cada agrupamento (estado, região, país) ou calcular todas as combinações com antecedência usando GROUP BY CUBE() e filtrando posteriormente. Essas soluções alternativas aumentam a complexidade e levam a problemas de desempenho e governança.

Com uma exibição de métrica, você define a métrica uma vez (soma da receita dividida por contagem de clientes distinta) e os usuários podem agrupar por qualquer dimensão de geografia disponível. O mecanismo de consulta reescreve a consulta nos bastidores para executar a computação correta, independentemente de como os dados são agrupados.

Components

Uma exibição de métrica especifica um conjunto de definições de métrica, que incluem dimensões e medidas, com base em uma fonte de dados ou várias fontes, se a lógica de junção for usada. A source definição na exibição de métrica pode ser uma exibição, uma tabela ou uma consulta SQL. As junções só têm suporte em exibições e tabelas.

Uma dimensão é um atributo categórico que organiza e filtra dados, como nomes de produtos, tipos de clientes ou regiões. As dimensões fornecem os rótulos e agrupamentos necessários para analisar as medidas com eficiência.

Uma medida é um valor que resume a atividade de negócios, normalmente usando uma função de agregação como SUM() ou AVG(). As medidas podem ser aplicadas a um ou mais campos base na tabela ou exibição de origem ou referenciar dimensões e medidas definidas anteriormente. As medidas são definidas independentemente de dimensões, permitindo que os usuários as agregem em qualquer dimensão em runtime. Por exemplo, definir uma total_revenue medida habilita a agregação por customer, supplierou region. As medidas são comumente usadas como KPIs em relatórios e dashboards.

Acessar e editar exibições de métrica

Visualizações de métricas são registradas no Unity Catalog. Usuários com pelo menos SELECT permissão na visualização de métricas podem acessar detalhes usando a interface do Catalog Explorer.

Exibir detalhes na interface do usuário do Gerenciador de Catálogos

Para exibir a exibição de métrica no Gerenciador de Catálogos:

1. Clique no Catálogo na barra lateral.
2. Navegue pelos dados disponíveis ou use a barra de pesquisa para pesquisar a exibição de métrica pelo nome.
3. Clique no nome da visualização de métrica.
4. Use as guias para exibir informações sobre a exibição de métrica:

• Visão geral: mostra todas as medidas e dimensões definidas na métrica e todos os metadados semânticos definidos.
• Detalhes: mostra a definição completa de YAML para a visualização de métrica.
• Permissões: mostra todos os principais que podem acessar a visualização de métricas, seus privilégios e o objeto de banco de dados no qual o privilégio é definido.
• Linhagem: exibe ativos relacionados, como tabelas, blocos de anotações, dashboards e outras exibições de métrica.
• Insights: As consultas feitas na exibição de métrica e os usuários que acessaram a exibição de métrica nos últimos 30 dias são listadas em ordem de frequência, com as mais frequentes na parte superior.

Habilitar edição colaborativa

Por padrão, somente o proprietário de uma exibição de métrica pode editar sua definição. Para permitir que várias pessoas colaborem na mesma exibição de métrica, transfira a propriedade para um grupo. Todos os membros desse grupo podem editar a definição, mas somente acessar dados que o grupo tem permissões para ver.

Para habilitar a edição colaborativa:

1. Crie ou identifique um grupo que deve ter acesso de edição à exibição de métrica. Consulte Grupos.
2. Conceda ao grupo SELECT acesso a todas as tabelas das quais a exibição de métrica depende.
3. Transferir a propriedade da exibição de métricas para o grupo. Consulte Transferir propriedade.
4. Adicione ou remova usuários do grupo para controlar quem pode editar a exibição de métrica.

Consultar uma exibição de métrica

Você pode consultar exibições de métrica da mesma forma que uma exibição padrão. Execute consultas de qualquer editor do SQL anexado a um sql warehouse ou outro recurso de computação executando um runtime com suporte.

Medidas e dimensões de consulta

Todas as avaliações de medida em uma consulta de exibição de métrica devem usar a MEASURE função de agregação. Para obter detalhes completos e sintaxe, consulte measure a função de agregação.

Não há suporte para JOINs no momento da consulta. Para unir tabelas:

• Defina JOINs na especificação YAML que cria a visão de métrica. Consulte Usar junções em exibições de métrica.
• Use ctes (expressões de tabela comuns) para unir fontes ao consultar uma exibição de métrica. Consulte cte (expressão de tabela comum).

Exibir detalhes como um resultado de consulta

A consulta a seguir retorna a definição de YAML completa para uma exibição de métrica, incluindo medidas, dimensões, junções e metadados semânticos. O AS JSON parâmetro é opcional. Para obter detalhes completos da sintaxe, consulte a saída formatada em JSON.

DESCRIBE TABLE EXTENDED <catalog.schema.metric_view_name> AS JSON

A definição de YAML completa é mostrada no campo Exibir Texto nos resultados. Cada coluna contém um campo de metadados que contém metadados semânticos.

Consumir visões de métricas

Você também pode usar exibições de métrica em todo o workspace do Azure Databricks. Para obter mais informações, consulte a documentação associada:

• Usar exibições de métrica com painéis de IA/BI
• Utilize visões métricas com o Genie de IA/BI
• Definir alertas em visualizações de métricas
• Solucionar problemas com o perfil de consulta
• Trabalhar com metadados de exibição de métrica usando o Driver JDBC do Databricks

Limitações

As seguintes limitações se aplicam a exibições de métrica:

• As exibições de métrica não dão suporte ao compartilhamento Delta ou à criação de perfil de dados.

Próximas etapas

• Criar uma exibição de métrica
• Usar metadados semânticos em exibições de métrica
• Usar junções em exibições de métrica
• Usar medidas de janela em visões métricas
• Materialização para visões de métricas