PostgreSQL中PQexecParams/PQprepare占位符索引映射规则问询

结论很明确：占位符的数字编号直接对应const char** data数组的偏移量（$N → data[N-1]），和占位符在SQL语句中的出现顺序完全无关。

举你的例子说明：

原SQL语句 #

INSERT INTO ... VALUES ($1, $2, $3, $4), ($1, $5, $3, $6), ($1, $7, $3, $8)

映射关系固定为：

data[0] -> $1
data[1] -> $2
data[2] -> $3
data[3] -> $4
data[4] -> $5
data[5] -> $6
data[6] -> $7
data[7] -> $8

哪怕$1和$3在语句中重复出现多次，你只需要在data数组中传入一次对应值即可，PostgreSQL会自动复用该值填充所有对应占位符的位置。

修改后的SQL语句 #

当你交换前两个占位符的位置，SQL变为：

INSERT INTO ... VALUES ($2, $1, $3, $4), ($1, $5, $3, $6), ($1, $7, $3, $8)

映射关系完全不变：

data[0] -> $1
data[1] -> $2
...

只是SQL语句会先使用$2对应的值（即data[1]），再使用$1对应的值（即data[0]），不需要调整data数组的元素顺序。

额外说明 #

• 这个规则同时适用于PQexecParams（直接执行参数化查询）和PQprepare（预编译语句）。
• 这种设计的核心优势是支持参数复用，避免重复传入相同值，减少代码冗余和网络传输开销。

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