Usando parâmetrosUsing parameters

Um parâmetro serve como uma maneira de armazenar e gerenciar facilmente um valor que pode ser reutilizado.A parameter serves as a way to easily store and manage a value that can be reused.

Os parâmetros oferecem a flexibilidade para alterar dinamicamente a saída de suas consultas, dependendo de seu valor, e podem ser usadas para:Parameters give you the flexibility to dynamically change the output of your queries depending on their value, and can be used for:

  • Alterando os valores de argumento para as funções de transformações e fontes de dados específicasChanging the argument values for particular transforms and data source functions
  • Entradas em funções personalizadasInputs in custom functions

Você pode gerenciar facilmente seus parâmetros na janela gerenciar parâmetros .You can easily manage your parameters inside the Manage Parameters window. Você pode acessar a janela gerenciar parâmetros selecionando a opção gerenciar parâmetros dentro de gerenciar parâmetros na guia início .You can get to the Manage Parameters window by selecting the Manage Parameters option inside Manage Parameters in the Home tab.

Janela Gerenciar parâmetros

Criando um parâmetroCreating a parameter

Power Query fornece duas maneiras fáceis de criar parâmetros:Power Query provides two easy ways to create parameters:

  • De uma consulta existente — Você pode facilmente clicar com o botão direito do mouse em uma consulta cujo valor é uma constante não estruturada simples, como, mas não se limitando a, uma data, texto ou número, e selecionando converter em parâmetro.From an existing query—You can easily right-click a query whose value is a simple non-structured constant such as, but not limited to, a date, text, or number, and select Convert to Parameter.

    Converter em parâmetro

    Observação

    Você também pode converter um parâmetro em uma consulta clicando com o botão direito do mouse no parâmetro e, em seguida, selecionando converter em consulta , conforme mostrado na imagem a seguir.You can also convert a parameter to a query by right-clicking the parameter and then selecting Convert To Query , as shown in the following image.

    Converter em consulta

  • Usando a janela — gerenciar parâmetros Você pode selecionar a opção novo parâmetro no menu suspenso de gerenciar parâmetros na guia página inicial ou pode iniciar a janela gerenciar parâmetros e selecionar no botão novo na parte superior para criar um parâmetro.Using the Manage Parameters window—You can select the New Parameter option from the dropdown menu of Manage Parameters in the Home tab, or you can launch the Manage Parameters window and select in the New button on the top to create a parameter. Você pode preencher esse formulário e selecionar OK para criar um novo parâmetro.You can fill in this form and select OK to create a new parameter.

    Criar um parâmetro na janela Gerenciar parâmetros

Depois de criar o parâmetro, você sempre pode voltar para a janela gerenciar parâmetros para modificar qualquer um dos parâmetros a qualquer momento.After creating the parameter, you can always go back to the Manage Parameters window to modify any of your parameters at any moment.

Propriedades do parâmetroParameter properties

