BigQuery结合Python：如何通过dbapi游标插入GEOGRAPHY类型数据

错误原因说明 #

BigQuery为强类型系统，STRING和GEOGRAPHY是完全独立的类型，没有隐式转换逻辑，因此直接传入WKT格式字符串（不管是写死在SQL中还是作为普通字符串绑定参数传入）都会被识别为STRING类型，和GEOGRAPHY类型的字段不匹配导致报错。

通用解决方案（无需修改现有插入函数逻辑） #

方案1：传入shapely几何对象（推荐） #

google-cloud-bigquery驱动原生支持shapely几何对象的自动类型映射，会自动将shapely的Geometry子类对象转换为GEOGRAPHY类型，不需要额外修改SQL模板，符合通用性要求。

1. 首先安装依赖：

pip install shapely

2. 调用插入函数时，GEOGRAPHY字段直接传对应shapely对象即可：

from shapely.geometry import Point, LineString, Polygon

# 示例：插入点数据
insert(
    table_id="project.dataset.tmp",
    fields=["geo"],
    bindings=(Point(1, 3),)
)

方案2：传入显式声明类型的QueryParameter对象（无额外依赖） #

如果不想引入shapely依赖，可以直接构造BigQuery的ScalarQueryParameter对象，显式指定类型为GEOGRAPHY，值为WKT格式字符串：

from google.cloud.bigquery import ScalarQueryParameter

insert(
    table_id="project.dataset.tmp",
    fields=["geo"],
    bindings=(ScalarQueryParameter(None, "GEOGRAPHY", "POINT(1,3)"),)
)

驱动会直接识别参数的类型声明，完成类型匹配。

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