cardinality函数在postgresql 16中可用，用于返回数组总元素数（如cardinality(array[[1,2],[3,4]])=4），不支持null数组或非数组类型，对多维数组扁平计数，区别于需指定维度的array_length。

CARDINALITY 函数在 PostgreSQL 16 中是否可用

可用，但仅限于数组类型，且不能直接用于 NULL 数组或非数组表达式。PostgreSQL 16 没有移除或更改 CARDINALITY 的行为，它仍是计算数组元素个数的标准函数，语义清晰、性能稳定。

CARDINALITY 和 array_length 的关键区别

CARDINALITY 返回的是数组的总元素数（扁平计数），而 array_length 需指定维度，返回该维的长度。对一维数组二者结果相同；但对多维数组，CARDINALITY 更适合“总共多少个值”的场景。

• CARDINALITY(ARRAY[[1,2],[3,4]]) → 4（所有嵌套元素总数）
• array_length(ARRAY[[1,2],[3,4]], 1) → 2（第一维长度）
• array_length(ARRAY[[1,2],[3,4]], 2) → 2（第二维长度）
• 若数组为 NULL，CARDINALITY 返回 NULL，不是 0 —— 这是常见误判点

实际使用时容易踩的坑

最常出错的是把非数组值（如字符串、JSON、记录）直接传给 CARDINALITY，导致报错 ERROR: function cardinality(unknown) does not exist。

• 字符串需先转数组：CARDINALITY(string_to_array('a,b,c', ','))
• JSON 数组需先用 jsonb_array_elements 或 jsonb_path_query_array 转成 SQL 数组，不能直接 CARDINALITY(my_json_col)
• 空数组 ARRAY[]::int[] 返回 0，合法；但 ARRAY[NULL] 是含一个 NULL 元素的数组，CARDINALITY 仍返回 1
• 在 WHERE 或 JOIN 条件中频繁调用 CARDINALITY 可能影响性能，尤其对大表上的表达式索引不友好 —— 如需高频过滤，建议预存长度字段

一个安全的通用写法示例

处理可能为 NULL 的数组列时，显式判断比依赖隐式转换更可靠：

SELECT
  id,
  CASE WHEN tags IS NOT NULL THEN CARDINALITY(tags) ELSE 0 END AS tag_count
FROM posts;

注意：这里 tags 必须是明确的数组类型（如 text[]），否则会触发类型错误。如果列定义是 jsonb，必须先用 ARRAY(SELECT jsonb_array_elements_text(tags)) 转换，不能跳步。

多维数组的维度结构不一致时（比如 ARRAY[[1],[2,3]]），CARDINALITY 依然正确返回总元素数（这里是 3），但它不校验形状合法性 —— 这种“不规则数组”本身在 PostgreSQL 中是允许的，但业务逻辑中往往需要额外约束。