如何通过Apps Script运行BigQuery查询并将结果保存至指定表？

安全阿岳

2026-9-28

方案说明

优先选择直接通过API传入查询语句运行，该方式灵活度更高，无需依赖已保存的查询资源，可完全满足自定义目标写入位置、配置表覆盖规则的需求，适配Apps Script的事件触发场景。两种实现方式的对比如下：

运行已保存查询：需要提前获取已保存查询的资源ID，额外调用一次API拉取查询内容，后续如果修改了已保存查询的语句，API运行逻辑会被联动影响，灵活度低，不推荐使用。
直接传入查询语句：所有参数可在调用时动态配置，无需依赖提前保存的查询资源，适合结合业务事件做触发，是更适配你需求的方案。

Apps Script 实现步骤

1. 前置准备

打开你要使用的Apps Script项目，在编辑器左侧「服务」栏点击「添加服务」，找到BigQuery后完成添加，即可调用BigQuery API。

2. 代码示例

function runBigQueryJob() {
  // 配置项目信息
  const projectId = '你的GCP项目ID';
  // 替换为你的查询语句
  const querySql = `SELECT * FROM \`你的项目ID.数据集名.表名\` WHERE 你的过滤条件`;

  // 构造查询作业配置
  const jobConfig = {
    configuration: {
      query: {
        query: querySql,
        useLegacySql: false, // 使用标准SQL语法
        // 配置目标写入表
        destinationTable: {
          projectId: projectId,
          datasetId: '目标数据集ID',
          tableId: '目标表名'
        },
        // 配置写入规则，WRITE_TRUNCATE为覆盖，WRITE_APPEND为追加
        writeDisposition: 'WRITE_TRUNCATE'
      }
    }
  };

  // 提交查询作业
  const job = BigQuery.Jobs.insert(jobConfig, projectId);
  console.log('查询作业已提交，作业ID：' + job.jobReference.jobId);
}