BigQuery从Drive建表时GOOGLE_SHEET格式下线及替换格式报错咨询

问题原因说明 #

该报错是Google Cloud在2024年9月15日对BigQuery Drive数据源接口的正式调整导致的：

1. 前端建表入口移除了GOOGLE_SHEET（单数拼写）的格式选项
2. 直接粘贴Google Sheets网页URL选择CSV/Avro等格式时，BigQuery无法将网页地址解析为对应的结构化文件，因此触发Undefined parameter - ERROR_MESSAGE报错

可行解决方案 #

方案1：先导出文件再导入BigQuery（适合单次导入场景）

• 打开目标Google Sheets，点击「文件」>「下载」，选择CSV/Parquet/JSONL等你需要的格式
• 将下载的文件直接通过BigQuery本地文件上传入口建表，或先上传至Cloud Storage再关联建表即可，不会触发参数报错

方案2：通过bq命令行创建外部表关联Google Sheets（适合需要实时同步表格数据的场景）

直接在命令行执行建表命令，指定格式为GOOGLE_SHEETS（注意是复数拼写，前端已隐藏该选项但接口仍支持），示例命令如下：

bq mk --external_table_definition=@GOOGLE_SHEETS=https://docs.google.com/spreadsheets/d/[你的表格ID]/edit --dataset_id=[你的目标数据集ID] [自定义表名]

执行前请确认当前账号同时具备目标表格的查看权限、BigQuery建表权限、Drive API访问权限

方案3：通过Apps Script同步数据到BigQuery（适合定期自动同步场景）

• 打开目标Google Sheets，点击「扩展程序」>「Apps Script」
• 调用官方BigQuery服务脚本，直接将表格数据批量写入指定BigQuery表，可设置定时触发器实现自动同步

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