PAYATHON 2026

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 变化的情况,因为两列都参与匹配。

备注:内容仅供参考。