Supabase-py 中使用 LIKE 过滤时百分比符号的正确用法

在 Python 项目中集成 Supabase 数据库时，开发者经常需要使用 LIKE 操作符进行模糊查询。然而，在使用 supabase-py 客户端库时，如果不正确使用百分比符号(%)作为通配符，可能会导致意外的 API 错误。

问题现象

当开发者尝试执行类似以下的查询时：

meeting_id = f'%{85770204020}%'
m = supabase.table('meeting').select('*').like('meeting_url', meeting_id).execute()

系统会抛出 postgrest.exceptions.APIError 异常，提示 JSON 无法生成。表面上看这像是一个编码问题，但实际上是由于查询模式语法不正确导致的。

根本原因

问题出在查询模式的格式上。在 SQL 的 LIKE 操作中，百分比符号(%)是标准的通配符，表示匹配任意数量的字符。然而：

1. 不应该在值周围使用 Python 的 f-string 格式化大括号 {}
2. 直接使用百分比符号作为字符串的一部分即可，不需要额外编码

正确用法

正确的查询模式应该是：

meeting_id = '%85770204020%'  # 直接使用%作为字符串的一部分
m = supabase.table('meeting').select('*').like('meeting_url', meeting_id).execute()

这种写法会正确匹配 meeting_url 字段中包含 "85770204020" 的任何字符串。

其他常见模式

除了上述的包含匹配外，LIKE 操作还支持其他几种常见模式：

1. 前缀匹配：查找以特定字符串开头的内容

   prefix = 'abc%'
   

2. 后缀匹配：查找以特定字符串结尾的内容

   suffix = '%xyz'
   

3. 精确长度匹配：使用下划线(_)匹配单个字符

   pattern = 'a_c'  # 匹配如 abc, aac, adc 等
   

性能考虑

虽然 LIKE 操作非常方便，但在大型数据集上使用时需要注意：

1. 前导通配符(如 %value)会导致索引失效，可能影响查询性能
2. 对于大型表，考虑使用全文搜索或其他索引策略
3. 简单的后缀匹配(如 value%)通常可以利用索引

总结

在使用 supabase-py 进行模糊查询时，正确使用百分比通配符至关重要。记住直接将其作为字符串的一部分，避免使用 f-string 格式化或其他编码方式。正确的模式语法不仅能避免 API 错误，还能确保查询按预期工作。对于性能敏感的应用，还需要考虑查询模式对数据库性能的影响。