Pular para o conteúdo principal
Última atualização em

Visualização de métricas de consulta no Power BI

info

Beta

Este recurso está em versão Beta.

O modo de compatibilidade BI permite consultar a visualização de métricasUnity Catalog no Power BI usando o conector Databricks existente.

Esta página explica como ativar o modo de compatibilidade com BI no Power BI, como ele funciona, os cenários suportados e as limitações conhecidas.

Requisitos​

  • As conexões Power BI utilizam o driver ADBC, que está habilitado por default para novas conexões. Para obter mais informações, consulte Configurar driver ADBC ou ODBC para Power BI.
  • Um SQL warehouse.
  • Se estiver usando Power BI Desktop, é necessária a versão 2.151.1052.0 ou superior (lançamento de fevereiro de 2026).

Ativar o modo de compatibilidade com BI​

Ative o modo de compatibilidade com BI ao criar manualmente uma nova conexão com o Databricks no Power BI Desktop ou no serviço. A conexão com o Power BI deve usar o modo DirectQuery .

  1. No Power BI Desktop ou no serviço, crie uma nova conexão com o Databricks.
  2. Insira o nome do host do seu servidor Databricks e o caminho HTTP do seu data SQL warehouse .
  3. Em Opções Avançadas , defina Modede Compatibilidade BI da visualização de métricas como Ativado .
  4. Em Modo de conectividade de dados , selecione DirectQuery . O modo de importação não é suportado porque ignora o mecanismo de reescrita de consultas Databricks , necessário para a visualização de métricas.
  5. Conclua a configuração da conexão.

Para obter instruções detalhadas sobre como criar manualmente uma conexão Power BI , consulte o guia de conexões do Power BI Service ou Power BI Desktop.

Como funciona o modo de compatibilidade com BI​

As métricas aparecem como tabelas comuns no Power BI. Quando o modo de compatibilidade BI está ativado, Databricks reescreve as consultas geradas pelo Power BI para consultar corretamente a view de métricas.

O modo de compatibilidade com BI lida automaticamente com dois tipos de consultas:

  • Consultas de agregação : Ao arrastar uma medida para um campo de valor em um visual do Power BI, o Power BI gera uma consulta de agregação. O modo de compatibilidade BI reescreve essas agregações para que estejam em conformidade com as definições de medidas na sua view de métricas. Use sempre SUM como tipo de agregação para colunas de medidas no Power BI. O mecanismo SQL sempre aplica a lógica de medida subjacente correta.
  • Visualização prévia de dados e descoberta de esquema : quando Power BI solicita dados não agregados (por exemplo, dados de visualização ou pré-visualizações de colunas), as colunas de medida retornam valores nulos em vez de gerar um erro. As colunas de dimensão retornam seus valores normalmente.

Cenários suportados​

Os seguintes recursos Power BI funcionam conforme o esperado quando o modo de compatibilidade BI está ativado.

Cenário

Descrição

Visualização de medidas básicas

Arraste uma medida para um gráfico ou campo de valor de tabela para exibir os resultados agregados.

Filtros

Aplique filtros às colunas de dimensão ou medida em seus visuais.

Fatiadores dimensionais

Utilize colunas de dimensão como controles de segmentação para filtrar seu relatório.

Filtragem cruzada

Clique em um valor em um visual para filtrar visuais relacionados na mesma página.

Perfuração

Clique com o botão direito do mouse em pontos de dados para acessar uma página de detalhes filtrada por esse valor.

Filtragem TopN

Exibir os N valores superiores ou inferiores classificados por coluna.

Pré-visualização de dados

Utilize a visualização de dados e a descoberta de esquemas. As medidas aparecem como nulas nas pré-visualizações.

Cálculos visuais

Cálculos realizados no lado do cliente, aplicados a resultados já agregados (por exemplo, totais acumulados e classificação).

Dimensões versus medidas no Power BI​

A visualização de métricas contém dois tipos de colunas: medidas e dimensões. Compreender a diferença é importante ao criar relatórios no Power BI.

  • Medidas : A lógica de agregação de uma medida é definida na view de medidas (por exemplo, SUM(price * quantity) ou COUNT(DISTINCT customer_id)). No Power BI, deixe sempre a agregação definida como SUM para colunas de medidas. O mecanismo SQL aplica automaticamente a lógica de medida correta. Se você precisar de uma agregação diferente, modifique a definição da métrica na própria view de métricas. Não altere a agregação no Power BI.
  • Dimensões : As dimensões comportam-se como colunas de tabela comuns. Você pode aplicar qualquer operação Power BI às dimensões, incluindo agregações, agrupamentos, filtros, classificações e categorização, da mesma forma que faria com uma tabela comum. Se você tiver um campo numérico definido como uma dimensão (e não como uma medida), todos os tipos de agregação padrão do Power BI funcionarão normalmente nesse campo.

