管理查询参数

通过参数，您可以在每次运行查询时提示输入与查询过滤器或计算一起使用的值。通过在运行时设置这些值，您可以在每次运行时在不同的上下文（例如帐户、区域或时间段）中使用查询。

您可以创建自定义参数以用于特定查询，或者您的工作区所有者可以创建全局参数以用于多个查询。

为查询创建自定义参数

您可以在生成器或 SQL 编辑器中设置查询的参数。创建参数时，您可以将其与查询中的多个筛选器和计算一起使用。 

步骤 1. 创建参数

1. 从 参数 面板中，单击 添加，然后选择 创建新参数。
   
2. 为了帮助识别参数，请输入仅包含字母数字字符且 且不包含 空格的唯一名称。
3. 在 筛选类型中，选择要筛选的数据类型，例如文本或整数。

步骤 2. 设置参数值

当查询运行时，其参数可以接受基于数据类型的自由格式值，或提供特定值的列表以供选择。 

• 要接受任何自由格式值，请输入默认值（如果适用），然后单击 创建。
• 提供特定值的列表：

1. 启用 选项列表。
2. 要启用参数的多个值，请选中 多选 框。
3. 在 列表选项中，输入要选择的值，在每个值后按 输入 。

   注意： 对于日期或时间戳参数，请以 YYYY-MM-dd 格式输入每个选项。

4. 为参数选择任意默认值，然后单击 接受。

   注意： 对于 多选 参数，至少选择一个默认值。

5. 点击 【创建】 【创建】即可完成。

步骤 3. 在查询中使用参数

要将参数的值应用于查询，请在过滤器或计算中使用它：

• 要根据 Builder 中 的参数设置过滤器的值，请在定义过滤器时从 过滤器属性 右侧面板中选择它。

  注意： 对于多选 参数，选择Is In List 或Is Not In List 的过滤运算符筛选s 标签。

• 要 在 SQL 编辑器中使用带过滤器的参数 或在计算中引用其值，请在 SQL 语句中的冒号 (:) 后输入其名称，例如 :ReportingPeriod。

在查询中使用全局参数

您的工作区所有者可以 为多个查询使用的通用值配置全局参数 。要在查询中使用全局参数：

1. 从 参数 面板中，单击 添加，然后选择 选择全局参数。
   
2. 选择要在查询中使用的全局参数，然后单击 添加。
3. 要编辑全局参数，请选择它并根据查询需要更新其名称或值。

   注意： 为了确保分析的一致性，您的工作区所有者可以锁定全局参数以防止其值被编辑。

4. 要将全局参数的值应用于查询，请在过滤器或计算中使用它：

   • 要根据 Builder 中 的参数设置过滤器的值，请在定义过滤器时从 过滤器属性 右侧面板中选择它。

     注意： 对于多选 参数，选择Is In List 或Is Not In List 的过滤运算符筛选s 标签。

   • 要在 SQL 编辑器中引用参数，请在 SQL 语句中的冒号 (:) 后输入其名称，例如 :ReportingPeriod。
   • 要 在计算的 SQL 语句中引用参数值，请从 参数 菜单中选择该参数。

编辑查询参数

要调整或管理参数的详细信息：

1. 从 参数面板中，选择要编辑的参数。
2. 根据需要编辑参数的名称、数据类型或值。
3. 单击 应用。

删除查询参数

如果不再需要参数，可以将其从查询中删除。从 参数面板中，单击参数的 删除 ，然后单击 保存 。