如何通过Google Sheet向BigQuery现有表上传记录而非镜像同步？

Connected Sheets的镜像同步是双向绑定机制，Sheet清空会同步删除BigQuery中的对应数据，完全不符合你的需求，因此无法通过Connected Sheets实现该功能，必须通过编写脚本完成。

解决方案：Google Apps Script实现追加+清空逻辑 #

以下是具体实现方案，核心是通过脚本将Sheet数据追加到BigQuery现有表，完成后清空Sheet内容（仅清空数据，保留表头）：

1. 核心脚本代码 #

function appendSheetToBigQuery() {
  // 替换为你的配置信息
  const SPREADSHEET_ID = "你的Google Sheet ID";
  const SHEET_NAME = "存储待上传数据的工作表名称";
  const BQ_PROJECT_ID = "你的BigQuery项目ID";
  const BQ_DATASET_ID = "目标数据集ID";
  const BQ_TABLE_ID = "目标表ID";

  // 获取Sheet数据（假设第一行是表头）
  const sheet = SpreadsheetApp.openById(SPREADSHEET_ID).getSheetByName(SHEET_NAME);
  const fullData = sheet.getDataRange().getValues();
  
  // 检查是否有可上传的数据
  if (fullData.length <= 1) {
    Logger.log("没有待上传的数据");
    return;
  }

  const headers = fullData[0];
  const dataRows = fullData.slice(1);

  // 转换为BigQuery兼容的JSON格式
  const bqFormattedRows = dataRows.map(row => {
    const rowObj = {};
    headers.forEach((colName, index) => {
      rowObj[colName] = row[index];
    });
    return {json: rowObj};
  });

  // 执行BigQuery追加操作
  try {
    BigQuery.Jobs.insert(
      {
        configuration: {
          load: {
            destinationTable: {
              projectId: BQ_PROJECT_ID,
              datasetId: BQ_DATASET_ID,
              tableId: BQ_TABLE_ID
            },
            writeDisposition: "WRITE_APPEND", // 关键：仅追加，不修改现有数据
            sourceFormat: "NEWLINE_DELIMITED_JSON"
          }
        }
      },
      BQ_PROJECT_ID,
      Utilities.newBlob(JSON.stringify(bqFormattedRows), "application/json")
    );

    Logger.log("数据成功追加到BigQuery");
    // 清空Sheet数据（保留表头）
    sheet.getRange(2, 1, sheet.getLastRow() - 1, sheet.getLastColumn()).clearContent();
    Logger.log("Sheet数据已清空");
  } catch (err) {
    Logger.log("操作失败：" + err.message);
  }
}

2. 配置与使用注意事项 #

• 启用BigQuery服务：在脚本编辑器中，点击「资源」>「高级Google服务」，找到BigQuery并开启。
• 权限授权：首次运行脚本时，需要授权账号访问Sheet和BigQuery的权限，确保账号拥有目标BigQuery表的写入权限。
• 字段匹配：Sheet的表头必须和BigQuery表的字段名完全一致（大小写敏感），否则会导致数据导入失败。
• 定时触发（可选）：如果需要周期性自动上传，可以在脚本编辑器的「编辑」>「当前项目的触发器」中设置定时执行规则（比如每天凌晨执行）。

3. 优势说明 #

• 完全脱离Connected Sheets的双向绑定，Sheet清空仅影响自身，不会同步删除BigQuery中的数据。
• 灵活可控，可以根据需求调整数据处理逻辑（比如数据校验、格式转换等）。

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