Trabalhar com o modo de exibição de consulta DAX

Com a exibição de consulta DAX no Power BI, você pode exibir e trabalhar com consultas DAX (Data Analysis Expressions) em modelos semânticos.

Consultas do DAX

No Power BI, as fórmulas DAX são usadas para definir diferentes tipos de cálculos para seus dados, mas também podem ser usadas para definir a segurança de função. As consultas DAX, por outro lado, podem ser usadas para retornar dados do modelo.

As consultas DAX são semelhantes às consultas SQL, pois podem mostrar 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. Ela especifica o que e como os dados são retornados na consulta.
• Uma instrução DEFINE, que é opcional. Isso permite que você defina fórmulas DAX, como por exemplo uma medida, a serem usadas na consulta. As medidas podem ser adicionadas ao modelo usando CodeLens quando usadas em DEFINE.

Para saber mais sobre como as consultas são usadas, confira as consultas 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.

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:

Formatar consulta

Selecione o botão da faixa de opções Formatar consulta 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 adicionais 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 remover comentário

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. Isso comenta as linhas e, quando a consulta DAX é executada, essas linhas são ignoradas.

Selecione o botão da faixa de opções Descomentar para remover // no início de qualquer linha onde o cursor esteja ou de 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 ações adicionais 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. 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.

Editor de consultas DAX

O modo de exibição de consulta DAX inclui um editor de consultas 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 VS 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 as ações rápidas de medir a lâmpada

Selecionar 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. 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 essa etapa adiante fornecendo prompts quando a medida já existe no modelo ou, se não existir, ele poderá adicioná-la.

Medir o fluxo de trabalho de atualização

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

1. 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.
2. Selecione a medida na consulta para Definir ou Definir com referências, adicionando a instrução DEFINE.
3. Faça atualizações de expressão na medida e execute a consulta DAX para mostrar a alteração.
4. Quando a alteração aparecer conforme o esperado, use o modelo de Atualização do CodeLens: substitua a medida para salvá-la de volta no modelo.

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

Grade 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. A grade pode ser redimensionada usando as setas de canto superior direito ou manualmente com o cursor na 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 é:

"Consulta (4, 23) O valor de "Vendas 2" não pode ser determinado. A coluna não existe ou não há nenhuma linha atual para esta coluna."

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 da execução de uma 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. Saiba mais na documentação do modo de desenvolvedor do Power BI.

Atualmente, você não pode exibir ou editar as consultas DAX 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.

Painel 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 aumentar a produtividade de tarefas comuns e são 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.

Anywhere

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.

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. A consulta visual pode ser exibida no modo de exibição de consulta DAX usando o Performance Analyzer. O Performance Analyzer pode fornecer informações sobre por que um visual pode estar mostrando um valor inesperado ou simplesmente como uma maneira de iniciar rapidamente uma consulta que você pode modificar ainda mais.

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 abaixo, expanda um visual para ver as opções para copiar a consulta ou executar no modo de exibição de consulta DAX. Selecionar Executar na visualização de consulta DAX pega a consulta visual, adiciona-a como uma nova guia Consulta na visualização de consulta DAX e, em seguida, executa-a.

Considerações e limitações

A exibição de consulta DAX está atualmente em versão prévia. Lembre-se:

• Modelo de atualização: a medida de substituição do CodeLens remove comentários na fórmula DAX.
• Modelo de atualização: as medidas de substituição do CodeLens não são mostradas apenas com alterações de formatação.
• Modelo de atualização: as medidas de substituição do CodeLens podem adicionar linhas quando há um erro de sintaxe.
• 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 instrução DEFINE está na guia consulta.
• A consulta de formato interrompe a função RANKX.
• A paleta de comandos mostra comandos que ainda não funcionam.
• As guias de consulta ainda não permitem a movimentação.
• A grade de resultados ainda não mostra colunas e medidas com o formato especificado, como Moeda, Número inteiro com milhares, etc.
• Baixar este arquivo do serviço do Power BI não incluirá as consultas DAX salvas no modelo semântico publicado.
• A configuração da integração inicial do Git do workspace não incluirá consultas DAX salvas no modelo semântico publicado. Saiba mais em Integração do Git ao Fabric.

E há algumas limitações para se ter em mente:

• Máximo de 15 MB de dados por consulta. Depois que 15 MB é excedido, a linha atual é concluída, mas nenhuma linha adicional é gravada.
• 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.

Conteúdo relacionado

• Consultas do DAX
• Trabalhar com a exibição de modelagem