Melhores práticas​

  • Inclua sempre uma única view de métricas em seu conjunto de dados. A view métrica é a sua definição semântica.
  • Crie pastas para organizar as colunas de dimensão (por exemplo, uma pasta "Data" para cada coluna da dimensão Data).
  • Renomeie as dimensões para que tenham nomes mais fáceis de usar.
  • Alterar as colunas de dimensão numérica para "Não agregar" .
  • Crie "medidas de encapsulamento" com SUM() para cada coluna de medida e oculte as colunas de medida originais (por exemplo, Total Sales = SUM('Store Sales'[total_sales])).
  • Organize as medidas em uma pasta chamada "Medidas".
  • Utilize apenas essas medidas de encapsulamento em seus elementos visuais.

Limitações​

Devido às limitações do SDK do conector do Power BI, o modo de compatibilidade com BI tem controle limitado sobre como o Power BI gera e processa consultas.

Utilize a função SUM somente para agregações de medidas.​

No Power BI, deixe sempre o tipo de agregação definido como SUM para colunas de medidas. Todas as funções de agregação (SUM, COUNT, MIN, MAX) são reescritas para a definição da medida subjacente, então todas retornam o mesmo resultado. Selecionar um tipo de agregação diferente pode levar a comportamentos inesperados:

  • AVG mostra 1.0 porque Power BI calcula AVG como SUM / COUNT internamente, e ambos retornam o mesmo valor de medida.
  • Contagem (distinta), Desvio Padrão, Variância e Mediana geram padrões de consulta incompatíveis com o mecanismo de reescrita e produzem erros ou resultados incorretos.

Se você precisar de uma agregação diferente, modifique a definição da métrica na view de métricas. Todos os tipos de agregação são totalmente suportados nas definições view de métricas.

Totais gerais para medidas não aditivas​

O Power BI calcula os totais gerais reagregando os valores por grupo no lado do cliente, em vez de emitir uma consulta separada. Isso produz resultados corretos para medidas aditivas (por exemplo, SUM(revenue)) porque a reagregação local fornece a resposta correta.

Entretanto, para medidas não aditivas (por exemplo, SUM(revenue) / COUNT(DISTINCT customer), ou qualquer razão, percentagem ou expressão envolvendo DISTINCT), os totais gerais podem apresentar valores incorretos porque somar razões pré-agrupadas não é matematicamente equivalente a calcular a razão sobre o conjunto de dados completo.

Segmentadores quantitativos em colunas de medidas​

Um filtro quantitativo (de intervalo) em uma coluna de medida não funciona como esperado. As consultas do Power BI para MIN e MAX da medida para determinar o intervalo do controle deslizante são reescritas para o mesmo valor da medida subjacente, reduzindo o intervalo a um único ponto. Os filtros nas métricas ainda funcionam. Apenas os fatiadores de intervalo são afetados.

As medidas não podem ser usadas como valores categóricos ou dimensionais.​

Se você arrastar uma coluna de medida para um eixo, legenda ou segmentação de dados como um valor categórico, a consulta falhará com o seguinte erro:

Text
Measure columns cannot be used in GROUP BY clause or as categorical values. We recommend wrapping them with an aggregate function such as SUM() for the expected behavior.

Campos calculados com múltiplas medidas​

Os campos calculados que fazem referência a uma única medida funcionam corretamente porque o Power BI primeiro busca o resultado agregado e depois realiza o cálculo no lado do cliente (por exemplo, dividindo a receita em categorias baixa, média e alta).

No entanto, expressões que combinam várias colunas de medidas dentro de um único agregado (por exemplo, SUM(m1 + m2)) não são reescritas pelo modo de compatibilidade de BI e produzem erros ou resultados inesperados.

Unindo a visualização da tabela com outras tabelas.​

A visualização de métricas não pode ser combinada com outras tabelas no Power BI. Se precisar combinar dados de uma view de métricas com outra tabela, incorpore a join na própria definição view de métricas.

Visão materializada de Mesh​

A visualização de métricas com materializações não é suportada no modo de compatibilidade BI e pode produzir resultados inesperados.

Recursos adicionais​

On this page