Trabalhar com a visualização de consulta DAX

Use o modo de exibição de consulta DAX no Power BI para exibir e trabalhar com consultas DAX (Data Analysis Expressions) em modelos semânticos.

Consultas DAX

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

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

As consultas DAX têm duas partes principais:

Uma declaração AVALIAR, que é obrigatória. Ele especifica quais dados a consulta retorna e como ela é retornada.
Uma instrução DEFINE, que é opcional. Ele permite definir fórmulas DAX, como uma medida, para usar na consulta. As medidas criadas ou atualizadas usando a consulta DAX DEFINE MEASURE são medidas com escopo de consulta DAX, executadas somente no contexto da consulta DAX. Você pode adicionar medidas de escopo de consulta DAX ao modelo usando as ações do modelo de atualização do CodeLens ou o botão Atualizar modelo com alterações .

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

Abrir vista de consulta DAX

No Power BI Desktop, selecione o ícone Modo de Exibição de Consulta DAX no lado esquerdo.

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

Na página de detalhes do modelo semântico no serviço Power BI ou no portal Fabric, selecione Escrever consultas DAX na parte superior da página.

Layout do modo de exibição de consulta DAX

Vamos dar uma olhada mais detalhada na visualização de consultas DAX no Power BI Desktop.

O modo de exibição de consulta DAX tem estes elementos:

Friso

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 da faixa de opções ou use SHIFT+ALT+F para formatar a consulta atual. A consulta é indentada por guias. As funções DAX são alteradas para MAIÚSCULAS 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 recua de tal forma que você pode recolher e expandir seções da consulta.

Comentar e Descomentar

