Trabalhar com a exibição de consulta DAX

Use a exibição de consulta DAX no Power BI para exibir e trabalhar com consultas DAX (Expressões de Análise de Dados) em modelos semânticos.

Consultas do DAX

No Power BI, as fórmulas DAX definem diferentes tipos de cálculos para seus dados e também configuram a segurança de função. As consultas DAX retornam dados do modelo.

As consultas DAX são semelhantes às consultas SQL porque mostram dados que você já tem. As consultas DAX não criam itens no modelo ou visuais no relatório.

As consultas DAX têm duas partes principais:

Uma instrução EVALUATE, que é necessária. Ele especifica quais dados a consulta retorna e como ela é retornada.
Uma instrução DEFINE, que é opcional. Ele permite que você defina fórmulas DAX, como uma medida, a serem usadas na consulta. As medidas criadas ou atualizadas usando a consulta DAX DEFINE MEASURE são medidas com escopo de consulta DAX, em execução somente no contexto da consulta DAX. Você pode adicionar medidas de consulta DAX com escopo ao modelo usando ações de atualização do modelo do CodeLens ou o botão Atualizar modelo com alterações.

Saiba mais sobre como as consultas funcionam em consultas de DAX na referência DAX.

Abrir o modo de exibição de consulta DAX

No Power BI Desktop, selecione o ícone Visualização da Consulta DAX no lado esquerdo.

No serviço do Power BI ou no workspace do portal do Fabric, selecione Gravar consultas DAX no menu de contexto.

Na página de detalhes do modelo semântico do portal do Power BI ou do Portal do Fabric, selecione Gravar consultas DAX na parte superior da página.

Layout do modo de exibição de consulta DAX

Vamos dar uma olhada mais de perto no modo de exibição de consulta DAX no Power BI Desktop.

A exibição de consulta DAX tem estes elementos:

Faixa de Opções

A faixa de opções de exibição de consulta DAX tem ações comuns usadas ao escrever consultas DAX.

Vamos dar uma olhada mais de perto nos elementos na faixa de opções:

Formato

Selecione o botão Formatar faixa de opções ou use SHIFT+ALT+F para formatar a consulta atual. A consulta é recuada com guias. As funções DAX são alteradas para UPPERCASE e linhas extras são adicionadas. A formatação da consulta DAX é considerada uma prática recomendada e melhora a legibilidade da consulta DAX. A formatação também recuará de forma que você possa recolher e expandir seções da consulta.

Comentar e descomentar

