Tutorial e domínio da linguagem M do Power Query

Este tutorial discutirá como implementar com sucesso um pedaço de código M e resolver erros comuns dentro do Editor do Power Query . Você também aprenderá como praticar e dominar efetivamente a linguagem M no Power Query .

Índice

• Implementação da linguagem M do Power Query
  • Parâmetro de localização do arquivo na linguagem M do Power Query
• Erros comuns na linguagem M do Power Query
  • 1. Referência cíclica
  • 2. Nome não reconhecido
  • 3. Cadeia de texto
  • 4. Digite o erro de incompatibilidade
  • 5. Nome não existe
  • 6. Símbolo Vírgula
  • 7. Identificador de Token
  • Outros erros na linguagem M do Power Query
• Domínio da linguagem M do Power Query
• Práticas recomendadas de linguagem M do Power Query
  • 1. Barra de fórmulas
  • 2. Biblioteca padrão
  • 3. Prática e Revisão
• Conclusão

Implementação da linguagem M do Power Query

O sucesso da implementação de um pedaço de código M depende de quão bem você pode resolver qualquer problema que encontrar. Neste tutorial, você aprenderá sobre os erros mais comuns ao tentar transferir o código M de outro arquivo PBIX ou ao tentar implementar um código M encontrado no fórum.

Mas, primeiro, se você tiver uma dúvida sobre o Power Query, é importante fornecer os dados junto com o arquivo PBIX, pois a resolução de um problema pode exigir uma alteração na configuração dos dados. A falha em fornecer os dados levará a um erro de fonte de dados por parte de quem está tentando fornecer suporte porque eles não têm acesso à fonte.

Há uma maneira de fornecer um arquivo separado, mas só é aplicável a amostras com 3.000 valores ou menos em colunas e linhas. Portanto, se sua tabela não exceder o limite de 3.000 células, você poderá copiá-la inteira e colá-la na janela Criar tabela usando a opção Inserir dados. Os dados serão transferidos para binário e serão incorporados no arquivo.

Parâmetro de localização do arquivo na linguagem M do Power Query

Outra maneira de ajudar a pessoa que está prestando suporte é incorporar um parâmetro de localização de arquivo. Assim, quando atualizarem o arquivo, todas as consultas nele serão restauradas. Para demonstrar isso, siga estas quatro etapas.

Primeiro, vá para o Windows Explorer e copie o caminho do arquivo.

Em segundo lugar, volte para o Editor do Power Query e selecione Gerenciar parâmetro. Em seguida, selecione Novo parâmetro e dê um nome ao parâmetro.

Em terceiro lugar, use nomes sem espaços ou caracteres especiais para evitar o uso da notação entre aspas ao se referir aos seus parâmetros. Defina o tipo como texto e os valores sugeridos como lista de valores . Ao passar o arquivo pelo fórum, você pode selecionar sua localização na lista de arquivos.

Por fim, abra a janela do Editor avançado e substitua o caminho do arquivo codificado pelo nome do parâmetro.

Erros comuns na linguagem M do Power Query

1. Referência cíclica

A expressão de erro abaixo ocorre quando a saída de uma consulta selecionada é passada para um argumento de função de uma etapa dentro da consulta. Neste exemplo, você pode ver que o nome da consulta é passado para a função Table.AddColumn em uma de suas etapas.

O primeiro argumento requer um tipo de tabela. Na maioria dos casos, você descobrirá que ele faz referência à etapa anterior em seu código. A etapa anterior pode ser encontrada no painel Etapas aplicadas, localizado no lado direito do painel de visualização.

Não é necessário referenciar a etapa anterior; você pode simplesmente passar outra referência de tabela para essa função. Portanto, no arquivo de origem, procure o nome da etapa no painel Etapas aplicadas para ver a forma da tabela que foi passada para a função. Isso pode ajudá-lo a traduzir a etapa para seu próprio arquivo.

2. Nome não reconhecido

Esse erro de expressão ocorre quando o nome de um argumento de tabela passado para uma função não existe ou foi digitado incorretamente.

Lembre-se de que o Power Query diferencia maiúsculas de minúsculas. Na maioria dos casos, ele fará referência à etapa anterior que você pode procurar no painel Etapas aplicadas. Mas, novamente, não é necessário.

Ao solucionar esse tipo de erro, observe a forma da tabela passada para a função no arquivo de origem e compare-a com seu próprio arquivo. Além disso, verifique se as etapas não foram renomeadas.

3. Cadeia de texto

Esse erro de expressão é um exemplo em que um argumento de tabela que foi passado para uma função foi, na verdade, passado como uma string de texto.

Os nomes de etapas que incluem espaços ou caracteres especiais precisam ter o hash de notação entre aspas ou o sinal de libra na frente. Os nomes devem ser colocados entre aspas duplas. Ao copiar e colar os nomes das etapas, certifique-se sempre de selecionar o nome completo.

4. Digite o erro de incompatibilidade

Outro erro de expressão comum é o erro de incompatibilidade de tipo.

Esses tipos de erros tendem a aparecer quando você começa a fazer modificações no código M. Na mensagem de erro acima, um valor de data e hora foi passado para uma função que exigia um tipo de dados de data.

