基于Go+PostgreSQL，如何用sqlc处理可变输入参数的多表查询？

1. sqlc.narg()与coalesce完全可以用于SELECT语句 #

sqlc的narg()就是为处理可选参数（允许传入NULL）设计的，配合PostgreSQL的coalesce()函数，能轻松实现"参数为空时匹配所有，不为空时匹配参数值"的逻辑。

举个关联查询的实际例子（假设关联bookings和users表）：

-- name: SearchBookings :many
SELECT 
  u.user_id,
  b.booking_id,
  b.flight_id,
  b.created_at
FROM bookings b
JOIN users u ON b.user_id = u.user_id
WHERE
  -- 处理bookingId参数：为空则匹配所有，不为空则匹配指定值
  b.booking_id = coalesce(sqlc.narg('bookingId'), b.booking_id)
  -- 处理flightId参数
  AND b.flight_id = coalesce(sqlc.narg('flightId'), b.flight_id)
  -- 处理firstName参数
  AND u.first_name = coalesce(sqlc.narg('firstName'), u.first_name)
  -- 处理lastName参数
  AND u.last_name = coalesce(sqlc.narg('lastName'), u.last_name);

这里的逻辑是：如果某个参数（比如bookingId）为空，coalesce()会返回b.booking_id，相当于b.booking_id = b.booking_id，这个条件永远为真，不对该字段做过滤；如果参数不为空，就会匹配参数值。

生成Go代码后，调用时只需要传入有值的参数即可，空参数会自动被sqlc处理为NULL：

// 示例：只传入firstName和lastName参数
bookings, err := db.SearchBookings(ctx, db.SearchBookingsParams{
  FirstName: sql.NullString{String: "John", Valid: true},
  LastName: sql.NullString{String: "Doe", Valid: true},
  // 其他参数默认Valid: false，会被处理为NULL
})

2. 替代CASE WHEN实现多记录返回的方案 #

CASE WHEN是用来做行内的条件赋值，本来就不是用来做查询过滤的，自然没法返回多记录。正确的做法是在WHERE子句中构建动态过滤条件，推荐两种实用方式：

方式一：OR + IS NULL（可读性更高） #

直接判断参数是否为空，为空则跳过该条件，不为空则匹配：

-- name: SearchBookings :many
SELECT 
  u.user_id,
  b.booking_id,
  b.flight_id,
  b.created_at
FROM bookings b
JOIN users u ON b.user_id = u.user_id
WHERE
  (sqlc.narg('bookingId') IS NULL OR b.booking_id = sqlc.narg('bookingId'))
  AND (sqlc.narg('flightId') IS NULL OR b.flight_id = sqlc.narg('flightId'))
  AND (sqlc.narg('firstName') IS NULL OR u.first_name = sqlc.narg('firstName'))
  AND (sqlc.narg('lastName') IS NULL OR u.last_name = sqlc.narg('lastName'));

这个逻辑和coalesce方案效果完全一致，但对新手更友好，一眼就能看懂每个参数的过滤规则。

方式二：使用PostgreSQL内置函数简化（可选） #

如果觉得重复写IS NULL麻烦，也可以用PostgreSQL的pg_catalog.pg_isnull函数简化：

-- name: SearchBookings :many
SELECT 
  u.user_id,
  b.booking_id,
  b.flight_id,
  b.created_at
FROM bookings b
JOIN users u ON b.user_id = u.user_id
WHERE
  pg_catalog.pg_isnull(sqlc.narg('bookingId')) OR b.booking_id = sqlc.narg('bookingId')
  AND pg_catalog.pg_isnull(sqlc.narg('flightId')) OR b.flight_id = sqlc.narg('flightId')
  AND pg_catalog.pg_isnull(sqlc.narg('firstName')) OR u.first_name = sqlc.narg('firstName')
  AND pg_catalog.pg_isnull(sqlc.narg('lastName')) OR u.last_name = sqlc.narg('lastName');

不管用哪种方式，只要参数组合正确，PostgreSQL都会返回所有符合条件的记录——不管是单条还是多条，完全匹配你的场景需求。

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