如何用Psycopg3批量插入带PostGIS点数据的多行记录？

你的问题核心是Psycopg3会将传入的所有参数当作字面量处理，自动添加引号转义，导致ST_SetSRID(ST_MakePoint(...), 4326)这类SQL函数被识别成普通字符串，触发PostgreSQL的几何解析错误。以下是两种可行的解决方法：

方法1：将几何函数嵌入SQL模板，坐标作为参数传入 #

把ST_SetSRID和ST_MakePoint直接写在插入语句的模板中，仅将经度、纬度作为参数传递，避免函数被转义。示例代码：

from psycopg import sql
from psycopg.extras import execute_values

# 构造批量数据：每条数据包含经度、纬度、其他字段
batch_data = [
    (172.6306, 43.5320, "item_1"),
    (172.6407, 43.5421, "item_2")
]

# 定义基础插入SQL
insert_stmt = sql.SQL("INSERT INTO your_table (location, other_col) VALUES %s")

# 定义单条数据的模板：location字段用几何函数生成，参数对应经纬度和其他字段
row_template = sql.SQL("(ST_SetSRID(ST_MakePoint(%s, %s), 4326), %s)")

# 执行批量插入
execute_values(
    your_connection,
    insert_stmt,
    batch_data,
    template=row_template.as_string(your_connection)
)

方法2：使用Psycopg3的几何类型适配 #

利用Psycopg3内置的几何类型支持，直接创建Point对象传入，驱动会自动将其转换为PostgreSQL的geometry类型，无需手动编写SQL函数。示例代码：

from psycopg.types.geometry import Point
from psycopg.extras import execute_values

# 构造包含Point对象的批量数据
batch_data = [
    (Point(x=172.6306, y=43.5320, srid=4326), "item_1"),
    (Point(x=172.6407, y=43.5421, srid=4326), "item_2")
]

# 执行批量插入
execute_values(
    your_connection,
    "INSERT INTO your_table (location, other_col) VALUES %s",
    batch_data
)

这两种方法都能避免参数被不当转义，其中方法2更符合Psycopg3的使用规范，代码更简洁易维护。

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