Um parâmetro armazena um valor que pode ser usado para transformações em Power Query.A parameter stores a value that can be used for transformations in Power Query. Além do nome do parâmetro e do valor que ele armazena, ele também tem outras propriedades que fornecem metadados a ele.Apart from the name of the parameter and the value that it stores, it also has other properties that provide metadata to it. As propriedades de um parâmetro são as seguintes.The properties of a parameter are as follows.

  • Nome — do Forneça um nome para esse parâmetro que permita reconhecê-lo e diferenciá-lo facilmente de outros parâmetros que você possa criar.Name—Provide a name for this parameter that lets you easily recognize and differentiate it from other parameters you might create.

  • Descrição — do 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 para entender sua finalidade e sua semântica.Description—The description is displayed next to the parameter name when parameter information is displayed, helping users who are specifying the parameter value to understand its purpose and its semantics.

  • Necessário — A caixa de seleção indica se os usuários subsequentes podem especificar se um valor para o parâmetro deve ser fornecido.Required—The checkbox indicates whether subsequent users can specify whether a value for the parameter must be provided.

  • Tipo — de Recomendamos que você sempre configure o tipo de dados do parâmetro.Type—We recommended that you always set up the data type of your parameter. Você pode saber mais sobre a importância dos tipos de dados no artigo tipos de dados .You can learn more about the importance of data types from the Data types article.

  • Valores — sugeridos Fornece ao usuário sugestões para selecionar um valor para o valor atual das opções disponíveis:Suggested Values—Provides the user with suggestions to select a value for the Current Value from the available options:

    • Qualquer valor — O valor atual pode ser qualquer valor inserido manualmente.Any value—The current value can be any manually entered value.

    • Lista de valores — Fornece uma experiência simples semelhante a tabela, para que você possa definir uma lista de valores sugeridos que você pode selecionar posteriormente para o valor atual.List of values—Provides you with a simple table-like experience so you can define a list of suggested values that you can later select from for the Current Value. Quando essa opção é selecionada, uma nova opção chamada valor padrão será disponibilizada.When this option is selected, a new option called Default Value will be made available. Aqui, você pode selecionar o que deve ser o valor padrão para esse parâmetro, que será o valor padrão mostrado ao usuário ao referenciar o parâmetro.From here you can select what should be the default value for this parameter, which will be the default value shown to the user when referencing the parameter. 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.This value isn't the same as the Current Value , which is the value that's stored inside the parameter and can be passed as an argument in transformations. O uso da lista de valores permitirá que um menu suspenso seja exibido nos campos valor padrão e valor atual , em que é possível escolher um dos valores da lista de valores sugerida.Using the List of values will enable a drop-down menu to be displayed in the Default Value and Current Value fields, where you can pick one of the values from the suggested list of values.

      Parâmetro com uma lista sugerida de valores

      Observação

      Você ainda pode digitar manualmente qualquer valor que deseja passar para o parâmetro.You can still manually type any value that you want to pass to the parameter. A lista de valores sugeridos serve apenas como sugestões simples.The list of suggested values only serves as simple suggestions.

    • Consulta — do Usa uma consulta de lista (uma consulta cuja saída é uma lista) para fornecer a lista de valores sugeridos que você pode selecionar mais tarde para o valor atual.Query—Uses a list query (a query whose output is a list) to provide the list of suggested values that you can later select for the Current Value.

      Parâmetro com consulta de lista

  • Valor atual — O valor que será armazenado nesse parâmetro.Current Value—The value that will be stored in this parameter.

Onde usar parâmetrosWhere to use parameters

Um parâmetro pode ser usado de várias maneiras diferentes, mas é mais comumente usado em dois cenários:A parameter can be used in many different ways, but it's more commonly used in two scenarios:

  • Argumento Step — Você pode usar um parâmetro como o argumento de várias transformações controladas a partir da interface do usuário.Step argument—You can use a parameter as the argument of multiple transformations driven from the user interface (UI).
  • Argumento de função personalizada — Você pode criar uma nova função de uma consulta e parâmetros de referência como os argumentos de sua função personalizada.Custom Function argument—You can create a new function from a query and reference parameters as the arguments of your custom function.

Nas próximas seções, você verá um exemplo para esses dois cenários.In the next sections, you'll see an example for these two scenarios.

Argumento StepStep argument

Para habilitar esse recurso, primeiro vá para a guia Exibir no Editor de Power Query e habilite a opção sempre permitir no grupo parâmetros .To enable this feature, first go to the View tab in the Power Query Editor and enable the Always allow option in the Parameters group.

Sempre permitir parâmetros

Observação

Este recurso não está disponível no momento no Power Query online.This feature is currently not available in Power Query Online.

Para fins de exemplo, você pode ver a consulta de pedidos a seguir com os campos OrderID , Units e Margin.For example purposes, you can see the following Orders query with the fields OrderID , Units , and Margin.

Tabela de exemplo para pedidos com margem

Você pode criar um novo parâmetro com o nome margem mínima com um tipo de número decimal e um valor atual de 0,2, conforme mostrado na próxima imagem.You can create a new parameter with the name Minimum Margin with a Decimal Number type and a Current Value of 0.2, as shown in the next image.

