BigQuery CLI查询Google Sheets多工作表异常：指定Sheet2却返回Sheet1数据

我来帮你搞定这个问题——你遇到的核心问题是临时外部表的引用逻辑没搞对，再加上配置里的小细节，导致BigQuery还是默认读取了第一个工作表（Sheet1）。咱们一步步拆解：

1. 核心问题：你没正确引用临时外部表 #

你之前在数据集cegx-test-project1.multi_sheet_test里创建的Sheet2表，默认是指向第一个工作表（Sheet1）的（这也是你直接查询它会返回Sheet1数据的原因）。而你执行命令时，只指定了临时外部表的定义，但查询语句如果还是写SELECT * FROM Sheet2，BigQuery会优先查数据集里已有的Sheet2表，根本没用到你定义的临时外部表！

正确的命令应该是给临时外部表起一个和现有表不重名的名称（比如Sheet2Temp），然后在查询语句里明确引用它：

bq query --use_legacy_sql=false --external_table_definition="Sheet2Temp::/tmp/google_sheets_sheet2_tabledef.json" 'SELECT * FROM Sheet2Temp'

2. 修正外部表配置的小细节 #

你的google_sheets_sheet2_tabledef.json里有个参数需要调整，否则可能后续会出数据读取问题：

• skipLeadingRows应该设为1：因为Sheet2的首行是列名（col3、col4），设为1会跳过表头行，让BigQuery正确识别数据行；设为0会把表头当成数据读取，可能导致schema不匹配

修正后的配置文件：

{
 "autodetect": true,
 "sourceFormat": "GOOGLE_SHEETS",
 "sourceUris": [
 "https://docs.google.com/spreadsheets/d/1P1WH7cwVDaG6k-OQxKVXtnjBXI1NGFYvHD6IxCRFsZc"
 ],
 "maxBadRecords": 1,
 "googleSheetsOptions": {
 "range": "Sheet2!A1:B10",
 "skipLeadingRows": 1
 },
 "schema" : {
 "fields": [ {"name":"col3","type":"string"}, {"name":"col4","type":"string"} ]
 }
}

3. 更简单的替代方案：直接在查询里指定范围 #

如果临时外部表的方式觉得麻烦，你可以直接在查询语句中用OPTIONS参数指定Sheet2的范围，不需要额外配置文件，一步到位：

bq query --use_legacy_sql=false 'SELECT * FROM `cegx-test-project1.multi_sheet_test.Sheet2` OPTIONS(range="Sheet2!A1:B10")'

这种方式更直接，适合快速验证多工作表的查询结果。

4. 最后验证权限 #

确保BigQuery有访问这个Google Sheets的权限：

• 打开你的表格，点击右上角「共享」，添加BigQuery的服务账号（格式是[你的项目编号]@bigquery-robot.gserviceaccount.com），授予「查看者」权限
• 如果你是用个人账号操作CLI，确保已经通过gcloud auth login完成认证，且你的账号能正常打开这个表格

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