如何在Supabase中查询text[]类型多维数组列？

问题说明 #

查询Supabase数据库中text[]多维数组类型列包含指定值的行时，使用以下两类请求均执行失败：

• https://DATABASE_URL.supabase.co/rest/v1/test_db?data=in.(%7B%221%22%7D)
• https://DATABASE_URL.supabase.co/rest/v1/test_db?data=in.(1)

返回错误信息：

operator does not exist: text[] ~~ unknown
错误提示：No operator matches the given name and argument types. You might need to add explicit type casts.

错误原因 #

Supabase REST接口基于PostgREST实现，默认的in/eq等过滤器是为标量类型（单值字符串、数字等）设计的，直接作用于数组类型列时会触发隐式字符串匹配逻辑，无法识别数组类型的操作语义，最终报操作符不存在的类型错误。

可行解决方法 #

方法1：使用数组专用包含操作符 #

PostgREST原生提供数组类型专属的查询操作符，直接替换原请求里的in即可：

• 用cs（contains，包含匹配）查询数组列包含指定值的行，是最适配当前场景的方案。
• 由于列是text[]类型，传入参数必须符合PostgreSQL数组格式，字符串类型元素需要带双引号，整体用花括号包裹。

未编码的请求格式：

https://DATABASE_URL.supabase.co/rest/v1/test_db?data=cs.{"1"}

URL编码后可直接调用的请求：

https://DATABASE_URL.supabase.co/rest/v1/test_db?data=cs.%7B%221%22%7D

如果是多维数组需要跨层级匹配任意位置存在目标值的场景，可以替换为ov（overlap，重叠匹配）操作符，参数写法和cs完全一致。

方法2：通过RPC自定义查询逻辑 #

如果数组维度复杂、或者需要叠加更多自定义查询逻辑，可以先在Supabase SQL编辑器中创建查询函数，避免REST层的类型适配问题：

-- 创建数组查询的RPC函数
create or replace function query_test_db_by_arrval(target_val text)
returns setof test_db
language sql stable
as $$
  select * from test_db where data @> ARRAY[target_val]::text[];
$$;

创建完成后直接调用RPC接口即可，不需要手动拼接数组格式：

https://DATABASE_URL.supabase.co/rest/v1/rpc/query_test_db_by_arrval?target_val=1

注意事项 #

• 不要使用in/eq等标量过滤器直接查询数组类型列，这类过滤器不支持数组操作语义
• 直接通过REST传数组参数时，必须严格遵循PostgreSQL数组语法，字符串元素必须包裹双引号，特殊字符提前做URL编码
• 如果开启了RLS行级安全策略，需要给调用接口的角色（anon/authenticated）配置对应表的查询权限，或者RPC函数的执行权限

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