Операции с множествами
Последнее обновление
В Managed Valkey все управление множествами выполняется командами Valkey. С полным списком команд Valkey вы можете ознакомиться в официальной документации Valkey.
Обратите внимание, что в Managed Valkey некоторые команды Valkey недоступны.
Получить всех участников
Чтобы получить всех участников множества, используйте команду SMEMBERS.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните команду:
Команда вернет всех участников множества. Если ключ не существует, команда вернет пустой результат. Порядок участников не будет гарантирован. Данные множества сохранятся.
Для чтения большого множества по частям используйте итеративный обход.
Получить количество участников
Чтобы получить количество участников множества, используйте команду SCARD.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните команду:
Команда вернет количество участников множества. Если ключ не существует, команда вернет
0.
Получить случайных участников
Чтобы получить случайных участников множества, используйте команду SRANDMEMBER.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните команду:
В команде:
- Положительное
<количество>— получить не более указанного числа разных участников. - Отрицательное
<количество>— получить число участников, равное модулю значения, с возможными повторениями. - Если
<количество>не указано, будет выведен один случайный участник. 0— получить пустой список.
Команда вернет значение одного участника или список участников. Если ключ не существует, без количества вернется
nil, а с количеством — пустой список. Участники сохранятся в множестве.
Добавить участников
Чтобы добавить участников в множество, используйте команду SADD.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните команду:
Команда добавит участников и вернет количество добавленных участников. Значения, которые уже есть в множестве, не будут добавлены повторно и не будут учтены в ответе. Если ключ не существует, команда создаст множество.
Проверить принадлежность
Чтобы проверить принадлежность участника множеству, используйте команду SISMEMBER.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Узнайте имя участника из списка или через итеративный обход.
Выполните команду:
Команда вернет
1, если участник есть в множестве, и0, если участника или ключа не существует.
Переместить участника в другое множество
Чтобы переместить участника в другое множество, используйте команду SMOVE.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя исходного ключа с помощью итеративного обхода.
Узнайте имя существующего целевого ключа с помощью итеративного обхода.
Выберите имя для нового целевого ключа и убедитесь, что оно не занято.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Узнайте имя участника из списка или через итеративный обход.
Выполните команду:
Команда за одну операцию удалит участника из исходного множества, добавит в целевое и вернет
1. Если участник уже есть в целевом множестве, он будет только удален из исходного. Если целевой ключ отсутствует, при переносе будет создано множество.Если исходный ключ или участник не существует, команда вернет
0. После переноса последнего участника исходный ключ будет удален.
Получить пересечение, объединение или разность множеств
Чтобы получить пересечение, объединение или разность множеств, используйте одну из команд:
- SINTER — получить участников, которые есть во всех указанных множествах;
- SUNION — получить участников, которые есть хотя бы в одном множестве;
- SDIFF — получить участников первого множества, которых нет ни в одном из остальных.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните нужную команду:
- SINTER
- SUNION
- SDIFF
Команда вернет участников результата без повторений. Порядок участников не гарантирован. Исходные множества сохранятся. Несуществующие ключи будут учтены как пустые множества.
Получить пересечение, объединение или разность множеств и сохранить в ключ
Чтобы получить пересечение, объединение или разность множеств и сохранить в ключ, используйте одну из команд:
- SINTERSTORE — получить участников, которые есть во всех указанных множествах, и сохранить в ключ;
- SUNIONSTORE — получить участников, которые есть хотя бы в одном множестве, и сохранить в ключ;
- SDIFFSTORE — получить участников первого множества, которых нет ни в одном из остальных, и сохранить в ключ.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Для работы с существующими ключами узнайте их имена с помощью итеративного обхода.
Выберите отдельное имя целевого ключа. Проверьте, существует ли он. Прежнее значение будет заменено результатом.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Выполните нужную команду:
- SINTERSTORE
- SUNIONSTORE
- SDIFFSTORE
Команда сохранит результат как множество и вернет количество его участников. Существующий целевой ключ будет перезаписан независимо от типа значения. При пустом результате целевой ключ будет удален. Если нужно сохранить все исходные множества, укажите отдельное имя целевого ключа.
Итеративно обойти участников
Чтобы итеративно обойти участников множества, используйте команду SSCAN.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Начните обход с курсора
0:В команде
MATCH <шаблон>— отобрать участников по шаблону, аCOUNT <количество>— задать положительное целое число как ориентир объема работы за вызов. Количество результатов может отличаться от указанного.Команда вернет следующий курсор и список участников.
Подставляйте полученный курсор в следующий вызов. Используйте тот же ключ и условия отбора:
Обход завершится, когда команда вернет курсор
0. Если ключ не существует, сразу вернутся курсор0и пустой список.
Удалить участников
Чтобы удалить участников множества, используйте команду SREM.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Убедитесь, что значение ключа — множество. Должно вернуться значение
set.Узнайте имена участников.
Выполните команду:
Команда удалит указанных участников и вернет количество удаленных участников. Несуществующие участники будут пропущены. Если ключ не существует, команда вернет
0. После удаления последнего участника ключ множества будет удален.