BigQuery执行bq mk建表命令提示schema.json字段名无效错误如何解决

错误原因 #

BigQuery 把schema.json识别为表字段名触发格式校验错误，根源是--schema参数没有被命令行正确解析，常见触发场景如下：

• 复制命令时把示例中代表shell次提示符的>也手动输入到了终端，>作为shell重定向操作符截断了后续参数，导致--schema参数失效
• 多行命令每行末尾的反斜杠\后存在多余空白字符，导致换行拼接失败，--schema和后续的schema.json被拆分成两个独立的位置参数

解决方法 #

方法一：运行单行命令（推荐，避免换行问题） #

直接执行拼接完成的单行命令即可：
bq mk -t --schema schema.json --time_partitioning_field flight_date data_analysis.flight_delays_json_partitioned

方法二：正确输入多行命令 #

如果需要拆分多行提升可读性，注意不要手动输入行首的>，每行末尾的反斜杠\后不能有任何空白字符：

bq mk -t \
--schema schema.json \
--time_partitioning_field flight_date data_analysis.flight_delays_json_partitioned

可选优化 #

如果仍然出现参数解析问题，可以用等于号绑定参数和值，减少解析歧义：
bq mk -t --schema=schema.json --time_partitioning_field=flight_date data_analysis.flight_delays_json_partitioned

执行前建议先确认当前工作目录下存在schema.json文件，避免后续触发文件不存在的报错。

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