Usando parâmetros

Um parâmetro serve como uma maneira de armazenar e gerenciar facilmente um valor que pode ser reutilizado.

Os parâmetros oferecem a flexibilidade de alterar dinamicamente a saída de suas consultas, dependendo de seu valor, e podem ser usados para:

• Alterar os valores de argumento para transformações específicas e funções de fonte de dados.
• Entradas em funções personalizadas.

Você pode facilmente gerenciar seus parâmetros dentro da janela Gerenciar parâmetros . Para acessar a janela Gerenciar parâmetros, selecione a opção Gerenciar parâmetros dentro de Gerenciar parâmetros na guia Página inicial.

Criando um parâmetro

O Power Query fornece duas formas fáceis de criar parâmetros:

• A partir de uma consulta existente: clique com o botão direito do rato numa consulta cujo valor é uma constante não estruturada simples, como uma data, texto ou número, e, em seguida, selecione Converter em Parâmetro.

  

  Você também pode converter um parâmetro em uma consulta clicando com o botão direito do mouse no parâmetro e selecionando Converter em consulta.

  

• Usando a janela Gerenciar parâmetros: selecione a opção Novo parâmetro no menu suspenso de Gerenciar parâmetros na guia Página inicial . Ou inicie a janela Gerenciar parâmetros e selecione Novo na parte superior para criar um parâmetro. Preencha este formulário e selecione OK para criar um novo parâmetro.

  

Depois de criar o parâmetro, você sempre pode voltar para a janela Gerenciar parâmetros para modificar qualquer um dos seus parâmetros a qualquer momento.

Propriedades do parâmetro

Um parâmetro armazena um valor que pode ser usado para transformações no Power Query. Além do nome do parâmetro e do valor que ele armazena, ele também tem outras propriedades que fornecem metadados para ele. As propriedades de um parâmetro são:

• Nome: forneça um nome para esse parâmetro que permita reconhecê-lo e diferenciá-lo facilmente de outros parâmetros que você possa criar.

• Descrição: A descrição é exibida ao lado do nome do parâmetro quando as informações do parâmetro são exibidas, ajudando os usuários que estão especificando o valor do parâmetro a entender sua finalidade e sua semântica.

• Obrigatório: A caixa de seleção indica se os usuários subsequentes podem especificar se um valor para o parâmetro deve ser fornecido.

• Type: Especifica o tipo de dados do parâmetro. Recomendamos que você sempre configure o tipo de dados do seu parâmetro. Para saber mais sobre a importância dos tipos de dados, vá para Tipos de dados.

• Valores sugeridos: fornece ao usuário sugestões para selecionar um valor para o valor atual nas opções disponíveis:

  • Qualquer valor: O valor atual pode ser qualquer valor inserido manualmente.

  • Lista de valores: fornece uma experiência simples semelhante a uma tabela para que você possa definir uma lista de valores sugeridos que você pode selecionar posteriormente para o Valor Atual. Quando essa opção for selecionada, uma nova opção chamada Valor Padrão será disponibilizada. A partir daqui, você pode selecionar qual deve ser o valor padrão para esse parâmetro, que é o valor padrão mostrado ao usuário ao fazer referência ao parâmetro. Esse valor não é o mesmo que o Valor Atual, que é o valor armazenado dentro do parâmetro e pode ser passado como um argumento em transformações. O uso da Lista de valores fornece um menu suspenso que é exibido nos campos Valor Padrão e Valor Atual, onde você pode escolher um dos valores da lista de valores sugerida.

    

    Nota

    Você ainda pode digitar manualmente qualquer valor que deseja passar para o parâmetro. A lista de valores sugeridos serve apenas como sugestões simples.

  • Consulta: usa uma consulta de lista (uma consulta cuja saída é uma lista) para fornecer a lista de valores sugeridos que você pode selecionar posteriormente para o Valor Atual.

    

• Valor atual: o valor armazenado neste parâmetro.

Onde usar os parâmetros

Um parâmetro pode ser usado de muitas maneiras diferentes, mas é mais comumente usado em dois cenários:

• Argumento da etapa: você pode usar um parâmetro como o argumento de várias transformações conduzidas a partir da interface do usuário (UI).
• Argumento de função personalizada: você pode criar uma nova função a partir de uma consulta e parâmetros de referência como os argumentos de sua função personalizada.

Nas próximas seções, você verá um exemplo para esses dois cenários.

Argumento da etapa

Para ativar esta funcionalidade, aceda primeiro ao separador Ver no editor do Power Query e selecione a opção Sempre permitir no grupo Parâmetros .

Por exemplo, a tabela Pedidos a seguir contém os campos ID do pedido, Unidades e Margem.