Selecione o botão da faixa de opções Comentário para adicionar uma barra invertida dupla (//) ao início da linha onde está o cursor ou a todas as linhas selecionadas. Esta ação transforma as linhas em comentários. Quando a consulta DAX é executada, essas linhas são ignoradas.

Selecione o botão Descomentar da faixa de opções para remover // no início de qualquer linha em que o cursor esteja ou em todas as linhas selecionadas. Não funciona em linhas em que a notação de comentários de várias linhas é adicionada.

Você também pode usar CTRL+/ para alternar entre comentar e remover comentário.

Localizar e Substituir

Selecione o botão da faixa de opções Localizar ou use CTRL+F para pesquisar texto no editor de consultas DAX. Localizar inclui opções para corresponder a maiúsculas e minúsculas, corresponder a uma palavra inteira, usar uma expressão regular e percorrer todas as correspondências para a consulta atual. Você também pode selecionar a divisa à esquerda da caixa Localizar para inserir Substituir.

Selecione o botão Substituir na faixa de opções ou use CTRL+H para pesquisar e substituir texto no editor de consultas DAX. Substituir inclui opções para preservar a caixa e substituir uma de cada vez ou todas de uma vez.

Paleta de comandos

Selecione o botão da faixa de opções Paleta de comandos ou use CTRL+ALT+P para abrir a caixa da paleta de comandos. Você pode pesquisar mais ações do editor de consultas DAX e ver os atalhos de teclado associados.

Barra de comandos

A barra de comandos da exibição de consulta DAX inclui as ações mais importantes ao usar a exibição de consulta DAX.

Executar e cancelar

O botão Executar executa a consulta DAX ou as linhas selecionadas de uma consulta. O status de uma consulta após a execução é exibido na barra de status inferior.

Quando uma consulta está em execução, o botão se torna um botão Cancelar, que pode ser usado para interromper uma consulta em execução.

Atualizar o modelo com alterações

O botão Modelo de atualizações com alterações adiciona ou substitui medidas de modelo com as fórmulas DAX das medidas com escopo da consulta DAX. As medidas no escopo da consulta DAX são fórmulas DAX no bloco DEFINE MEASURE. Como alternativa, você pode optar por adicionar ou substituir medidas de modelo individualmente usando o texto CodeLens que aparece acima de cada uma delas.

Editor de consultas DAX

A visualização de consultas DAX inclui um editor de consultas DAX em que você pode escrever e editar consultas. É mais do que apenas uma barra de fórmulas DAX maior. Ele é mais poderoso e tem muitas semelhanças com o editor DAX disponível no Visual Studio Code.

O editor de consultas DAX tem os seguintes elementos:

Sugestões e Intellisense

Digite sua consulta e obtenha ajuda com sugestões e Intellisense durante a edição.

Use ENTER ou TAB para adicionar o intellisense realçado ou SHIFT+ENTER ou ALT+ENTER para ir para outra linha sem adicionar a opção intellisense. Selecionar ESC fecha qualquer uma das sobreposições.

Passar o mouse para exibir fórmulas de medida

Quando uma medida é incluída na consulta DAX, é possível focalizar nela para ver a fórmula, o nome e a descrição.

Selecione para ver ações rápidas de lâmpada de medida

A seleção em uma medida em uma instrução EVALUATE em uma consulta sem uma instrução DEFINE mostra a lâmpada de ações rápidas. Selecione Definir ou Definir com referências para criar uma instrução DEFINE com a fórmula dessa medida com ou sem as fórmulas DAX da medida de referência.

Atualizar medidas de modelo usando o CodeLens

Usar DEFINE MEASURE é útil ao criar medidas, permitindo primeiro que você as crie como medidas no escopo da consulta DAX. Você pode editar várias medidas em uma janela e, em seguida, executar a consulta para ver os resultados de todas ou apenas algumas delas com grupos específicos por colunas. Você não precisa criar um visual de tabela no modo de exibição Relatório e alternar entre fórmulas de medida. O CodeLens leva isso um passo adiante, fornecendo sugestões quando a medida já existe no modelo. Estes oferecem links rápidos para adicionar a medida ou substituir a medida no modelo.

CodeLens é o texto clicável que mostra acima um bloco DEFINE MEASURE. Para medidas com escopo de consulta DAX que ainda não estão presentes no modelo, o modelo de atualização: Adicionar nova medida CodeLens é exibido, o que adiciona a medida do modelo quando clicado. Para medidas com escopo de consulta DAX que já estão presentes no modelo e quando a fórmula DAX da medida com escopo é diferente, o Atualizar modelo: sobrescrever medida CodeLens é exibido. Isso altera a medida do modelo para esta fórmula DAX quando clicada.

Como alternativa, você pode adicionar ou substituir várias medidas ao mesmo tempo clicando no botão Modelo de atualização com alterações na barra de Comando.

Medir o fluxo de trabalho de atualização

As ações rápidas da lâmpada e o CodeLens podem ser usados juntos em um fluxo de trabalho completo:

No menu de contexto de uma medida, escolha consultas rápidas e, em seguida, Avalie para ter a consulta criada para você em uma nova guia Consulta.
Selecione a medida na consulta para Definir ou Definir com referências, adicionando a instrução DEFINE.
Faça atualizações de fórmula DAX para a medida e execute a consulta DAX para ver os resultados.
Quando a alteração aparecer conforme o esperado, use o modelo de Atualização codelens: substitua a medida para salvá-la de volta no modelo.

Aqui está uma maneira mais visual de entender o fluxo de trabalho:

Quadro de resultados

Quando uma consulta é executada, os resultados são mostrados na grade Resultados.

Se houver mais de uma instrução EVALUATE no editor de consultas, vários resultados poderão ser retornados. Você pode usar a lista suspensa Resultado para alternar entre eles. O botão Copiar copia toda a grade como uma tabela delimitada por tabulação com cabeçalhos. Redimensione a grade arrastando as setas de canto superior direito ou a borda entre a grade de resultados e o editor de consultas.

Se a consulta resultar em um erro, a grade de resultados a mostrará.

Um botão de cópia transfere o erro para sua área de transferência. O início do erro indica onde na consulta o erro está. Na imagem acima, o erro é: Query (4, 23) The value for 'Sales 2' can't be determined. Either the column doesn't exist, or there is no current row for this column.

E "Consulta (4, 23)" indica que o erro está na linha 4 e no caractere 23.

Guias de consulta

A exibição de consulta DAX pode ter várias guias de consulta, que podem ser renomeadas ou removidas. Elas também mostram o estado atual da consulta.

Cada guia inclui um indicador de status:

Nenhum indicador é exibido antes de executar a consulta.
Uma marca de seleção verde indica uma execução de consulta bem-sucedida.
Uma cruz vermelha indica que ocorreu um erro.
Um quadrado preenchido em um círculo indica que a consulta foi cancelada.
Um relógio indica que a consulta está em execução.

As consultas podem ser executadas em segundo plano, permitindo que você continue trabalhando em outras guias de consulta.

Salvar consultas DAX

As guias de consulta de exibição de consulta DAX são salvas no arquivo quando você salva no Power BI Desktop, para que você possa continuar de onde parou ao abrir o arquivo novamente. Se você usar o modo de desenvolvedor para salvar um projeto do Power BI, cada guia de consulta será incluída como um arquivo .dax na pasta DAXQueries da pasta de modelo semântico ou pasta de relatório se elas forem criadas em um relatório conectado ao vivo. Saiba mais na documentação do modo de desenvolvedor do Power BI.

Atualmente, você não pode exibir ou editar as consultas DAX adicionadas anteriormente no Power BI Desktop no serviço do Power BI. Os visualizadores do relatório ou modelo semântico não veem as consultas DAX salvas com o modelo semântico.

As guias de exibição de consulta DAX são descartadas de perto quando você Escrever consultas DAX do serviço do Power BI ou do portal do Fabric.

Painel de Dados

O painel Dados mostra os itens no modelo para ajudá-lo a escrever consultas. Os caminhos de edição para a maioria desses itens são bloqueados no modo de exibição de consulta.

Consultas rápidas

O menu de contexto do painel Dados inclui Consultas rápidas. Use consultas rápidas para criar consultas em uma nova guia de consulta para tabelas, colunas e medidas. Consultas rápidas são projetadas para aumentar a produtividade em tarefas comuns e são criadas de forma a poderem ser facilmente modificadas. Todas as consultas rápidas são criadas em uma nova guia de consulta e são executadas automaticamente.

Em qualquer lugar

Definir todas as medidas no modelo cria uma consulta com todas as fórmulas de medida mostradas em uma consulta. Pesquise todas as fórmulas de medida facilmente.
Definir nova medida cria uma consulta com um bloco de medida definida. Use isso para criar sua própria medida no modo de exibição de consulta DAX e, em seguida, adicione ao seu modelo quando estiver pronto.

Tabelas

Mostrar as 100 principais linhas cria uma consulta usando SELECTCOLUMNS() para mostrar as 100 principais linhas da tabela. As colunas são listadas em cada linha para permitir uma modificação fácil comentando linhas. Um ORDER BY também está incluído para especificar sua ordem de classificação.
Mostrar estatísticas de coluna cria uma consulta mostrando informações estatísticas para cada coluna em sua tabela. Confira outras fórmulas para agregação de colunas, como MIN, MAX, AVERAGE, COUNT e muito mais.
Definir todas as medidas nesta tabela cria uma consulta com as fórmulas de medida desta tabela mostradas em uma consulta.

Colunas

Mostrar a pré-visualização de dados cria uma consulta usando DISTINCT() para ver os valores de uma coluna.
Mostrar estatísticas de coluna cria uma consulta mostrando informações estatísticas para esta coluna específica. Confira outras fórmulas para agregação de coluna, como MIN, MAX, AVERAGE, COUNT e muito mais. A consulta retornada varia dependendo do tipo de dados da coluna, mostrando estatísticas diferentes para colunas numéricas, de texto e de data.

Medidas

Avaliar cria uma consulta para mostrar o resultado da medida. SUMMARIZECOLUMNS() é usado para que você possa adicionar qualquer grupo por colunas para mostrar a medida por grupos específicos, como País, Produto, etc.
Definir e avaliar cria uma consulta para mostrar o resultado da medida e mostrar a fórmula da medida em uma instrução DEFINE que pode ser modificada.
Definir com referências e avaliar cria uma consulta para mostrar o resultado da medida e mostrar não apenas a fórmula da medida em uma instrução DEFINE que pode ser modificada, mas também quaisquer outras medidas referenciadas na expressão de medida. Edite qualquer parte no contexto completo da medida.

Obtendo consultas DAX visuais do Performance Analyzer

Os visuais na exibição Relatório obtêm dados do modelo criando uma consulta DAX. Você pode exibir a consulta visual na vista de consulta DAX usando o Performance Analyzer. O Analisador de Desempenho fornece informações sobre por que um visual pode mostrar um valor inesperado ou permite que você inicie rapidamente uma consulta que pode ser alterada.

Na Visualização de relatório, vá para a faixa Optimize e selecione Performance Analyzer. Selecione Iniciar gravação e Atualizar recursos visuais. Na tabela a seguir, expanda um visual para ver as opções para copiar a consulta ou executá-la no modo de consulta DAX. Selecione Executar no modo de exibição de consulta DAX para adicionar a consulta visual como uma nova guia Consulta no modo de exibição de consulta DAX e executá-la.

Exibição de consulta DAX e conexão dinâmica no Power BI Desktop

O Power BI Desktop permite que você se conecte ao vivo a um modelo semântico publicado do Power BI selecionando Conectar quando você seleciona um modelo semântico no hub de dados do OneLake. O canto inferior direito do modo de exibição Relatório mostra o Live conectado ao modelo semântico do Power BI. Use a exibição de consulta DAX para gravar consultas DAX quando conectadas ao vivo.

Medidas de modelo

Quando conectado ao vivo a um modelo semântico publicado do Power BI, você não pode exibir ou editar medidas de modelo. As opções de consultas rápidas são limitadas a Avaliar.

Medidas de relatório

Quando conectado ao vivo a um modelo semântico publicado do Power BI, você pode criar medidas de relatório. Crie medidas de relatório usando a ação Nova medida no modo de exibição Relatório e Modelo . As medidas de relatório só estão disponíveis no relatório atual. Depois de criar uma medida de relatório, consultas rápidas no modo de exibição de consulta DAX mostra a opção Definir com referências e avaliar. As consultas DAX são executadas no modelo semântico, portanto, as medidas de relatório devem sempre ser convertidas em medidas com escopo de consulta DAX no bloco DEFINE MEASURE a ser executado, pois elas não existem no próprio modelo.

O modelo de atualização com o botão de alterações e as opções CodeLens para Atualizar modelo não estão disponíveis para medidas de relatório.

Visão de consulta DAX na Web

Use o modo de exibição de consultas DAX na web para escrever consultas DAX a partir de modelos semânticos publicados. A exibição de consulta DAX na Web oferece a mesma experiência que o Power BI Desktop, com algumas exceções.

O usuário pode editar modelos de dados no serviço do Power BI (versão prévia) Você precisa habilitar a configuração do workspace do Power BI para gravar consultas DAX. Saiba mais em Editar modelos de dados no serviço do Power BI.
As consultas DAX são descartadas no fechamento. Consultas DAX no Power BI Desktop são salvas no modelo, e um modelo semântico pode já ter consultas DAX salvas nele. A exibição de consulta DAX na Web não exibe consultas DAX salvas anteriormente no modelo semântico e as consultas criadas na Web não são mantidas depois que você fecha o navegador.
Gravar consultas DAX exige permissão de gravação no modelo semântico. Os visualizadores de workspace precisam usar o Power BI Desktop com uma conexão ao vivo com o modelo semântico para escrever consultas DAX.

Você não pode adicionar uma consulta DAX como um parâmetro usando ?query= após a URL para vincular à exibição de consulta DAX na Web.

Considerações e limitações

Considerações para ter em mente:

Mais de 500 linhas no editor de consultas DAX têm um atraso perceptível ao digitar.
As ações rápidas de lâmpada para medidas só são exibidas quando nenhuma DEFINE instrução está na guia de consulta.
A paleta de comandos mostra alguns comandos que ainda não funcionam.
A grade de resultados não mostra colunas e medidas com o formato especificado, como Moeda, Número inteiro com milhares etc.
A configuração inicial da integração do Git a partir do workspace não inclui consultas DAX salvas no modelo semântico publicado. Saiba mais em Integração do Git ao Fabric.

Limitações para ter em mente:

Máximo de 15 MB de dados por consulta. Depois que 15 MB forem excedidos, a linha atual é concluída, mas não são gravadas mais linhas.
Máximo de 1.000.000 valores por consulta. Se você consultar 20 colunas, poderá recuperar o máximo de 50.000 linhas (1 milhão dividido por 20).
Definir todas as medidas nesta tabela ou modelo não estará disponível quando houver mais de 500 medidas.
A execução de consultas DAX na Web tem outras limitações:
- No máximo 99.999 linhas são retornadas por consulta.
- Grave permissões no modelo semântico. Os visualizadores com permissão de build podem usar o Power BI Desktop para se conectar ao vivo e usar o modo de exibição de consulta DAX para executar consultas DAX.
- Disponível somente para modelos semânticos sem padrão. Você pode usar o Power BI Desktop para se conectar ao modelo semântico padrão e usar a exibição de consulta DAX para executar consultas DAX.
Observação

Até 30 de novembro de 2025, todos os modelos semânticos padrão do Power BI serão desconectados do item e se tornarão modelos semânticos independentes. Você pode retê-los se ainda os usar para relatórios ou painéis de controle, ou excluí-los com segurança se eles não forem mais necessários. Para obter mais informações, consulte Blog: Desassociando modelos semânticos padrão para itens existentes no Microsoft Fabric.
- Desde 5 de setembro de 2025, os modelos semânticos padrão do Power BI não são mais criados automaticamente quando um warehouse, lakehouse ou item espelhado é criado. Para obter mais informações, consulte Blog: Desativação de Modelos Semânticos Padrão.
- Se o item ainda não tiver um modelo semântico, você poderá criar um modelo semântico do Power BI.
- Para gravar consultas DAX, é necessário habilitar a configuração do workspace do Power BI do serviço do Power BI (versão prévia), permitindo que o usuário edite modelos de dados. Saiba mais em Editar modelos de dados no serviço do Power BI

Comentários

Esta página foi útil?

Last updated on 2025-09-29