skills/supabase-postgres-best-practices
1
0
Fork 0
mirror of https://github.com/supabase/agent-skills.git synced 2026-03-27 10:09:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix: correct hybrid_search function to match official Supabase docs

Browse Source 
- Use <#> (inner product) operator instead of <=> (cosine distance)
- Use extensions.vector(512) instead of vector(1536)
- Remove `stable` and `security invoker` qualifiers
- Add full_text_weight, semantic_weight, rrf_k parameters
- Use least(match_count, 30) cap for over-fetching
- Remove default value from match_count (required param)
- Use parameterized rrf_k and weights in RRF scoring formula

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Pedro Rodrigues
2026-02-09 15:59:45 +00:00
parent f4d228d448
commit 6c1b7af187
1 changed files with 21 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
skills/supabase/references/vectors/search-hybrid.md
View File

@@ -42,7 +42,7 @@ Fetching exact match_count from each source may miss relevant results after fusi
```sql ```sql
-- May miss good results after RRF fusion -- May miss good results after RRF fusion
with semantic as (select id from docs order by embedding <=> query limit 5), with semantic as (select id from docs order by embedding <#> query limit 5),
full_text as (select id from docs where fts @@ query limit 5) full_text as (select id from docs where fts @@ query limit 5)
select * from semantic union full_text limit 5; select * from semantic union full_text limit 5;
``` ```
@@ -50,38 +50,44 @@ select * from semantic union full_text limit 5;
**Correct:** **Correct:**
```sql ```sql
-- Fetch 2x from each, then fuse and limit -- Over-fetch 2x with least() cap, then fuse and limit
with semantic as (select id from docs order by embedding <=> query limit 10), with semantic as (select id from docs order by embedding <#> query limit least(5, 30) * 2),
full_text as (select id from docs where fts @@ query limit 10) full_text as (select id from docs where fts @@ query limit least(5, 30) * 2)
-- Apply RRF scoring... -- Apply RRF scoring...
limit 5; limit least(5, 30);
``` ```
## Complete Hybrid Search Function ## Complete Hybrid Search Function
```sql ```sql
create function hybrid_search( create or replace function hybrid_search(
query_text text, query_text text,
query_embedding vector(1536), query_embedding extensions.vector(512),
match_count int default 10 match_count int,
full_text_weight float = 1,
semantic_weight float = 1,
rrf_k int = 50
) )
returns setof documents language sql stable security invoker as $$ returns setof documents language sql as $$
with full_text as ( with full_text as (
select id, row_number() over (order by ts_rank_cd(fts, websearch_to_tsquery(query_text)) desc) as rank_ix select id, row_number() over (order by ts_rank_cd(fts, websearch_to_tsquery(query_text)) desc) as rank_ix
from documents where fts @@ websearch_to_tsquery(query_text) from documents where fts @@ websearch_to_tsquery(query_text)
limit match_count * 2 limit least(match_count, 30) * 2
), ),
semantic as ( semantic as (
select id, row_number() over (order by embedding <=> query_embedding) as rank_ix select id, row_number() over (order by embedding <#> query_embedding) as rank_ix
from documents from documents
order by embedding <=> query_embedding order by embedding <#> query_embedding
limit match_count * 2 limit least(match_count, 30) * 2
) )
select documents.* from full_text select documents.* from full_text
full outer join semantic on full_text.id = semantic.id full outer join semantic on full_text.id = semantic.id
join documents on coalesce(full_text.id, semantic.id) = documents.id join documents on coalesce(full_text.id, semantic.id) = documents.id
order by coalesce(1.0/(50+full_text.rank_ix),0) + coalesce(1.0/(50+semantic.rank_ix),0) desc order by
limit match_count; coalesce(1.0/(rrf_k + full_text.rank_ix), 0.0) * full_text_weight +
coalesce(1.0/(rrf_k + semantic.rank_ix), 0.0) * semantic_weight
desc
limit least(match_count, 30);
$$; $$;
``` ```