jsonb_set(target_jsonb, path_text[], new_value_jsonb, create_missing_boolean) 用于替换或插入JSONB中指定路径的值，path须为text[]数组，new_value必须是jsonb类型，create_missing默认true决定是否自动创建缺失路径。
jsonb_set 函数的基本用法和参数顺序
jsonb_set 是 PostgreSQL 9.5+ 提供的原生函数，用于安全地更新 JSONB 字段中指定路径的值。它有 4 个参数，顺序不能错：jsonb_set(target_jsonb, path_array, new_value, create_missing)。其中 path_array 必须是 text[] 类型（比如 ARRAY['user', 'profile', 'age']），不是字符串；new_value 必须是 jsonb 类型（常被忽略，直接写 '25' 会报错）；create_missing 是布尔值，决定路径不存在时是否自动创建父级。
批量更新单层键值的典型写法
假设表 orders 有字段 metadata JSONB，想把所有记录中 "status" 键的值统一改为 "processed"：
UPDATE orders SET metadata = jsonb_set(metadata, ARRAY['status'], '"processed"'::jsonb, true);
注意这几点：
-
"processed"外层双引号必须保留，再用::jsonb显式转换，否则会被当作 text 而非 JSONB 值 - 如果只更新部分记录，务必加
WHERE metadata ? 'status'或其他条件，避免无谓全表扫描 - 若原字段可能为
NULL，jsonb_set(NULL, ...)返回NULL，需用COALESCE(metadata, '{}'::jsonb)预处理
嵌套路径更新和 create_missing 的陷阱
更新 {"user": {"name": "Alice"}} 中的 user.email，路径是 ARRAY['user', 'email']。这时 create_missing := true 会让缺失的 user 对象被自动创建，结果变成 {"user": {"name": "Alice", "email": "a@b.com"}}；但设为 false 则什么也不改——连 user 不存在的记录都会跳过。
常见误操作：
- 写成
ARRAY['user.email']（错误：路径数组元素是每层 key，不是点分字符串） - 漏掉
::jsonb转换，导致ERROR: function jsonb_set(jsonb, text[], text, boolean) does not exist - 对含数字索引的数组路径（如
items[0].price）未用字符串表示索引，应写ARRAY['items', '0', 'price']
性能与并发注意事项
jsonb_set 每次都生成新 JSONB 值并重写整行，不适合高频小更新。批量执行时：
- 确保目标字段上有合适的索引，比如
CREATE INDEX ON orders ((metadata->>'status'));加速 WHERE 过滤 - 大表更新建议分批次，例如加
WHERE ctid IN (SELECT ctid FROM orders WHERE metadata ? 'status' LIMIT 10000)避免长事务锁表 - 如果只是替换固定键、且结构简单，有时
metadata || '{"status":"processed"}'::jsonb更快，但它会覆盖同名键，且不保证原有字段顺序（JSONB 内部无序）
路径越深、JSONB 值越大，jsonb_set 开销越高；真正要改的键在顶层时，性能差异不大，但嵌套三层以上就得留意执行计划了。