A solução para esse erro é converter o tipo de dado do valor antes de passá-lo como argumento para outra função. Nesse caso, você pode usar a função Date.From para converter o valor de data e hora em um valor de data.

Existem muitos tipos de erros de incompatibilidade. Seja qual for o caso, o sistema sempre indicará o tipo de dado necessário.

5. Nome não existe

Outro erro de expressão comum é quando o nome de uma referência de coluna, passado como um argumento para uma função, não existe ou está escrito incorretamente.

Certifique-se de que os nomes das colunas correspondam. Você também pode tentar alterar a referência da coluna. Se os nomes das colunas corresponderem e você ainda receber o erro, verifique se há espaços ou caracteres especiais no nome.

6. Símbolo Vírgula

Este é um erro de sintaxe de expressão sobre Token Comma.

Assim como cada função recebe uma lista separada por vírgulas de argumentos de função, a expressão let recebe uma lista separada por vírgulas dos nomes e valores das variáveis. Para resolver esse tipo de erro, certifique-se de que cada etapa, exceto a etapa final, tenha uma vírgula no final. Esse erro também pode ser gerado pela falta de parênteses ou colchetes no final de uma função.

7. Identificador de Token

O erro Token Identifier Expected geralmente ocorre quando o código M é copiado porque as aspas ficam confusas.

Para corrigir o erro, você deve localizar e substituir todos os sinais de aspas. Você também pode usar um aplicativo chamado Visual Studio Code, que pode ser baixado gratuitamente em code.visualstudio.com .

Outros erros na linguagem M do Power Query

Aqui estão outros erros que você provavelmente encontrará ao implementar o código M do fórum.

• Token Literal Expected – isso significa que a próxima coisa na fórmula deve ser um valor, coluna ou função.
• Token RightParen Expected – isso significa que um colchete ou parêntese é esperado para fechar a fórmula
• A vírgula não pode preceder um parêntese direito – isso significa que uma vírgula não pode estar diretamente na frente de um parêntese ou colchete de fechamento.
• Literal inválido – geralmente ocorre quando uma string de texto não foi fechada com aspas duplas.
• Token EoF esperado – ocorre quando uma palavra-chave ou nome de função inválido é usado.

Domínio da linguagem M do Power Query

O domínio requer compromisso e investimento de longo prazo. É tudo sobre fazer, se inspirar, praticar e repetir. Mas mesmo sem maestria, você pode alcançar melhorias surpreendentes em um período de tempo relativamente curto.

Se você entender e for capaz de colocar em prática os conceitos abordados nestes posts, saberá como lidar com os erros quando eles ocorrerem. Você também poderá brincar com parâmetros de função, como substituir valores codificados por valores dinâmicos ou escrever funções M personalizadas.

Tudo o que você precisa fazer é começar a explorar por conta própria. Você aprenderá mais ao permitir-se cometer erros e, então, encontrar várias maneiras de resolvê-los. Isso pode ser demorado, mas também é muito gratificante. Uma vez que você é capaz de fazer isso, você pode aprimorar sua habilidade.

Práticas recomendadas de linguagem M do Power Query

1. Barra de fórmulas

Uma das práticas recomendadas gerais sobre como você pode expandir seu conhecimento sobre o Power Query é garantir que a barra de fórmulas esteja sempre visível. Você pode explorar a especificação de linguagem de fórmula que descreve a estrutura da linguagem e revisitá-la depois de praticar por algum tempo.

Você pode fazer uma caça ao tesouro através da referência de fórmula online, que lista todas as funções e suas especificações. Você pode lê-los, copiar os exemplos na janela do Editor avançado e estudar os resultados.

2. Biblioteca padrão

Outra prática recomendada é explorar a biblioteca padrão usando a palavra-chave #shared porque há diferenças em comparação com a referência de fórmula online. Você também pode fazer uma pesquisa na web para outros conteúdos, como exemplos práticos ou problemas que outras pessoas encontraram.

Isso geralmente é chamado de Learn by Googling. Você pode procurar um nome de função ou um tipo de operação ou transformação, mas os resultados dependerão muito de quão bem você definiu os critérios de pesquisa e de como outros descreveram seus casos.

3. Prática e Revisão

O mais importante é praticar e deliberadamente passar mais tempo dentro do Query Editor. Além disso, encontre um melhor equilíbrio entre a quantidade de tempo que você gasta aprendendo DAX, visualizações de dados e código M.

Você também pode revisar seu trabalho anterior e incorporar essas práticas recomendadas. Participe de atividades como da LuckyTemplates e . Desenvolva isso respondendo a perguntas no fórum para aprofundar sua compreensão e solidificar seu conhecimento.

Sempre haverá mais para aprender e descobrir. Portanto, estabeleça uma meta que você possa alcançar, como dedicar 30 minutos por dia ao seu próprio estudo.

Práticas recomendadas para transformação de dados no editor de consultas
Práticas recomendadas de transformação e carregamento de dados

Conclusão

Implementar M em seu código requer prática e domínio. Podem ocorrer erros se uma variável, função ou qualquer outra entidade for usada incorretamente. Depois que M for usado corretamente, seu relatório de dados fornecerá resultados valiosos e perspicazes.

melissa