Parâmetro de exemplo

Você pode ir para a consulta pedidos e, no campo margem , selecionar a opção de filtro maior que .You can go to the Orders query, and in the Margin field select the Greater Than filter option.

Opção maior que o de filtro para o campo de margem

Na janela filtrar linhas , você verá um botão com um tipo de dados para o campo selecionado.In the Filter Rows window, you'll see a button with a data type for the field selected. Você pode selecionar a opção de parâmetro no menu suspenso deste botão.You can select the Parameter option from the dropdown menu for this button. Na seleção de campo, ao lado do botão tipo de dados, você pode selecionar o parâmetro que deseja passar para esse argumento.From the field selection right next to the data type button, you can select the parameter that you want to pass to this argument. Nesse caso, é o parâmetro de margem mínimo .In this case, it's the Minimum Margin parameter.

Selecionar parâmetro para o argumento de transformação

Depois de selecionar OK , você pode ver que sua tabela foi filtrada usando o valor atual para seu parâmetro.After you select OK , you can see that your table has been filtered using the Current Value for your parameter.

Parâmetro de exemplo usado como um argumento de transformação

Se você modificar o valor atual do parâmetro de margem mínima como 0,3, poderá ver imediatamente como a consulta Orders é atualizada e mostrará apenas as linhas nas quais a margem está acima de 30%.If you modify the Current Value of your Minimum Margin parameter to be 0.3, you can immediately see how your orders query gets updated and shows you only the rows where the Margin is above 30%.

Valor atual atualizado para o parâmetro

Dica

Várias transformações no Power Query oferecem essa experiência em que você pode selecionar seu parâmetro em uma lista suspensa.Multiple transformations in Power Query offer this experience where you can select your parameter from a dropdown. Portanto, recomendamos que você sempre procure e aproveite os parâmetros que podem oferecer a você.So we recommend that you always look for it and take advantage of what parameters can offer you.

Argumento de função personalizadaCustom function argument

Com Power Query, você pode criar uma função personalizada de uma consulta existente com um simples clique.With Power Query, you can create a custom function from an existing query with a simple click. Seguindo o exemplo anterior, você pode clicar com o botão direito do mouse na consulta pedidos e selecionar criar função , que iniciará uma nova janela criar função .Following the previous example, you can right-click the Orders query and select Create Function , which will launch a new Create Function window. Nessa janela, você pode nomear sua nova função e ele informará os parâmetros que estão sendo referenciados em sua consulta.In this window, you can name your new function and it will tell you the parameters being referenced in your query. Esses parâmetros serão usados como os parâmetros para a função personalizada.These parameters will be used as the parameters for the custom function.

Criar função

Você pode nomear essa nova função no entanto que desejar.You can name this new function however you want. Para fins de demonstração, o nome dessa nova função será MyFunction.For demonstration purposes, the name of this new function will be MyFunction. Depois de selecionar OK , um novo grupo será criado no painel consultas usando o nome da sua nova função.After you select OK , a new group will be created in the Queries pane using the name of your new function. Nesse 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.In this group, you'll find the parameters being used for the function, the query that was used to create the function, and the function itself.

Função criada

Você pode testar essa nova função inserindo um valor, como 0,4, no campo abaixo do rótulo de margem mínima .You can test this new function by entering a value, such as 0.4, in the field underneath the Minimum Margin label. Em seguida, selecione o botão invocar .Then select the Invoke button. Isso criará uma nova consulta com o nome chamado função , passando efetivamente o valor 0,4 a ser usado como o argumento para a função e dando a você apenas as linhas em que a margem está acima de 40%.This will create a new query with the name Invoked Function , effectively passing the value 0.4 to be used as the argument for the function and giving you only the rows where the margin is above 40%.

Função invocada com o valor 0,4

Você pode aprender mais sobre como criar funções personalizadas do artigo criando uma função personalizada.You can learn more about how to create custom functions from the article Creating a custom function.