Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow by/get of sort(ro) in cluster mode. #2611

Merged
merged 3 commits into from
Mar 1, 2024
Merged

Allow by/get of sort(ro) in cluster mode. #2611

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2fb4cad
Allow by/get of sort(ro) in cluster mode.
CharlesChen888 Nov 29, 2023
694b973
Mention before 8.0, by/get is not allowed in cluster mode.
CharlesChen888 Nov 30, 2023
5f30364
Add a link to hash tag page.
CharlesChen888 Mar 1, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions commands/sort.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -105,8 +105,11 @@ SORT mylist BY weight_* GET object_* GET #

## Restrictions for using external keys

When enabling `Redis cluster-mode` there is no way to guarantee the existence of the external keys on the node which the command is processed on.
In this case, any use of `GET` or `BY` which reference external key pattern will cause the command to fail with an error.
Before 8.0, when enabling `Redis cluster-mode` there is no way to guarantee the existence of the external keys on the node which the command is processed on. In this case, any use of `GET` or `BY` which reference external key pattern will cause the command to fail with an error.

Starting from 8.0, pattern with hash tag can be mapped to a slot, and so in `Redis cluster-mode`, the use of `BY` or `GET` is allowed when pattern contains hash tag and implies a specific slot which the key is also in, which means any key matching this pattern must be in the same slot as the key, and therefore in the same node. For example, in cluster mode, `{mylist}weight_*` is acceptable as a pattern when sorting `mylist`, while pattern `{abc}weight_*` will be denied, causing the command to fail with an error.

To use pattern with hash tag, see https://redis.io/docs/reference/cluster-spec/#hash-tags for more information.

Starting from Redis 7.0, any use of `GET` or `BY` which reference external key pattern will only be allowed in case the current user running the command has full key read permissions.
Full key read permissions can be set for the user by, for example, specifying `'%R~*'` or `'~*` with the relevant command access rules.
Expand Down
Loading