Postgres.js 如何构造复合 IN 查询
数据小陈
不要把二维数组直接作为 sql(pairs) 的参数,用来构造 (col1, col2) IN ... 的右值。Postgres.js 不会自动把 [[1,2],[2,3]] 展开成 ((1,2),(2,3)) 这样的 row constructor 列表,而会把它当作普通参数或数组值处理,所以容易报逗号相关的语法错误。更稳妥的做法是把 pairs 拆成两列数组,用 unnest 按位置展开成多行,再交给 row constructor 的 IN 子查询匹配。
推荐写法:unnest + 复合 IN
const pairs = [
[1, 2],
[2, 3],
];
const col1s = pairs.map(([col1]) => col1);
const col2s = pairs.map(([, col2]) => col2);
const result = await sql`
SELECT *
FROM your_table
WHERE (col1, col2) IN (
SELECT *
FROM unnest(${col1s}::int[], ${col2s}::int[])
)
`;
这段查询在语义上对应:
WHERE (col1, col2) IN ((1, 2), (2, 3))
unnest 会把两个数组按位置展开成多行,例如第一行是 (1, 2),第二行是 (2, 3)。::int[] 要换成你实际列的类型,例如 ::text[]、::uuid[] 或 ::bigint[]。如果 pairs 为空,unnest 返回空集合,IN (SELECT ...) 不会匹配任何行,通常也是安全的。
用 JOIN 的等价写法
如果后续还要带更多条件,或者更想用 JOIN 表达,可以这样写:
const result = await sql`
WITH input(col1, col2) AS (
SELECT *
FROM unnest(${col1s}::int[], ${col2s}::int[])
)
SELECT t.*
FROM your_table AS t
JOIN input AS i
ON t.col1 = i.col1
AND t.col2 = i.col2
`;
注意:IN 不会让右值中的重复对产生重复结果;如果你传入的 pairs 有重复对,而 JOIN 写法需要保持同样的去重效果,可以把 CTE 改成 SELECT DISTINCT * FROM unnest(...),或者在业务层先去重。
必须生成字面量 IN 列表时
如果你确实需要生成 IN (($1,$2),($3,$4)) 这种形式,可以显式生成占位符,值仍用参数传递:
const placeholders = pairs
.map((_, i) => `($${i * 2 + 1}, $${i * 2 + 2})`)
.join(', ');
const values = pairs.flat();
const result = await sql.unsafe(
`SELECT * FROM your_table WHERE (col1, col2) IN (${placeholders})`,
values
);
这里只拼接由代码生成的占位符,不要把 pairs 中的值直接拼进 SQL 字符串。pairs 为空时要单独处理,不要生成 IN ()。
注意事项
sql(pairs)适合一维数组场景,比如id IN ${sql(ids)};二维数组用于复合IN时,不要依赖自动展开。- 类型转换要写清楚,否则空数组或参数推断时可能报类型错误。
- 表名、列名和类型按实际 schema 替换;示例里的
your_table、col1、col2只是占位。 - 在 DataLoader 批处理里,这种写法能同时覆盖 col1 固定而 col2 变化、col2 固定而 col1 变化的情况,因为两列都参与匹配。
备注:内容仅供参考。