Neste exemplo, crie um novo parâmetro com o nome Margem Mínima com um tipo de Número Decimal e um Valor Atual de 0,2.

Vá para a consulta Pedidos e, no campo Margem , selecione a opção de filtro Maior que .

Na janela Filtrar Linhas, há um botão com um tipo de dados para o campo selecionado. Selecione a opção Parâmetro no menu suspenso para este botão. Na seleção de campo ao lado do botão de tipo de dados, selecione o parâmetro que você deseja passar para esse argumento. Neste caso, é o parâmetro Margem Mínima .

Depois de selecionar OK, a tabela é filtrada usando o Valor atual para o parâmetro.

Se você modificar o valor atual do parâmetro Margem mínima para 0,3, a consulta de pedidos será atualizada imediatamente e mostrará apenas as linhas em que a margem está acima de 30%.

Gorjeta

Muitas transformações no Power Query permitem-lhe selecionar o seu parâmetro a partir de uma lista pendente. Recomendamos que você sempre procure por ele e aproveite o que os parâmetros podem lhe oferecer.

Argumento de função personalizada

Com o Power Query, pode criar uma função personalizada a partir de uma consulta existente com um simples clique. Seguindo o exemplo anterior, clique com o botão direito do mouse na consulta Pedidos e selecione Criar função. Esta ação inicia uma nova janela Criar função . Nesta janela, nomeie sua nova função e ela informará os parâmetros que estão sendo referenciados em sua consulta. Esses parâmetros são usados como parâmetros para a função personalizada.

Você pode nomear essa nova função como quiser. Para fins de demonstração, o nome desta nova função é MyFunction. Depois de selecionar OK, um novo grupo é criado no painel Consultas usando o nome da nova função. Neste grupo, você encontrará os parâmetros que estão sendo usados para a função, a consulta que foi usada para criar a função e a própria função.

Para testar essa nova função, insira um valor, como 0,4, no campo abaixo do rótulo Margem mínima . Em seguida, selecione o botão Invocar . Isso cria uma nova consulta com o nome Função invocada, efetivamente passando o valor 0,4 para ser usado como argumento para a função e fornecendo apenas as linhas onde a margem está acima de 40%.

Para saber mais sobre como criar funções personalizadas, vá para Criar uma função personalizada.

Parâmetros de vários valores ou listas

Um novo tipo de parâmetro disponível apenas no Power Query Online é os parâmetros de vários valores ou de lista. Esta seção descreve como criar um novo parâmetro de lista e como usá-lo em suas consultas.

Seguindo o exemplo anterior, altere o valor atual para Margem Mínima de 0,3 para 0,1. O novo objetivo é criar um parâmetro de lista que possa conter os números de ordem dos pedidos que você está interessado em analisar. Para criar o novo parâmetro, vá para a caixa de diálogo Gerenciar parâmetros e selecione Novo para criar um novo parâmetro. Preencha este novo parâmetro com as seguintes informações:

• Designação: Interesting Orders
• Descrição: um conjunto de números de ordem que são interessantes para uma análise específica
• Obrigatório: Verdadeiro
• Tipo: Lista

Depois de definir esses campos, uma nova grade aparece onde você pode inserir os valores que deseja armazenar para seu parâmetro. Neste caso, esses valores são 125, 777 e 999.

Nota

Embora este exemplo use números, você também pode armazenar outros tipos de dados em sua lista, como texto, datas, datetime e muito mais. Para obter mais informações: Tipos de dados no Power Query

Gorjeta

Se você quiser ter mais controle sobre quais valores são usados em seu parâmetro list, você sempre pode criar uma lista com valores constantes e converter sua consulta de lista em um parâmetro, conforme mostrado anteriormente neste artigo.

Com os novos parâmetros da lista Pedidos interessantes em vigor, volte para a consulta Pedidos . Selecione o menu de filtro automático do campo OrderID . Selecione Filtros>de número em.

Depois de selecionar essa opção, uma nova caixa de diálogo Filtrar linhas é exibida. A partir daqui, você pode selecionar o parâmetro list em um menu suspenso.

Nota

Os parâmetros de lista podem funcionar com as opções In ou Not in . In permite filtrar apenas pelos valores da sua lista. Not in faz exatamente o oposto e tenta filtrar sua coluna para obter todos os valores que não são iguais aos valores armazenados em seu parâmetro.

Depois de selecionar OK, você será levado de volta à sua consulta. Lá, sua consulta foi filtrada usando o parâmetro list que você criou, com o resultado de que apenas as linhas em que o OrderID era igual a 125, 777 ou 999 foram mantidas.