Para criar parâmetros no Power Query, abra o Editor do Power Query e vá em Página Inicial > Gerenciar Parâmetros > Novo Parâmetro, defina um nome, um tipo de dado e um valor atual — depois é só referenciar esse parâmetro dentro dos passos da sua consulta (num filtro, num caminho de arquivo, numa condição) para poder trocar esse valor sem precisar editar a lógica da consulta.
Você já teve uma consulta no Power Query que precisava mudar um valor específico com frequência — o ano de referência de um relatório, o nome de uma pasta, um limite mínimo de venda para um filtro — e toda vez precisava entrar na etapa certa da consulta e editar manualmente aquele número ou texto direto no código?
Sem um parâmetro centralizando esse valor, cada mudança exige encontrar a etapa certa dentro da consulta (às vezes escondida no meio de várias transformações), editar o valor ali dentro, e torcer para não ter esquecido nenhuma outra etapa que também dependia do mesmo número — um processo lento e sujeito a erro, ainda mais se a mesma consulta usa esse valor em mais de um lugar.
Neste artigo iremos mostrar como criar parâmetros no Power Query e usá-los dentro de uma consulta, com um exemplo prático de filtro por ano que muda com um clique, sem precisar editar código nenhum depois de configurado.
Abrindo a janela de Gerenciar Parâmetros
Dentro do Editor do Power Query, vá até a guia Página Inicial e clique na seta abaixo de Gerenciar Parâmetros, escolhendo Novos Parâmetros. A janela Gerenciar Parâmetro se abre, e você clica em Novo para começar a preencher os campos do primeiro parâmetro.
Preenchendo os campos do parâmetro
Dê um Nome descritivo ao parâmetro (por exemplo, “AnoReferencia”), escolha o Tipo de Dados (Texto, Número Inteiro, Data, entre outros), e defina o Valor Atual — o valor que o parâmetro carrega até você decidir trocar. Também é possível marcar a opção de restringir os valores aceitos a uma Lista de valores sugeridos, transformando o parâmetro numa espécie de menu suspenso com opções pré-definidas, em vez de aceitar qualquer texto ou número livremente.
Exemplo prático: filtrando uma tabela por ano usando um parâmetro
Imagine uma consulta que traz um histórico de vendas com vários anos misturados, e você quer que o relatório mostre sempre só o ano de interesse, sem precisar editar o filtro manualmente cada vez que o ano de referência mudar.
| Ano | Vendas |
|---|---|
| 2023 | 145000 |
| 2024 | 178500 |
| 2025 | 203100 |
Crie o parâmetro “AnoReferencia” como Número Inteiro, com valor atual 2025. Depois, na consulta que tem a coluna Ano, use Página Inicial > Filtrar Linhas ou clique na seta do cabeçalho da coluna Ano, escolha Filtros de Número > Igual a, e em vez de digitar 2025 direto, clique no ícone dentro do campo de valor e escolha Parâmetro, selecionando “AnoReferencia” na lista. A partir daí, a etapa de filtro fica ligada ao parâmetro, em vez de a um número fixo digitado na consulta.
Trocando o valor do parâmetro depois
Depois de criado, o parâmetro aparece como uma consulta própria no painel Consultas e Conexões (com um ícone diferente das consultas normais). Para trocar o valor, basta abrir de novo Gerenciar Parâmetros, selecionar o parâmetro na lista, alterar o Valor Atual de 2025 para 2024, por exemplo, e clicar em OK. Ao atualizar a consulta, o filtro passa a considerar automaticamente o novo ano, sem precisar entrar na etapa de filtro e editar nada manualmente.
Usando parâmetros em caminhos de arquivo
Outro uso muito comum de parâmetros é guardar o caminho de uma pasta ou de um arquivo que a consulta acessa — por exemplo, quando a mesma planilha precisa rodar em máquinas diferentes, cada uma com o arquivo de origem salvo num caminho distinto. Criando um parâmetro do tipo Texto com o caminho da pasta, e referenciando esse parâmetro na etapa de origem da consulta (em vez do caminho fixo que o Power Query grava por padrão ao importar um arquivo), basta trocar o valor do parâmetro para a consulta inteira apontar para o novo local, sem precisar reconfigurar a conexão de dados do zero.
Parâmetro obrigatório e valor de campo Necessário
Ao criar ou editar um parâmetro, existe uma opção chamada Necessário, que impede a consulta de rodar caso o parâmetro fique sem valor definido — útil como proteção para evitar que alguém apague o valor atual e a consulta quebre silenciosamente numa próxima atualização.
Diferença entre parâmetro e simplesmente editar a consulta
Tecnicamente, seria possível sempre entrar direto na etapa da consulta e trocar o valor fixo ali dentro, sem usar um parâmetro. A vantagem de centralizar o valor num parâmetro é dupla: primeiro, se o mesmo valor for usado em mais de uma etapa (ou mais de uma consulta) da pasta de trabalho, trocar o parâmetro atualiza todos os lugares de uma vez, sem precisar caçar cada ocorrência manualmente; segundo, o parâmetro fica visível e organizado numa janela própria, sem exigir que quem for ajustar o valor entenda a lógica interna da consulta ou saiba onde exatamente aquele número está escondido no código M.
Disponibilidade
Parâmetros no Power Query estão disponíveis no Excel 2016 em diante, incluindo Excel 365, e no Power BI Desktop, onde o recurso é ainda mais usado (inclusive para trocar toda a fonte de dados de um relatório entre ambiente de teste e produção). No Excel para a Web o suporte é mais limitado. O Google Sheets não tem um recurso equivalente de parâmetros de consulta.
Perguntas frequentes
Onde o parâmetro criado no Power Query aparece depois?
Ele aparece como uma consulta própria dentro do painel Consultas e Conexões, com um ícone diferente das consultas normais de tabela, indicando que se trata de um valor de parâmetro, não de uma tabela de dados.
Preciso reescrever a consulta inteira para usar um parâmetro em vez de um valor fixo?
Não — basta ir na etapa específica que usa aquele valor fixo (um filtro, por exemplo) e, no campo de valor, trocar de um número ou texto digitado para a opção Parâmetro, escolhendo o parâmetro já criado. As demais etapas da consulta continuam do mesmo jeito.
Um parâmetro pode ter uma lista de opções em vez de aceitar qualquer valor?
Sim, ao criar ou editar o parâmetro existe a opção de restringir os valores aceitos a uma Lista de valores sugeridos, transformando o campo numa espécie de menu suspenso com opções pré-definidas.
Veja também: Linguagem M do Power Query: Como Escrever e Entender Fórmulas Avançadas e O Que É o Power Query no Excel e Como Começar a Usar.
Compartilhe ou Comente
Se você curtiu esse artigo aonde mostramos como criar parâmetros no Power Query para deixar suas consultas mais flexíveis, sem precisar editar código toda vez que um valor muda, compartilhe com as suas redes sociais e não se esqueça de deixar um comentário aqui embaixo caso você tenha ficado com alguma dúvida.
Você já teve que editar uma consulta inteira só para trocar um número ou um caminho de arquivo? Que tipo de valor você mais precisaria transformar em parâmetro no seu trabalho — um ano, um caminho de pasta, um limite de filtro? Conta para nós nos comentários!