Add support for FT.DROPINDEX #2722 (#3164)

tishun · tishun · commit 8d9f33ced16c · 2025-06-05T18:58:11.000+03:00
* Add support for FT.DROPINDEX #2722 * Polishing
diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
@@ -8,10 +8,12 @@ on:
     branches:
       - main
       - '[0-9].*'
+      - 'feature/*'
   pull_request:
     branches:
       - main
       - '[0-9].*'
+      - 'feature/*'
   schedule:
     - cron: '0 1 * * *' # nightly build
   workflow_dispatch:
diff --git a/src/main/java/io/lettuce/core/AbstractRedisAsyncCommands.java b/src/main/java/io/lettuce/core/AbstractRedisAsyncCommands.java
@@ -1530,6 +1530,11 @@ public RedisFuture<String> ftCreate(K index, CreateArgs<K, V> options, List<Fiel
         return dispatch(searchCommandBuilder.ftCreate(index, options, fields));
     }
 
+    @Override
+    public RedisFuture<String> ftDropindex(K index, boolean deleteDocumentKeys) {
+        return dispatch(searchCommandBuilder.ftDropindex(index, deleteDocumentKeys));
+    }
+
     @Override
     public RedisFuture<List<Long>> jsonArrappend(K key, JsonPath jsonPath, JsonValue... values) {
         return dispatch(jsonCommandBuilder.jsonArrappend(key, jsonPath, values));
diff --git a/src/main/java/io/lettuce/core/AbstractRedisReactiveCommands.java b/src/main/java/io/lettuce/core/AbstractRedisReactiveCommands.java
@@ -1595,6 +1595,11 @@ public Mono<String> ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> f
         return createMono(() -> searchCommandBuilder.ftCreate(index, options, fields));
     }
 
+    @Override
+    public Mono<String> ftDropindex(K index, boolean deleteDocumentKeys) {
+        return createMono(() -> searchCommandBuilder.ftDropindex(index, deleteDocumentKeys));
+    }
+
     @Override
     public Flux<Long> jsonArrappend(K key, JsonPath jsonPath, JsonValue... values) {
         return createDissolvingFlux(() -> jsonCommandBuilder.jsonArrappend(key, jsonPath, values));
diff --git a/src/main/java/io/lettuce/core/RediSearchCommandBuilder.java b/src/main/java/io/lettuce/core/RediSearchCommandBuilder.java
@@ -12,6 +12,7 @@
 import io.lettuce.core.protocol.Command;
 import io.lettuce.core.protocol.CommandArgs;
 import io.lettuce.core.protocol.CommandKeyword;
+import io.lettuce.core.protocol.RedisCommand;
 import io.lettuce.core.search.arguments.CreateArgs;
 import io.lettuce.core.search.Field;
 
@@ -60,4 +61,23 @@ public Command<K, V, String> ftCreate(K index, CreateArgs<K, V> createArgs, List
 
     }
 
+    /**
+     * Drop the index with the given name.
+     *
+     * @param index the index name
+     * @param deleteDocumentKeys whether to delete the document keys
+     * @return the result of the drop command
+     */
+    public Command<K, V, String> ftDropindex(K index, boolean deleteDocumentKeys) {
+        notNullKey(index);
+
+        CommandArgs<K, V> args = new CommandArgs<>(codec).addKey(index);
+
+        if (deleteDocumentKeys) {
+            args.add(CommandKeyword.DD);
+        }
+
+        return createCommand(FT_DROPINDEX, new StatusOutput<>(codec), args);
+    }
+
 }
