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 中是允许的，但业务逻辑中往往需要额外约束。
