如何使用BigQuery Mate的参数按钮？请附简单示例说明

我刚上手BigQuery Mate的时候，也对着参数按钮犯懵——这玩意儿到底咋用？后来拿几个日常查询试了试，一下子就通了，给你用最简单的例子讲明白：

示例1：动态替换日期范围 #

假设你有一个固定日期范围的查询，每次改日期都要手动改SQL里的字符串，特别麻烦：

SELECT user_id, event_time
FROM `my-project.my_dataset.user_events`
WHERE event_time BETWEEN '2024-01-01' AND '2024-01-31'

用参数按钮改造的步骤：

• 选中查询里的 '2024-01-01'，点击编辑器工具栏上的参数按钮（就是那个带{}图标的按钮）
• 在弹出的配置窗口里：
  • 给参数起个好记的名字，比如 start_date
  • 类型选「DATE」（或者STRING，根据你的字段类型来）
  • 默认值填 '2024-01-01'
  • 点击「确定」完成配置
• 重复上面的操作，把 '2024-01-31' 配置成参数 end_date

改造后的查询会自动变成这样：

SELECT user_id, event_time
FROM `my-project.my_dataset.user_events`
WHERE event_time BETWEEN @start_date AND @end_date

下次运行查询时，BigQuery Mate会弹出一个参数输入框，你直接输入新的日期（比如2024-02-01和2024-02-29）就行，再也不用手动改SQL里的字符串了！

示例2：下拉选择筛选条件 #

如果你的查询需要频繁切换不同的筛选值（比如用户类型），参数按钮还能帮你做下拉选项：
原查询：

SELECT COUNT(*) AS user_count
FROM `my-project.my_dataset.users`
WHERE user_type = 'premium'

操作步骤：

• 选中 'premium'，点击参数按钮
• 配置参数：
  • 命名为 target_user_type
  • 类型选「STRING」
  • 默认值填 'premium'
  • 在「可选值」里输入 ['free', 'premium', 'enterprise']（用逗号分隔不同选项）
  • 点击「确定」

改造后的查询：

SELECT COUNT(*) AS user_count
FROM `my-project.my_dataset.users`
WHERE user_type = @target_user_type

现在运行查询时，你会看到一个下拉菜单，直接选对应的用户类型就行，完全不用手动输入，还能避免拼写错误。

小技巧：批量管理参数 #

如果你的查询里有多个参数，或者想修改已有的参数，可以点击编辑器上方的「参数」面板（一般在右侧侧边栏），在这里可以统一查看、修改所有参数的名称、类型和默认值，比一个个改方便多了。

内容的提问来源于stack exchange，提问作者user444422