diff --git a/src/main/java/io/lettuce/core/api/async/RediSearchAsyncCommands.java b/src/main/java/io/lettuce/core/api/async/RediSearchAsyncCommands.java
@@ -35,4 +35,21 @@ public interface RediSearchAsyncCommands<K, V> {
      */
     RedisFuture<String> ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    RedisFuture<String> ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/main/java/io/lettuce/core/api/reactive/RediSearchReactiveCommands.java b/src/main/java/io/lettuce/core/api/reactive/RediSearchReactiveCommands.java
@@ -35,4 +35,21 @@ public interface RediSearchReactiveCommands<K, V> {
      */
     Mono<String> ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    Mono<String> ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/main/java/io/lettuce/core/api/sync/RediSearchCommands.java b/src/main/java/io/lettuce/core/api/sync/RediSearchCommands.java
@@ -34,4 +34,21 @@ public interface RediSearchCommands<K, V> {
      */
     String ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    String ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/main/java/io/lettuce/core/cluster/api/async/RediSearchAsyncCommands.java b/src/main/java/io/lettuce/core/cluster/api/async/RediSearchAsyncCommands.java
@@ -34,4 +34,21 @@ public interface RediSearchAsyncCommands<K, V> {
      */
     AsyncExecutions<String> ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    AsyncExecutions<String> ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/main/java/io/lettuce/core/cluster/api/sync/RediSearchCommands.java b/src/main/java/io/lettuce/core/cluster/api/sync/RediSearchCommands.java
@@ -34,4 +34,21 @@ public interface RediSearchCommands<K, V> {
      */
     Executions<String> ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    Executions<String> ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/main/java/io/lettuce/core/protocol/CommandKeyword.java b/src/main/java/io/lettuce/core/protocol/CommandKeyword.java
@@ -55,7 +55,7 @@ CAS, EF, ELE, SETATTR, M, NOQUANT, BIN, Q8, FILTER, FILTER_EF("FILTER-EF"), TRUT
 
     MAXTEXTFIELDS, PREFIX, LANGUAGE, LANGUAGE_FIELD, SCORE, SCORE_FIELD, PAYLOAD_FIELD, TEMPORARY, NOOFFSETS, NOHL, NOFIELDS, NOFREQS, SKIPINITIALSCAN, STOPWORDS, AS, SORTABLE, SCHEMA, UNF, NOINDEX,
 
-    NOSTEM, PHONETIC, WEIGHT, SEPARATOR, CASESENSITIVE, WITHSUFFIXTRIE, INDEXEMPTY, INDEXMISSING;
+    NOSTEM, PHONETIC, WEIGHT, SEPARATOR, CASESENSITIVE, WITHSUFFIXTRIE, INDEXEMPTY, INDEXMISSING, DD;
 
     public final byte[] bytes;
 
diff --git a/src/main/java/io/lettuce/core/protocol/CommandType.java b/src/main/java/io/lettuce/core/protocol/CommandType.java
@@ -117,7 +117,7 @@ public enum CommandType implements ProtocolKeyword {
     VADD, VCARD, VDIM, VEMB, VEMBRAW, VGETATTR, VINFO, VLINKS, VLINKSWITHSCORES, VRANDMEMBER, VREM, VSETATTR, VSIM, VSIMWITHSCORES,
 
     // RediSearch
-    FT_CREATE("FT.CREATE"),
+    FT_CREATE("FT.CREATE"), FT_DROPINDEX("FT.DROPINDEX"),
 
     // Others
 
diff --git a/src/main/kotlin/io/lettuce/core/api/coroutines/RediSearchCoroutinesCommands.kt b/src/main/kotlin/io/lettuce/core/api/coroutines/RediSearchCoroutinesCommands.kt
@@ -37,5 +37,22 @@ interface RediSearchCoroutinesCommands<K : Any, V : Any> {
      */
     suspend fun ftCreate(index: K, options: CreateArgs<K, V>, fields: List<Field<K>>): String?
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    suspend fun ftDropindex(index: K, deleteDocuments: Boolean): String?
+
 }
 
diff --git a/src/main/templates/io/lettuce/core/api/RediSearchCommands.java b/src/main/templates/io/lettuce/core/api/RediSearchCommands.java
@@ -34,4 +34,21 @@ public interface RediSearchCommands<K, V> {
      */
     String ftCreate(K index, CreateArgs<K, V> options, List<Field<K>> fields);
 
+    /**
+     * Drop an index.
+     * <p/>
+     * By default, <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a> does not delete the documents
+     * associated with the index. Adding the <code>deleteDocuments</code> option deletes the documents as well. If an index
+     * creation is still running (<a href="https://redis.io/docs/latest/commands/ft.create/">FT.CREATE</a> is running
+     * asynchronously), only the document hashes that have already been indexed are deleted. The document hashes left to be
+     * indexed remain in the database.
+     *
+     * @param index the index name, as a key
+     * @param deleteDocuments if true, delete the documents as well
+     * @return the result of the drop command
+     * @since 6.6
+     * @see <a href="https://redis.io/docs/latest/commands/ft.dropindex/">FT.DROPINDEX</a>
+     */
+    String ftDropindex(K index, boolean deleteDocuments);
+
 }
diff --git a/src/test/java/io/lettuce/core/RediSearchCommandBuilderUnitTests.java b/src/test/java/io/lettuce/core/RediSearchCommandBuilderUnitTests.java
@@ -89,4 +89,26 @@ void shouldCorrectlyConstructFtCreateCommandScenario2() {
         assertThat(buf.toString(StandardCharsets.UTF_8)).isEqualTo(result);
     }
 
+    @Test
+    void shouldCorrectlyConstructFtDropindexCommand() {
+        Command<String, String, String> command = builder.ftDropindex(MY_KEY, false);
+        ByteBuf buf = Unpooled.directBuffer();
+        command.encode(buf);
+
+        String result = "*2\r\n" + "$12\r\n" + "FT.DROPINDEX\r\n" + "$3\r\n" + MY_KEY + "\r\n";
+
+        assertThat(buf.toString(StandardCharsets.UTF_8)).isEqualTo(result);
+    }
+
+    @Test
+    void shouldCorrectlyConstructFtDropindexCommandDd() {
+        Command<String, String, String> command = builder.ftDropindex(MY_KEY, true);
+        ByteBuf buf = Unpooled.directBuffer();
+        command.encode(buf);
+
+        String result = "*3\r\n" + "$12\r\n" + "FT.DROPINDEX\r\n" + "$3\r\n" + MY_KEY + "\r\n" + "$2\r\n" + "DD\r\n";
+
+        assertThat(buf.toString(StandardCharsets.UTF_8)).isEqualTo(result);
+    }
+
 }
diff --git a/src/test/java/io/lettuce/core/cluster/AsyncConnectionProviderIntegrationTests.java b/src/test/java/io/lettuce/core/cluster/AsyncConnectionProviderIntegrationTests.java
@@ -23,6 +23,7 @@
 import static org.assertj.core.api.Assertions.*;
 
 import java.io.IOException;
+import java.net.ConnectException;
 import java.net.InetSocketAddress;
 import java.net.ServerSocket;
 import java.net.Socket;
@@ -151,12 +152,12 @@ void connectShouldFail() throws Exception {
         StopWatch stopWatch = new StopWatch();
 
         assertThatThrownBy(() -> TestFutures.awaitOrTimeout(sut.getConnection(connectionKey)))
-                .hasCauseInstanceOf(ConnectTimeoutException.class);
+                .hasRootCauseInstanceOf(ConnectException.class);
 
         stopWatch.start();
 
         assertThatThrownBy(() -> TestFutures.awaitOrTimeout(sut.getConnection(connectionKey)))
-                .hasCauseInstanceOf(ConnectTimeoutException.class);
+                .hasRootCauseInstanceOf(ConnectException.class);
 
         stopWatch.stop();
 
diff --git a/src/test/java/io/lettuce/core/json/RediSearchIntegrationTests.java b/src/test/java/io/lettuce/core/json/RediSearchIntegrationTests.java
@@ -8,6 +8,7 @@
 package io.lettuce.core.json;
 
 import io.lettuce.core.RedisClient;
+import io.lettuce.core.RedisCommandExecutionException;
 import io.lettuce.core.RedisContainerIntegrationTests;
 import io.lettuce.core.RedisURI;
 import io.lettuce.core.api.sync.RedisCommands;
@@ -26,6 +27,7 @@
 
 import static io.lettuce.TestTags.INTEGRATION_TEST;
 import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
 
 @Tag(INTEGRATION_TEST)
 public class RediSearchIntegrationTests extends RedisContainerIntegrationTests {
@@ -79,6 +81,9 @@ void ftCreateScenario1() {
 
         String result = redis.ftCreate(GENERIC_INDEX, createArgs, Arrays.asList(field1, field2, field3));
         assertThat(result).isEqualTo("OK");
+
+        result = redis.ftDropindex(GENERIC_INDEX, false);
+        assertThat(result).isEqualTo("OK");
     }
 
 }
