借助参数，您可以与用户提供的数据进行交互。例如，您可以创建包含使用报告的用户输入的计算字段，或将值传递回数据源使用的 SQL 查询。使用参数可以增强报告的互动性。您还可以使用参数创建报告模板。
参数的运作方式
参数的行为与编程语言中的变量类似。参数有 3 种主要用途：
- 您可以在计算字段中使用参数，以根据用户输入显示结果。
- 您可以将参数传回到 BigQuery 数据源中的自定义 SQL 查询。
- 您可以将参数传递回社区连接器。
参数可以从以下位置获取数据：
- 从为参数定义的默认值中获取。
- 通过组件属性面板。
- 通过在报告中放置的控件。
- 通过指向报告的链接。
您可以在报告和数据源编辑器中字段列表的底部找到参数。参数显示为紫色字段。
参数如何在报告中共享您的数据
报告和数据源的编辑者可以访问由参数控制的任何数据。借助参数，报告编辑者可以请求与默认值不同的数据。
在为数据源启用参数之前，请务必了解更改参数值可能会对报告中的数据产生怎样的影响。某些参数可能只会返回相对“安全”的数据，例如新语言区域的天气。不过，其他参数可能会允许用户请求全新的数据集。
例如，账号参数或数据库表的名称可能会返回您不打算分享的数据，或者返回不同的架构，这可能会与报告中的现有图表不兼容。
创建参数
您可以在以下位置创建参数：
在数据源中
- 修改数据源。
- 点击右上角的添加参数。 您还可以在修改报告时创建参数，方法是选择一个组件，然后点击右下角的添加参数。请务必根据所需的数据源选择组件。
- 配置参数的选项和默认值（请参见下文）。
修改报告时，您可以使用数据面板中的 + 添加参数链接，在所选数据源中创建参数。
在 BigQuery 连接器中
您可以将参数传递给 BigQuery 连接器中的自定义 SQL 查询。BigQuery 连接器定义了多个标准参数，用于传递报告的开始日期和结束日期，以及用户的电子邮件地址（如果有）。您还可以传递自定义参数。了解详情。
参数和社区连接器
社区连接器可以包含可替换参数，让报告编辑者能够修改数据源中的默认值。如果您可以修改使用社区连接器构建的数据源的连接，则可以指定报告编辑者可以更改哪些参数：
- 修改数据源。
- 点击左上角的修改关联。
- 如果连接器提供了可修改的参数，这些参数会显示在页面底部。允许您定义自定义参数的连接器会在页面上显示相关说明。
- 使用允许在报告中修改“<参数名称>”复选框，允许或禁止在报告中修改参数。
- 点击右上角的重新连接。
通过社区连接器创建数据源后，对该连接器中参数所做的更改不会自动显示在数据源中。您需要重新连接数据源，才能查看任何新增、移除或更改的参数
修改现有参数
如需更改现有参数的配置，请执行以下操作：
- 修改包含该参数的数据源。
- 在字段列表中找到相应参数。
- 点击参数名称右侧的 @ 符号。
- 进行所需更改，然后点击右下角的保存。
配置参数
您可以使用这些选项在数据源中配置参数。如需了解 BigQuery 连接器和社区连接器参数，请参阅上述文章。
参数名称：您会在报告和数据源的字段列表中看到此名称。这也是您在计算字段中引用参数时使用的名称。
参数 ID：默认设置。参数 ID 由 Looker Studio 在内部用于标识参数。报告查看者不会看到该信息。
数据类型：参数可以存储文本、数字或布尔值 (true/false)。
允许的值：指定用户可以输入的值。
如需指定值列表，请选择该选项，然后输入可接受的值以及可选的显示名称。点击添加选项，将更多内容添加到列表中。
如需指定允许的值范围，请输入该范围的最小值和最大值。
默认值：为参数指定起始值。
设置参数值
您可以通过以下方式设置参数的值：
为参数设置默认值
您可以在创建参数时为其设置默认值。如需调整默认值，请按照上述步骤修改该参数。
使用控件从用户获取输入
控件是供用户与报告互动的组件。如需在参数中存储用户输入，请将该参数添加到控件的 Control 字段属性：
- 修改报告。
- 点击顶部的
添加控件。 - 选择要添加的控件类型。
- 在属性面板中，选择设置标签页。
- 将该参数添加到“控制”字段。
详细了解控件。
替换组件中的默认参数值
您可以通过修改报告中的各个组件来替换参数的默认值：
- 修改报告。
- 根据包含参数的数据源选择组件。
- 在组件的“数据”标签页底部，修改默认参数值。
您还可以在报告级别和网页级别修改参数：
- 修改报告。
- 依次选择 File > Report Settings 或 Page > Current Page Settings。
- 修改参数值。
参数继承
参数的继承规则与过滤条件属性相同。具体而言，优先级较高的组件上的参数会替换优先级较低的组件上的参数。优先级顺序（从低到高）如下：
- 数据源（默认）
- 报告
- 页面
- 群组
- 单个图表或控件
通过报告链接修改参数
通过报告的网址设置参数可让开发者和高级用户构建可通过编程方式配置的报告。
Looker Studio 报告参数及其对应的值会作为网址编码的 JSON 字符串传入，并使用“params”查询参数附加到报告网址。
如需了解详情，请参阅开发者指南。
管理报告网址参数
默认情况下，您无法通过报告网址修改报告中的参数。
如需选择报告用户可以修改哪些参数，请执行以下操作：
- 修改报告。
- 依次选择资源 > 管理 报告网址参数。
- 在允许通过报告网址进行设置列中，选中要允许的参数。
此页面还会显示每个参数的网址参数。这是您在构建编码的参数对象时要使用的名称，而不是参数名称。您可以点击修改铅笔图标来修改此名称。报告中的每个网址参数都必须是唯一的。
修改网址参数名称对参数在报告中的使用方式没有影响。
使用参数
创建参数后，您可以在计算字段和报告组件中使用参数，就像使用维度和指标一样。
在计算字段中使用参数
您可以像在计算字段中使用维度或指标一样使用参数。
包含参数的计算字段示例
例如，假设您希望让用户输入上季度销售额的倍数，以直观呈现预测的销售额。
首先，创建一个参数来存储预测系数：
- 登录 Looker 数据洞察。
- 修改数据源。
- 点击右上角的 添加参数 。
- 为参数命名（例如“预测系数”）。
- 将数据类型设置为数字。
- 为简单起见，请将允许的值选项保留设置为任何值。
您可以使用其他选项让用户从值列表中进行选择，或限制用户输入的值范围。 - 将 默认值 设置为 1。
- 点击 保存 。
- 如需返回数据源字段列表，请点击左侧的 所有字段 。
接下来，创建计算字段：
- 点击右上角的 添加字段 。
- 为该字段命名（例如“包含参数的销售预测”）。
- 在公式中，将数据源中的“销售额”字段乘以 预测系数 参数。例如，如果您的数据源包含一个名为“Revenue”（收入）的字段，请输入：
Revenue \* Forecast multiplier （收入 * 预测乘数） - 点击 保存 。
接下来，添加一个控件来收集用户的输入：
- 修改或创建报告。
- 如有必要，请将您的数据源添加到报告中。
- 点击顶部的 添加控件 。
- 选择 输入框 控件。
借助“输入框”控件，您可以直接输入参数值。其他类型的控件可让您从列表中进行选择、使用滑块或使用复选框切换布尔值。 - 在右侧的“数据”属性中，添加您之前创建的 预测倍数 参数。
最后，在图表中直观呈现参数化计算字段。
- 点击顶部的
添加图表 。 - 为简单起见，请选择 统计信息摘要 。
- 在右侧的“数据”属性中，将 包含参数的销售预测 计算字段添加为指标。
现在，试用一下：
- 点击右上角的 查看 。
- 在 预测倍数 控件中输入一个数字，然后按 Enter 键。
- 您会看到统计信息摘要中的值会随着您输入的值而变化。
在可视化图表中使用参数
您可以像添加维度或指标一样向图表添加参数。如果您将数值参数用作指标，系统会汇总其值。
在报告中显示 / 隐藏参数
您可以显示或隐藏在数据源中创建的参数：
- 修改数据源。
- 找到相应参数。
- 点击参数右侧的
选项。 - 点击显示（如果参数当前处于隐藏状态）或隐藏（如果参数当前处于显示状态）。
隐藏参数会将其从数据面板中的字段列表中移除，并会破坏使用该参数的所有组件。如果参数在计算字段中使用，则公式会使用参数的默认值。
复制带有参数的组件
复制组件会复制其在属性面板中设置的参数值。您可以通过修改组件来替换副本的参数。
修复了无效参数
如果连接器中的参数配置发生变化，使用这些参数的所有图表都可能会损坏。例如，连接器的开发者可能会移除替换参数值的功能，这样您在报告中提供的值就不会再返回有效数据。在这种情况下，受该更改影响的所有图表中都会显示错误消息。
如需解决此问题，请找到包含当前无效参数的组件。然后，在该组件的“数据”属性的参数部分中，点击修正无效值。
请注意，参数可以在报告、页面和组一级以及在各个图表中进行设置，因此您可能需要查看多个位置才能找到并修正错误。