Feat/raae 1322/hybrid support by rbs333 · Pull Request #639 · redis/redis-vl-python

rbs333 · 2026-06-24T18:16:08Z

Adds ft.hybrid support to SQL query.

This ships as part of sql-redis 0.7.0 release.

Note

Medium Risk
Introduces a new search path (FT.HYBRID) behind stricter Redis/redis-py/sql-redis version requirements; incorrect docs or dependency pins could mislead adopters, but runtime code changes are minimal.

Overview
Documents SQL hybrid search via hybrid_vector_search(cosine_distance(...), fulltext(...), rrf()|linear()), which maps to Redis FT.HYBRID through the upgraded sql-redis dependency (now >=0.7.1 in pyproject.toml and the lockfile).

Coverage spans the SQLQuery docstring, API/concepts docs, and a new notebook section with an executable example. Integration tests exercise RRF and linear fusion, WHERE filters, RRF knobs, redis_query_string() output, and async AsyncSearchIndex—all gated on Redis 8.4+ and redis-py >= 7.1.0.

No new RedisVL translation logic in this PR; behavior comes from sql-redis 0.7.x on the existing SQLQuery → index.query() path.

^{Reviewed by Cursor Bugbot for commit 1e5bad8. Bugbot is set up for automated code reviews on this repo. Configure here.}

Adds tests/integration/test_sql_redis_hybrid.py exercising hybrid_vector_search() through SQLQuery against a native FT.HYBRID command (RRF and LINEAR fusion, WHERE filter, redis_query_string inspection, sync + async). Version-gated with skip_if_redis_version_below(..., "8.4.0") and a redis-py>=7.1.0 skipif, matching test_hybrid.py. Adds a "Hybrid search (FT.HYBRID)" example cell to the SQL-to-Redis user guide and a packaging spec under docs/proposals/. Requires sql-redis with hybrid support. Jira: RAAE-1322

jit-ci · 2026-06-24T18:17:31Z

🛡️ Jit Security Scan Results

✅ No security findings were detected in this PR

^{Security scan by Jit}

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 69df859. Configure here.}

Copilot

Pull request overview

This PR updates RedisVL’s optional SQLQuery integration to support server-side hybrid fusion (FT.HYBRID) by bumping the sql-redis extra to >=0.7.0, adding a new integration test suite for hybrid SQL queries, and updating user-facing documentation/spec materials.

Changes:

Bump optional dependency sql-redis (and all extra) from >=0.6.0 to >=0.7.0.
Add integration tests validating hybrid_vector_search(...) execution and redis_query_string() rendering for FT.HYBRID (sync + async).
Update docs with a new SQL user-guide section and a draft proposal/spec for SQLQuery hybrid support.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
tests/integration/test_sql_redis_hybrid.py	Adds integration coverage for SQLQuery hybrid fusion via `FT.HYBRID` (including async).
pyproject.toml	Bumps `sql-redis` optional dependency minimum version to `>=0.7.0` (and in `all`).
docs/user_guide/12_sql_to_redis_queries.ipynb	Adds a “Hybrid search (FT.HYBRID)” section with an example using `hybrid_vector_search(...)`.
docs/proposals/sqlquery-ft-hybrid.md	Introduces a draft spec describing SQLQuery hybrid fusion support and expected behavior.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 6 out of 7 changed files in this pull request and generated 4 comments.

+""", params={"vec": embedding_bytes})
+```
+
+Requires Redis 8.4+ and `redis-py >= 7.1.0`.


+  },
+  {
+   "cell_type": "markdown",
+   "source": "### Hybrid search (FT.HYBRID)\n\nUse `hybrid_vector_search()` to fuse a full-text query and a vector query into a single ranking **server-side** with Redis's native `FT.HYBRID`. It composes the `cosine_distance()` (vector leg) and `fulltext()` (text leg) functions, with `rrf()` or `linear()` selecting the fusion method (reciprocal rank fusion or a linear weighting).\n\nThis differs from the *pre-filter* hybrid search above (a `WHERE` clause narrowing a KNN search): here both legs are ranked independently and fused, rather than text acting only as a filter.\n\n> Requires Redis 8.4+ and `redis-py >= 7.1.0`.",


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 6 out of 7 changed files in this pull request and generated 2 comments.

+    - ``hybrid_vector_search(cosine_distance(field, :vec), fulltext(field, 'query'), rrf())`` fuses a text and a vector query server-side via Redis ``FT.HYBRID``
+      (requires ``sql-redis >= 0.7.0``, Redis 8.4+, and redis-py >= 7.1.0). Use
+      ``rrf()`` or ``linear()`` to select the fusion method


+.. note::
+   SQLQuery supports hybrid search via ``hybrid_vector_search(cosine_distance(...), fulltext(...), rrf())``, which translates to a native Redis ``FT.HYBRID`` command
+   fusing a text and a vector query server-side. This is the SQL front-end to
+   :class:`HybridQuery` and requires ``sql-redis >= 0.7.0``, Redis 8.4+, and
+   redis-py >= 7.1.0.


abrookins

LGTM! 👍

applied-ai-release-bot · 2026-06-25T23:04:52Z

🚀 PR was released in v0.22.0 🚀

rbs333 added 2 commits June 24, 2026 09:28

chore(deps): require sql-redis>=0.7.0 for FT.HYBRID support

245d8ed

rbs333 requested review from Copilot and nkanu17 June 24, 2026 18:16

Copilot started reviewing on behalf of rbs333 June 24, 2026 18:16 View session

delete leftover

69df859

cursor Bot reviewed Jun 24, 2026

View reviewed changes

Comment thread pyproject.toml Outdated

Copilot AI reviewed Jun 24, 2026

View reviewed changes

Comment thread pyproject.toml

rbs333 added 2 commits June 24, 2026 14:30

docs: document hybrid_vector_search() in SQLQuery reference and concepts

b5bf054

update sql-redis

94a3b64

Copilot AI review requested due to automatic review settings June 24, 2026 19:54

Copilot started reviewing on behalf of rbs333 June 24, 2026 19:54 View session

Copilot AI reviewed Jun 24, 2026

View reviewed changes

includes fix from vishal on sql-redis

950a042

rbs333 added the auto:release Create a release when this PR is merged label Jun 25, 2026

Apply suggestions from code review

1e5bad8

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings June 25, 2026 22:57

Copilot started reviewing on behalf of rbs333 June 25, 2026 22:58 View session

Copilot AI reviewed Jun 25, 2026

View reviewed changes

abrookins approved these changes Jun 25, 2026

View reviewed changes

rbs333 merged commit 1605b88 into main Jun 25, 2026
53 of 58 checks passed

rbs333 deleted the feat/RAAE-1322/hybrid_support branch June 25, 2026 23:03

applied-ai-release-bot Bot added the released This issue/pull request has been released. label Jun 25, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Feat/raae 1322/hybrid support#639

Feat/raae 1322/hybrid support#639
rbs333 merged 7 commits into
mainfrom
feat/RAAE-1322/hybrid_support

rbs333 commented Jun 24, 2026 •

edited by cursor Bot

Loading

Uh oh!

jit-ci Bot commented Jun 24, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

abrookins left a comment

Uh oh!

Uh oh!

applied-ai-release-bot Bot commented Jun 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

rbs333 commented Jun 24, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jit-ci Bot commented Jun 24, 2026

🛡️ Jit Security Scan Results

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

abrookins left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

applied-ai-release-bot Bot commented Jun 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

rbs333 commented Jun 24, 2026 •

edited by cursor Bot

Loading