本文介绍如何在 H2 数据库中对 INT ARRAY 类型字段执行按值删除（retract）、批量过滤及元素替换（update）等关键操作，利用 TABLE() 表函数结合子查询实现安全、可控的数组变换。
本文介绍如何在 h2 数据库中对 `int array` 类型字段执行按值删除（retract）、批量过滤及元素替换（update）等关键操作，利用 `table()` 表函数结合子查询实现安全、可控的数组变换。
H2 数据库原生支持数组类型（如 INT ARRAY），但其数组操作能力有限——不提供类似 ARRAY_REMOVE() 或 ARRAY_REPLACE() 的内置函数。因此，要实现按值删除（如移除数组中所有 2）或按值更新（如将 1 替换为 10），必须借助 SQL 标准的表构造能力：将数组“展开”为行集，通过 WHERE 或 CASE 进行逻辑处理，再聚合成新数组。
✅ 按值删除（Retract）指定元素
核心思路：使用 TABLE(V INT = (SELECT ...)) 将数组解构为单列虚拟表，再用 WHERE 过滤，最后用 ARRAY(...) 重构：
UPDATE A SET ints = ARRAY( SELECT V FROM TABLE(V INT = (SELECT ints FROM A WHERE id = 1)) WHERE V != 2 ) WHERE id = 1;
✅ 效果：[1, 2, 3] → [1, 3]
✅ 支持多值删除：WHERE V NOT IN (1, 2) 可同时移除多个值。
⚠️ 注意：WHERE 条件作用于每个元素，天然支持去重后保留顺序（H2 保证 TABLE(...) 展开顺序与原数组一致）。
✅ 按值更新（Replace）单个或多个元素
使用 CASE WHEN 在展开后的行集中完成映射替换：
UPDATE A
SET ints = ARRAY(
SELECT CASE V
WHEN 1 THEN 10
WHEN 3 THEN 30
ELSE V
END
FROM TABLE(V INT = (SELECT ints FROM A WHERE id = 1))
)
WHERE id = 1;
✅ 效果：[1, 2, 3] → [10, 2, 30]
✅ 可组合任意数量映射规则，ELSE V 确保未匹配元素保持不变。
? 提示：若需严格区分“首次出现”或“全部替换”，H2 当前无索引感知语法，但 CASE 已满足绝大多数业务场景（如状态码批量升级、ID 映射迁移）。
⚠️ 关键注意事项
-
子查询作用域：
TABLE(V INT = (SELECT ints ...))中的子查询必须返回单行单数组值；若用于多行更新（如WHERE id IN (...)），需改用相关子查询或结合LATERAL（H2 2.2+ 支持）：UPDATE A a1 SET ints = ARRAY( SELECT CASE V WHEN 2 THEN 20 ELSE V END FROM TABLE(V INT = a1.ints) ) WHERE a1.id = 1;
-
空数组与 NULL 安全：若原数组为
NULL，TABLE(...)将返回空结果集，ARRAY(...)得到空数组[]而非NULL。如需保留NULL，可加COALESCE判断：SET ints = CASE WHEN ints IS NULL THEN NULL ELSE ARRAY(SELECT ...) END 性能提示：数组操作本质是行级展开+聚合，对超大数组（>1000 元素）可能影响性能；高频更新建议评估是否应转为关联表（如
a_items(a_id, value)）。
✅ 总结
H2 虽无高级数组函数，但通过 TABLE() + ARRAY() 的组合范式，可稳健实现按值增删改。其本质是将数组视为“不可变集合”的关系化投影——这恰恰契合 SQL 声明式哲学：不关心位置，只关注逻辑条件。掌握这一模式，即可在 H2 中安全地将数组作为轻量级集合字段使用，兼顾简洁性与可控性。
