Google BigQuery关联Google Sheets报错：行列数不匹配求助

先看错误核心信息：Row 1 has only 1 columns, while 2 is needed，说明BigQuery读取到的每行数据只有1列，但你定义的schema要求2列，这就是问题根源。下面拆解可能的错误点和解决办法：

1. 手动Schema与Sheet实际数据不匹配 #

你在JSON里手动指定了包含2个字段的schema：

"schema" : { "fields": [ {"name":"col3","type":"string"}, {"name":"col4","type":"string"} ] }

但你的Sheet2的A1:B10区域里，实际每行只有1列有数据（比如B列全为空、或者range选的区域根本没有2列数据）。

解决办法：

• 打开你的Google Sheet，检查Sheet2!A1:B10区域：确认B列是否有实际数据，或者是否存在列被隐藏的情况；
• 如果Sheet里确实只有1列有效数据，修改JSON的schema，只保留一个字段；如果有2列数据，确保range覆盖了这两列（比如是不是range写错成了A1:A10？）。

2. autodetect与手动Schema的冲突 #

你同时设置了"autodetect": true和手动schema，虽然BigQuery会优先使用手动schema，但自动检测的逻辑可能会干扰数据读取的判断。比如如果Sheet里的列数和手动schema不一致，就会触发错误。

解决办法：

• 如果你想完全手动控制schema，把autodetect改成false，避免自动检测的逻辑干扰；
• 如果你不确定Sheet的schema，先去掉手动schema，保留autodetect: true，运行查询看看BigQuery自动检测到的列数，再根据检测结果调整手动schema。

3. 表头行处理错误 #

你设置了"skipLeadingRows": 0，意味着BigQuery会把Sheet的第一行（A1:B1）当成数据行读取。如果A1是表头（比如只有col3一个列名，B1为空），那这一行就只有1列数据，和你的2列schema冲突，直接触发错误。

解决办法：

• 如果Sheet第一行是表头，把skipLeadingRows改成1，让BigQuery跳过表头行，从第二行开始读取数据。

验证步骤 #

建议按以下顺序排查：

• 先简化JSON配置，去掉手动schema，设置autodetect: true和skipLeadingRows: 1（如果有表头），重新运行bq命令，看是否能成功查询；
• 如果成功，查看返回的列数，再根据这个结果编写正确的手动schema；
• 如果还是报错，确认Sheet的共享权限：BigQuery的服务账号是否有访问这个Sheet的权限？（不过你的错误是列数不匹配，权限问题一般会报访问错误，所以这个可能性较低，但也可以排查下）

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