参数

参数可以方便地存储和管理可重复使用的值。

借助参数，可以灵活地根据查询的值动态更改查询的输出，并可用于以下用途：

可以在“管理参数”窗口中轻松管理参数。 若要访问“管理参数”窗口，请在“主页”选项卡中选择“管理参数”中的“管理参数”选项。

Power Query 提供了两种简单的方法来创建参数：

在现有查询中：右键单击其值为简单非结构化常量（例如日期、文本或数字）的查询，然后选择“转换为参数”。

也可以右键单击参数并选择“转换为查询”，将参数转换为查询。

使用“管理参数”窗口：从“主页”选项卡的“管理参数”下拉菜单中选择“新建参数”选项，或启动“管理参数”窗口，然后选择顶部的“新建”以创建参数。 填写此表单，然后选择“确定”创建新参数。

创建参数后，始终可以返回到“管理参数”窗口，随时修改任何参数。

参数存储的值可用于 Power Query 中的转换。 除了参数的名称及其存储的值之外，还具有提供元数据的其他属性。 参数的属性包括：

名称：提供此参数的名称，以便于识别此参数并区别于其他可能创建的参数。

说明：显示参数信息时，参数名称旁边会显示说明，帮助指定参数值的用户了解其用途及语义。

必需：复选框指示后续用户是否可以指定是否必须提供参数值。

类型：指定参数的数据类型。 建议始终设置参数的数据类型。 若要详细了解数据类型的重要性，请转到数据类型。

建议值：向用户提供从可用选项中为”当前值“选择值的建议：

任何值：当前值可以是任何手动输入的值。

值列表：提供类似于表的简单体验，以便可以定义建议值列表，供以后从”当前值“中进行选择。 选择此选项后，将出现名为“默认值”的新选项。 此时，可以选择该参数的默认值，也就是在引用该参数时显示给用户的默认值。 该值当前值不同，后者是存储在参数内部的值，可以在转换中作为参数传递。 使用值列表提供显示在“默认值”和“当前值”字段中的下拉菜单，可以从建议的值列表中选择其中一个值。

注意

你仍然可以手动键入要传递给参数的任何值。 建议值列表只是简单的建议。

查询：使用列表查询（其输出为列表的查询）提供建议值列表，供以后为当前值选择这些值。

当前值：存储在此参数中的值。

参数的使用方式多种多样，但有两种情况比较常见：

在接下来的章节中，将介绍这两种情况的示例。

若要启用此功能，请先转到 Power Query 编辑器中的“视图”选项卡，然后选择“参数”组中的“始终允许”选项。

例如，以下订单表包含”OrderID“、”单位“和”利润率“字段。

在此示例中，创建一个新参数，名称为最小利润率，类型为小数，当前值为 0.2。

转到“订单”查询，然后在“利润率”字段中选择“大于”筛选器选项。

在“筛选行”窗口中，有一个包含所选字段数据类型的按钮。 从此按钮的下拉菜单中选择“参数”选项。 从数据类型按钮旁边的字段选择中，选择要传递给此参数的参数。 在本例中是”最小利润率“参数。

选择“确定”后，将使用参数的“当前值”筛选表。

如果将”最小利润率“参数的”当前值“修改为 0.3，则订单查询将立即更新，并且仅显示利润率高于 30% 的行。

提示

Power Query 中的许多转换都允许从下拉菜单中选择参数。 建议经常查找并利用参数所能提供的优势。

使用 Power Query，可以通过简单的单击从现有查询创建自定义函数。 在前面的示例中，右键单击“订单”查询并选择“创建函数”。 此操作将启动新的“创建函数”窗口。 在此窗口中，为新函数命名，它会告诉你查询中引用的参数。 这些参数用作自定义函数的参数。

可以随心所欲地为此新函数命名。 出于演示目的，此新函数的名称为 MyFunction。 选择“确定”后，将使用新函数的名称在“查询”窗格中创建一个新组。 在此组中，你将找到找到用于函数的参数、用于创建函数的查询以及函数本身。

若要测试此新函数，请在“最小利润率”标签下的字段中输入值（如 0.4）。 然后，选择”调用“按钮。 这将创建一个名为”调用函数“的新查询，从而有效地传递值 0.4 用作函数参数，并仅提供利润率高于 40% 的行。

若要详细了解如何创建自定义函数，请转到创建自定义函数。

多值参数或列表参数是一种仅在 Power Query Online 中可用的新型参数。 本部分将介绍如何创建新的列表参数，以及如何在查询中使用该参数。

在前面的示例中，将最小利润率的当前值从 0.3 更改为 0.1。 新目标是创建一个列表参数，该参数可以保存要分析的订单的订单号。 若要创建新参数，请转到“管理参数”对话框，然后选择“新建”创建新参数。 使用以下信息填写此新参数：

定义这些字段后，将弹出一个新网格，可在其中输入要为参数存储的值。 本例中这些值为 125、777 和 999。

注意

虽然此示例使用数字，但还可以将其他数据类型存储在列表中，例如文本、日期、日期时间等。 详情请见：Power Query 中的数据类型

提示

如果要更好地控制列表参数中使用的值，始终可以创建包含常量值的列表，并将列表查询转换为本文前面展示的参数。

新的“有趣的订单”列表参数准备好后，请返回“订单”查询。 选择 OrderID 字段的自动筛选菜单。 选择数字筛选器>”在“。

选择此选项后，将显示新的“筛选行”对话框。 在此处，可以从下拉菜单中选择列表参数。

注意

列表参数可以使用”在“或”不在“选项。 ”在“只允许按列表中的值进行筛选。 ”不在“恰恰相反，尝试筛选列以获取与参数中存储的值不相等的所有值。

选择“确定”后，将返回到查询。 在这里，查询已使用已创建的列表参数进行筛选，结果只保留了OrderID 等于 125、777 或 999 的记录。