diff --git a/go/api/commands.go b/go/api/commands.go index 63a825e7bc..f48239c524 100644 --- a/go/api/commands.go +++ b/go/api/commands.go @@ -132,13 +132,7 @@ type StringCommands interface { // Sets multiple keys to multiple values in a single operation. // // Note: - // In cluster mode, if keys in `keyValueMap` map to different hash slots, - // the command will be split across these slots and executed separately for each. - // This means the command is atomic only at the slot level. If one or more slot-specific - // requests fail, the entire call will return the first encountered error, even - // though some requests may have succeeded while others did not. - // If this behavior impacts your application logic, consider splitting the - // request into sub-requests per slot to ensure atomicity. + // When in cluster mode, the command may route to multiple nodes when keys in keyValueMap map to different hash slots. // // See [valkey.io] for details. // @@ -159,13 +153,7 @@ type StringCommands interface { // Retrieves the values of multiple keys. // // Note: - // In cluster mode, if keys in `keys` map to different hash slots, - // the command will be split across these slots and executed separately for each. - // This means the command is atomic only at the slot level. If one or more slot-specific - // requests fail, the entire call will return the first encountered error, even - // though some requests may have succeeded while others did not. - // If this behavior impacts your application logic, consider splitting the - // request into sub-requests per slot to ensure atomicity. + // When in cluster mode, the command may route to multiple nodes when keys map to different hash slots. // // See [valkey.io] for details. // diff --git a/java/client/src/main/java/glide/api/commands/GenericBaseCommands.java b/java/client/src/main/java/glide/api/commands/GenericBaseCommands.java index 6fa8806c05..6234672899 100644 --- a/java/client/src/main/java/glide/api/commands/GenericBaseCommands.java +++ b/java/client/src/main/java/glide/api/commands/GenericBaseCommands.java @@ -23,14 +23,12 @@ public interface GenericBaseCommands { * Removes the specified keys from the database. A key is ignored if it does not * exist. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys we wanted to remove. * @return The number of keys that were removed. @@ -46,14 +44,12 @@ public interface GenericBaseCommands { * Removes the specified keys from the database. A key is ignored if it does not * exist. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys we wanted to remove. * @return The number of keys that were removed. @@ -68,14 +64,12 @@ public interface GenericBaseCommands { /** * Returns the number of keys in keys that exist in the database. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys list to check. * @return The number of keys that exist. If the same existing key is mentioned in keys @@ -91,14 +85,12 @@ public interface GenericBaseCommands { /** * Returns the number of keys in keys that exist in the database. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys list to check. * @return The number of keys that exist. If the same existing key is mentioned in keys @@ -117,14 +109,12 @@ public interface GenericBaseCommands { * specified keys and ignores non-existent ones. However, this command does not block the server, * while DEL does. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The list of keys to unlink. * @return The number of keys that were unlinked. @@ -142,14 +132,12 @@ public interface GenericBaseCommands { * specified keys and ignores non-existent ones. However, this command does not block the server, * while DEL does. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The list of keys to unlink. * @return The number of keys that were unlinked. @@ -988,14 +976,12 @@ CompletableFuture pexpireAt( /** * Updates the last access time of specified keys. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys to update last access time. * @return The number of keys that were updated. @@ -1010,14 +996,12 @@ CompletableFuture pexpireAt( /** * Updates the last access time of specified keys. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys to update last access time. * @return The number of keys that were updated. diff --git a/java/client/src/main/java/glide/api/commands/StringBaseCommands.java b/java/client/src/main/java/glide/api/commands/StringBaseCommands.java index 736c4d4eb3..20f13c30f2 100644 --- a/java/client/src/main/java/glide/api/commands/StringBaseCommands.java +++ b/java/client/src/main/java/glide/api/commands/StringBaseCommands.java @@ -249,14 +249,12 @@ public interface StringBaseCommands { /** * Retrieves the values of multiple keys. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys A list of keys to retrieve values for. * @return An array of values corresponding to the provided keys.
@@ -273,14 +271,12 @@ public interface StringBaseCommands { /** * Retrieves the values of multiple keys. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys A list of keys to retrieve values for. * @return An array of values corresponding to the provided keys.
@@ -297,14 +293,12 @@ public interface StringBaseCommands { /** * Sets multiple keys to multiple values in a single operation. * - * @apiNote In cluster mode, if keys in keyValueMap map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keyValueMap map to different hash slots, the + * command will be split across these slots and executed separately for each. This means the + * command is atomic only at the slot level. If one or more slot-specific requests fail, the + * entire call will return the first encountered error, even though some requests may have + * succeeded while others did not. If this behavior impacts your application logic, consider + * splitting the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keyValueMap A key-value map consisting of keys and their respective values to set. * @return A simple OK response. @@ -319,14 +313,12 @@ public interface StringBaseCommands { /** * Sets multiple keys to multiple values in a single operation. * - * @apiNote In cluster mode, if keys in keyValueMap map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keyValueMap map to different hash slots, the + * command will be split across these slots and executed separately for each. This means the + * command is atomic only at the slot level. If one or more slot-specific requests fail, the + * entire call will return the first encountered error, even though some requests may have + * succeeded while others did not. If this behavior impacts your application logic, consider + * splitting the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keyValueMap A key-value map consisting of keys and their respective values to set. * @return A simple OK response. diff --git a/java/client/src/main/java/glide/api/commands/TransactionsBaseCommands.java b/java/client/src/main/java/glide/api/commands/TransactionsBaseCommands.java index a519e38891..d4db27785e 100644 --- a/java/client/src/main/java/glide/api/commands/TransactionsBaseCommands.java +++ b/java/client/src/main/java/glide/api/commands/TransactionsBaseCommands.java @@ -15,14 +15,12 @@ public interface TransactionsBaseCommands { * will only execute commands if the watched keys are not modified before execution of the * transaction. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys to watch. * @return OK. @@ -47,14 +45,12 @@ public interface TransactionsBaseCommands { * will only execute commands if the watched keys are not modified before execution of the * transaction. * - * @apiNote In cluster mode, if keys in keys map to different hash slots, - * the command will be split across these slots and executed separately for each. - * This means the command is atomic only at the slot level. If one or more slot-specific - * requests fail, the entire call will return the first encountered error, even - * though some requests may have succeeded while others did not. - * If this behavior impacts your application logic, consider splitting the - * request into sub-requests per slot to ensure atomicity. - * + * @apiNote In cluster mode, if keys in keys map to different hash slots, the command + * will be split across these slots and executed separately for each. This means the command + * is atomic only at the slot level. If one or more slot-specific requests fail, the entire + * call will return the first encountered error, even though some requests may have succeeded + * while others did not. If this behavior impacts your application logic, consider splitting + * the request into sub-requests per slot to ensure atomicity. * @see valkey.io for details. * @param keys The keys to watch. * @return OK.