使用Python API向BigQuery插入可空整数时报错

我之前处理过好几个类似的案例，你这个报错的核心问题大概率是传入的gas_used列"NULL"值的类型不对，不是BigQuery认可的空值格式。

问题原因分析 #

BigQuery的Python API中，要对应SQL里的NULL，必须传入Python原生的None类型，而不是空字符串""、数字0或者其他占位符。从你的报错信息Cannot convert value to integer (bad value):后面是空内容来看，你大概率是把空字符串或者未定义的变量传进去了——BigQuery没法把这类值转换成合法的INTEGER类型，哪怕列本身允许NULL。

正确的插入方式 #

确保你要插入的rows数据中，gas_used字段的值要么是整数，要么是None。举个实际的代码示例：

# 正确构造的行数据
rows = [
    {"gas_used": 12345, "other_column": "sample_value_1"},
    {"gas_used": None, "other_column": "sample_value_2"},  # 用None表示SQL NULL
    {"gas_used": 67890, "other_column": "sample_value_3"}
]

# 批量插入逻辑
BATCH_SIZE = 1000
for i in range(0, len(rows), BATCH_SIZE):
    batch = rows[i:i+BATCH_SIZE]
    errors = client.insert_rows(table, batch)
    if errors:
        print(f"第{i//BATCH_SIZE + 1}批次插入失败: {errors}")
    else:
        print(f"第{i//BATCH_SIZE + 1}批次插入成功")

常见错误排查点 #

• 检查数据源：如果是从CSV、JSON等外部源读取数据，是不是把空值转换成了""或"NULL"字符串？这些都会触发报错，必须替换为Python的None。
• 确认rows结构：每个行字典中的gas_used字段，要么是合法整数，要么显式传None，尽量避免字段缺失（虽然缺失字段BigQuery可能默认按NULL处理，但显式传值更稳妥）。
• 验证表架构：再次确认gas_used列确实是INTEGER类型且allowNull为True，可以通过BigQuery控制台或以下代码验证：

table = client.get_table("your-project.your-dataset.your-table")
for field in table.schema:
    print(f"字段名: {field.name}, 类型: {field.field_type}, 允许NULL: {field.is_nullable}")

如果按照上面的方法调整后还是报错，你可以把具体的rows数据结构贴出来，我再帮你进一步排查~

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