From 1cc5a670ef667e9e248f2519bf4a78694b5c3e2c Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:15:22 +0100 Subject: [PATCH 1/8] DOC-5362 added dialect 2 notes for C# --- content/develop/clients/dotnet/queryjson.md | 8 ++++++++ content/develop/clients/dotnet/vecsearch.md | 7 +++++++ 2 files changed, 15 insertions(+) diff --git a/content/develop/clients/dotnet/queryjson.md b/content/develop/clients/dotnet/queryjson.md index e643e3ed1..cbd6cdc09 100644 --- a/content/develop/clients/dotnet/queryjson.md +++ b/content/develop/clients/dotnet/queryjson.md @@ -22,6 +22,14 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From v1.0.0 onwards, `NRedisStack` uses query dialect 2 by default. +Redis query engine methods such as [`FT().Search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack" >}}) diff --git a/content/develop/clients/dotnet/vecsearch.md b/content/develop/clients/dotnet/vecsearch.md index 31ffcbf3a..9e2f5cec8 100644 --- a/content/develop/clients/dotnet/vecsearch.md +++ b/content/develop/clients/dotnet/vecsearch.md @@ -36,6 +36,13 @@ for the embeddings. The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From v1.0.0 onwards, `NRedisStack` uses query dialect 2 by default. +Redis query engine methods such as [`FT().Search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} ## Initialize The example is probably easiest to follow if you start with a new From 95941fb086220172e1ca3f1654f403906d502566 Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:19:59 +0100 Subject: [PATCH 2/8] DOC-5362 added Go notes --- content/develop/clients/go/queryjson.md | 9 +++++++++ content/develop/clients/go/vecsearch.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/content/develop/clients/go/queryjson.md b/content/develop/clients/go/queryjson.md index 922aba320..fdc2cd4a9 100644 --- a/content/develop/clients/go/queryjson.md +++ b/content/develop/clients/go/queryjson.md @@ -22,6 +22,15 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From [v9.8.0](https://github.com/redis/go-redis/releases/tag/v9.8.0) onwards, +`go-redis` uses query dialect 2 by default. +Redis query engine methods such as [`FTSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack/" >}}) diff --git a/content/develop/clients/go/vecsearch.md b/content/develop/clients/go/vecsearch.md index 0dc6dfc25..8fc09379b 100644 --- a/content/develop/clients/go/vecsearch.md +++ b/content/develop/clients/go/vecsearch.md @@ -36,6 +36,15 @@ Redis Query Engine. The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From [v9.8.0](https://github.com/redis/go-redis/releases/tag/v9.8.0) onwards, +`go-redis` uses query dialect 2 by default. +Redis query engine methods such as [`FTSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Start a new Go module with the following command: From 3af839d15068b00f6cc2a0a7e3f24a869de4019b Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:22:03 +0100 Subject: [PATCH 3/8] DOC-5362 added version link to C# notes --- content/develop/clients/dotnet/queryjson.md | 3 ++- content/develop/clients/dotnet/vecsearch.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/content/develop/clients/dotnet/queryjson.md b/content/develop/clients/dotnet/queryjson.md index cbd6cdc09..df888907b 100644 --- a/content/develop/clients/dotnet/queryjson.md +++ b/content/develop/clients/dotnet/queryjson.md @@ -22,7 +22,8 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. -{{< note >}}From v1.0.0 onwards, `NRedisStack` uses query dialect 2 by default. +{{< note >}}From [v1.0.0](https://github.com/redis/NRedisStack/releases/tag/v1.0.0) +onwards, `NRedisStack` uses query dialect 2 by default. Redis query engine methods such as [`FT().Search()`]({{< relref "/commands/ft.search" >}}) will explicitly request this dialect, overriding the default set for the server. See diff --git a/content/develop/clients/dotnet/vecsearch.md b/content/develop/clients/dotnet/vecsearch.md index 9e2f5cec8..5644dd6d9 100644 --- a/content/develop/clients/dotnet/vecsearch.md +++ b/content/develop/clients/dotnet/vecsearch.md @@ -36,7 +36,8 @@ for the embeddings. The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). -{{< note >}}From v1.0.0 onwards, `NRedisStack` uses query dialect 2 by default. +{{< note >}}From [v1.0.0](https://github.com/redis/NRedisStack/releases/tag/v1.0.0) +onwards, `NRedisStack` uses query dialect 2 by default. Redis query engine methods such as [`FT().Search()`]({{< relref "/commands/ft.search" >}}) will explicitly request this dialect, overriding the default set for the server. See From bbb3d83b97b2fa39371684109d589d57c637147a Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:24:50 +0100 Subject: [PATCH 4/8] DOC-5362 added Jedis notes --- content/develop/clients/jedis/queryjson.md | 9 +++++++++ content/develop/clients/jedis/vecsearch.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/content/develop/clients/jedis/queryjson.md b/content/develop/clients/jedis/queryjson.md index 328485c8e..fbec87836 100644 --- a/content/develop/clients/jedis/queryjson.md +++ b/content/develop/clients/jedis/queryjson.md @@ -22,6 +22,15 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From [v6.0.0](https://github.com/redis/jedis/releases/tag/v6.0.0) onwards, +`Jedis` uses query dialect 2 by default. +Redis query engine methods such as [`ftSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack/" >}}) diff --git a/content/develop/clients/jedis/vecsearch.md b/content/develop/clients/jedis/vecsearch.md index 3132352c7..b94a663f9 100644 --- a/content/develop/clients/jedis/vecsearch.md +++ b/content/develop/clients/jedis/vecsearch.md @@ -35,6 +35,15 @@ The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From [v6.0.0](https://github.com/redis/jedis/releases/tag/v6.0.0) onwards, +`Jedis` uses query dialect 2 by default. +Redis query engine methods such as [`ftSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize If you are using [Maven](https://maven.apache.org/), add the following From 71efa007c120b6bd06633012aa67a5c52b3b84b0 Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:27:46 +0100 Subject: [PATCH 5/8] DOC-5362 added node-redis notes --- content/develop/clients/nodejs/queryjson.md | 9 +++++++++ content/develop/clients/nodejs/vecsearch.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/content/develop/clients/nodejs/queryjson.md b/content/develop/clients/nodejs/queryjson.md index 085a44a19..2bec9ed3e 100644 --- a/content/develop/clients/nodejs/queryjson.md +++ b/content/develop/clients/nodejs/queryjson.md @@ -22,6 +22,15 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From [v5.0.0](https://github.com/redis/node-redis/releases/tag/redis%405.0.0) +onwards, `node-redis` uses query dialect 2 by default. +Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack/" >}}) diff --git a/content/develop/clients/nodejs/vecsearch.md b/content/develop/clients/nodejs/vecsearch.md index be3de0084..bf823c424 100644 --- a/content/develop/clients/nodejs/vecsearch.md +++ b/content/develop/clients/nodejs/vecsearch.md @@ -35,6 +35,15 @@ Redis Query Engine. The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From [v5.0.0](https://github.com/redis/node-redis/releases/tag/redis%405.0.0) +onwards, `node-redis` uses query dialect 2 by default. +Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Install the required dependencies: From 26c1cbfc0ad7d5bbbff10b114f1954481589ed73 Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:30:26 +0100 Subject: [PATCH 6/8] DOC-5362 added Predis notes --- content/develop/clients/php/queryjson.md | 9 +++++++++ content/develop/clients/php/vecsearch.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/content/develop/clients/php/queryjson.md b/content/develop/clients/php/queryjson.md index 6d5187ea6..07ea66221 100644 --- a/content/develop/clients/php/queryjson.md +++ b/content/develop/clients/php/queryjson.md @@ -22,6 +22,15 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From [v3.0.0](https://github.com/predis/predis/releases/tag/v3.0.0) onwards, +`Predis` uses query dialect 2 by default. +Redis query engine methods such as [`ftSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack/" >}}) diff --git a/content/develop/clients/php/vecsearch.md b/content/develop/clients/php/vecsearch.md index e44aa090a..2167c5069 100644 --- a/content/develop/clients/php/vecsearch.md +++ b/content/develop/clients/php/vecsearch.md @@ -35,6 +35,15 @@ The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From [v3.0.0](https://github.com/predis/predis/releases/tag/v3.0.0) onwards, +`Predis` uses query dialect 2 by default. +Redis query engine methods such as [`ftSearch()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize You can use the [TransformersPHP](https://transformers.codewithkyrian.com/) From ccf7155c804a955672afa10ef1c2e381cc48abce Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 11:32:42 +0100 Subject: [PATCH 7/8] DOC-5362 added redis-py notes --- content/develop/clients/redis-py/queryjson.md | 9 +++++++++ content/develop/clients/redis-py/vecsearch.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/content/develop/clients/redis-py/queryjson.md b/content/develop/clients/redis-py/queryjson.md index 571a048a7..2a8ec7d28 100644 --- a/content/develop/clients/redis-py/queryjson.md +++ b/content/develop/clients/redis-py/queryjson.md @@ -22,6 +22,15 @@ run queries against the index. It then goes on to show the slight differences in the equivalent code for [hash]({{< relref "/develop/data-types/hashes" >}}) documents. +{{< note >}}From [v6.0.0](https://github.com/redis/redis-py/releases/tag/v6.0.0) onwards, +`redis-py` uses query dialect 2 by default. +Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Make sure that you have [Redis Open Source]({{< relref "/operate/oss_and_stack/" >}}) diff --git a/content/develop/clients/redis-py/vecsearch.md b/content/develop/clients/redis-py/vecsearch.md index ca3565e71..b442e8f07 100644 --- a/content/develop/clients/redis-py/vecsearch.md +++ b/content/develop/clients/redis-py/vecsearch.md @@ -35,6 +35,15 @@ Redis Query Engine. The code is first demonstrated for hash documents with a separate section to explain the [differences with JSON documents](#differences-with-json-documents). +{{< note >}}From [v6.0.0](https://github.com/redis/redis-py/releases/tag/v6.0.0) onwards, +`redis-py` uses query dialect 2 by default. +Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +will explicitly request this dialect, overriding the default set for the server. +See +[Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) +for more information. +{{< /note >}} + ## Initialize Install [`redis-py`]({{< relref "/develop/clients/redis-py" >}}) if you From e17be325d88b4ca4235c224867c4767006c01e0e Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Tue, 24 Jun 2025 14:50:05 +0100 Subject: [PATCH 8/8] DOC-5362 correction to Python ft().search() syntax --- content/develop/clients/redis-py/queryjson.md | 2 +- content/develop/clients/redis-py/vecsearch.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/develop/clients/redis-py/queryjson.md b/content/develop/clients/redis-py/queryjson.md index 2a8ec7d28..e5d8784b2 100644 --- a/content/develop/clients/redis-py/queryjson.md +++ b/content/develop/clients/redis-py/queryjson.md @@ -24,7 +24,7 @@ documents. {{< note >}}From [v6.0.0](https://github.com/redis/redis-py/releases/tag/v6.0.0) onwards, `redis-py` uses query dialect 2 by default. -Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +Redis query engine methods such as [`ft().search()`]({{< relref "/commands/ft.search" >}}) will explicitly request this dialect, overriding the default set for the server. See [Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}}) diff --git a/content/develop/clients/redis-py/vecsearch.md b/content/develop/clients/redis-py/vecsearch.md index b442e8f07..ba08cfabb 100644 --- a/content/develop/clients/redis-py/vecsearch.md +++ b/content/develop/clients/redis-py/vecsearch.md @@ -37,7 +37,7 @@ separate section to explain the {{< note >}}From [v6.0.0](https://github.com/redis/redis-py/releases/tag/v6.0.0) onwards, `redis-py` uses query dialect 2 by default. -Redis query engine methods such as [`ft.search()`]({{< relref "/commands/ft.search" >}}) +Redis query engine methods such as [`ft().search()`]({{< relref "/commands/ft.search" >}}) will explicitly request this dialect, overriding the default set for the server. See [Query dialects]({{< relref "/develop/interact/search-and-query/advanced-concepts/dialects" >}})