Selecione o botão Comentar da faixa de opções para adicionar duas barras invertidas (//) 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 Cancelar comentário da faixa de opções para remover // no início de qualquer linha onde esteja o cursor ou todas as linhas selecionadas. Não funciona em linhas onde é adicionada a notação de comentário multilinha.

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

Localizar e substituir

Selecione o botão Localizar faixa de opções ou use CTRL+F para procurar texto no editor de consultas DAX. Localizar inclui opções para diferenciar maiúsculas de minúsculas, corresponder a 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 procurar e substituir texto no editor de consultas DAX. Substituir inclui opções para preservar o gabinete e substituir um de cada vez ou todos 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 seus atalhos de teclado associados.

Barra de comando

A barra de comandos do modo de exibição de consulta DAX inclui as ações mais importantes ao usar o modo de 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 depois que ela é executada aparece 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 modelo com alterações

O botão Atualizar modelo com alterações adiciona ou substitui medidas de modelo com as fórmulas DAX das medidas com escopo de consulta DAX. As medidas com escopo de 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 do CodeLens que aparece acima de cada uma delas.

Editor de consultas DAX

O modo de exibição de consulta DAX inclui um editor de consultas onde você pode escrever e editar consultas. É mais do que apenas uma barra de fórmulas DAX maior. É 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 mover para outra linha sem adicionar a opção intellisense. Selecionar ESC fecha qualquer uma das sobreposições.

Passe o cursor para ver as fórmulas de medida

Quando uma medida é incluída na consulta DAX, você pode passar o mouse sobre ela para ver a fórmula, o nome e a descrição.

Selecione para ver ações rápidas de controle da lâmpada de medição

A seleção de 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 desta medida com ou sem as fórmulas DAX da medida de referência.

Atualizar medidas de modelo usando o CodeLens

O uso de DEFINE MEASURE é útil ao criar medidas, permitindo primeiro criá-las como medidas com escopo de 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. Não é necessário criar um visual de tabela no modo Relatório e alternar entre fórmulas de medida. O CodeLens leva isso um passo adiante, fornecendo prompts quando a medida já existe no modelo. Estes oferecem links rápidos para adicionar a medida ou sobrescrever a medida no modelo.

CodeLens é o texto clicável que aparece acima de um bloco "DEFINE MEASURE". Para medidas de consulta DAX que ainda não estão presentes no modelo, aparece o CodeLens Update model: Add new measure, que adiciona a medida ao 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 de DAX é diferente, o CodeLens Update model: Overwrite measure é exibido. Isso altera a medida do modelo para essa fórmula DAX quando clicado.

Como alternativa, você pode adicionar ou substituir várias medidas de uma só vez clicando no botão Atualizar modelo com alterações na barra de comandos .

Medir 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, Avaliar para que a consulta seja criada num novo separador de consulta.
Selecione a medida na consulta para Definir ou Definir com referências, adicionando a instrução DEFINI.
Faça atualizações de fórmulas DAX para a medida e, em seguida, execute a consulta DAX para ver os resultados.
Quando a alteração aparecer conforme o esperado, use o modelo de atualização CodeLens: Sobrescrever medida para salvá-la de volta ao modelo.

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

Grelha 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 do canto superior direito ou a borda entre a grade de resultados e o editor de consultas.

Se a consulta resultar num erro, a grelha de resultados mostra-o.

Um botão de cópia transfere o erro para a sua área de transferência. O início do erro indica onde está o erro na consulta. 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.

Separadores de consulta

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

Cada guia inclui um indicador de estado.

Nenhum indicador é exibido antes de executar a consulta.
Um visto 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.

Guardar consultas DAX

As abas da consulta DAX são guardadas no ficheiro quando guardas do Power BI Desktop, para poderes continuar de onde paraste ao abrir o ficheiro 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 do modelo semântico ou pasta de relatório se forem criadas em um relatório conectado ao vivo. Saiba mais na documentação do modo de desenvolvedor do Power BI.

Atualmente, não é possível 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 abas de exibição de consultas DAX são descartadas ao fechar quando escreve consultas DAX a partir do serviço Power BI ou do portal 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. As consultas rápidas são projetadas para ser um aumento de produtividade para tarefas comuns e criadas para que possam 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 facilmente todas as suas fórmulas de medida.
Definir nova medida cria uma consulta com um bloco de definição de medida. 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 primeiras linhas da tabela. As colunas são listadas em cada linha para facilitar a modificação, comentando as 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 da tabela. Veja muitas das fórmulas para saber como agregar 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 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 essa coluna específica. Veja muitas fórmulas para agregar a 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.

Medições

Avaliar cria uma consulta para mostrar o resultado da medida. SUMMARIZECOLUMNS() é usado para que você possa adicionar em 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 fórmula da medida. Edite qualquer parte no contexto completo da medida.

Obtendo consultas DAX visuais do Performance Analyzer

Os elementos visuais no modo 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 vista Relatório, aceda ao friso Otimizar e, em seguida, selecione Analisador de Desempenho. Selecione Iniciar gravação e, em seguida , Atualizar elementos visuais. Na tabela a seguir, expanda um visual para ver opções de copiar ou executar a consulta na visão 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 execute-a.

Modo de exibição de consulta DAX e conexão ao vivo 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 OneLake. O canto inferior direito da vista Relatório mostra Live connected to the Power BI semantic model. Use o modo de exibição de consulta DAX para escrever consultas DAX quando estiver conectado ao vivo.

Medidas-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 estã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 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, as consultas rápidas no modo de exibição de consulta DAX mostram 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 sempre devem ser convertidas em medidas com escopo de consulta DAX no bloco DEFINE MEASURE para serem executadas, porque elas não existem no próprio modelo.

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

Visualização de consulta DAX na Web

Use o modo de exibição de consulta DAX na Web para escrever consultas DAX a partir de modelos semânticos publicados. A vista 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 (visualização) Você precisa habilitar a configuração do espaço de trabalho do Power BI para escrever consultas DAX. Saiba mais em Editar modelos de dados no serviço do Power BI.
As consultas DAX são descartadas ao fechar. As consultas DAX no Power BI Desktop são salvas no modelo, e um modelo semântico pode ter consultas DAX já salvas no modelo. O modo de 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.
Escrever consultas DAX requer permissão de gravação no modelo semântico. Os visualizadores do espaço de trabalho precisam usar o Power BI Desktop com uma conexão ao vivo com o modelo semântico para escrever consultas DAX.

Não é possível adicionar uma consulta DAX como parâmetro usando ?query= após a URL para vincular à exibição de consulta DAX na Web.

Considerações e limitações

Considerações a ter em mente:

500+ linhas no editor de consultas DAX tem atraso percetível ao digitar.
As ações rápidas da lâmpada para medidas só são exibidas quando nenhuma instrução DEFINE está na guia de pesquisa.
A paleta de comandos mostra alguns comandos que ainda não funcionam.
A grade de resultados não mostra colunas e medidas com formato especificado, como Moeda, Número inteiro com milhares, etc.
A configuração inicial da integração Git no espaço de trabalho não inclui consultas DAX armazenadas no modelo semântico publicado. Saiba mais sobre a integração do Fabric Git.

Limitações a ter em conta:

Máximo de 15MB de dados por consulta. Quando 15MB é excedido, 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 no máximo 50.000 linhas (1 milhão dividido por 20).
Definir todas as medidas nesta tabela ou modelo não está disponível quando há mais de 500 medidas.
A execução de consultas DAX na Web tem outras limitações:
- Máximo de 99.999 linhas são retornadas por consulta.
- Permissão de gravação no modelo semântico. Os usuários com permissão de compilação podem usar o Power BI Desktop para se conectar em tempo real e usar a vista de consulta DAX para fazer consultas DAX.
- Disponível apenas para modelos semânticos não padrão. Você pode usar o Power BI Desktop para conectar-se em tempo real ao modelo semântico padrão e usar a vista de consultas DAX para executar consultas DAX.
Observação

Até 30 de novembro de 2025, todos os modelos semânticos padrão do Power BI são desconectados de seu item e se tornam modelos semânticos independentes. Você pode mantê-los se ainda os usar para relatórios ou painéis, ou excluí-los com segurança, se não forem mais necessários. Para obter mais informações, consulte Blog: Desacoplar modelos semânticos padrão para itens existentes nos 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 depósito, casa de lago ou item espelhado é criado. Para obter mais informações, consulte Blogue: Desativação dos Modelos Semânticos Padrão.
- Se o seu item ainda não tiver um modelo semântico, você poderá criar um modelo semântico do Power BI.
- O usuário pode editar modelos de dados na configuração do espaço de trabalho do Power BI (visualização) do serviço Power BI precisa ser habilitada para escrever consultas DAX. Saiba mais em Editar modelos de dados no serviço do Power BI

Feedback

Esta página foi útil?

Last updated on 2025-10-02