Операции со строками
Последнее обновление
В Managed Valkey все управление строками выполняется командами Valkey. С полным списком команд Valkey вы можете ознакомиться в официальной документации Valkey.
Обратите внимание, что в Managed Valkey некоторые команды Valkey недоступны.
Записать строковое значение
Чтобы записать значение ключа, используйте команду SET.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Убедитесь, что ключ имеет строковое значение.
Выполните команду:
В команде:
EX <секунды>— установить срок жизни в секундах.PX <миллисекунды>— установить срок жизни в миллисекундах.EXAT <метка времени в секундах>— установить срок жизни до метки времени в секундах.PXAT <метка времени в миллисекундах>— установить срок жизни до метки времени в миллисекундах.NX— записать значение, только если ключ не существует.XX— записать значение, только если ключ существует.KEEPTTL— сохранить текущий срок жизни ключа.GET— вернуть предыдущее значение ключа.
При успешной записи вернется ответ
OK. Если параметрGETне указан, при успешной записи вернетсяOK, при невыполнении условийNXилиXXвернется значениеnil. Если параметрGETуказан, вернется прежнее строковое значение или, если ключ прежде отсутствовал —nil. Если предыдущее значение — нестроковое, вернется ошибка. При успешной записи, если не указан параметрKEEPTTL, прежний TTL будет сброшен.
Прочитать строковое значение
Чтобы прочитать значение ключа, используйте команду GET.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Выполните команду:
Команда вернет значение ключа. Если ключ не существует, команда вернет значение
nil. Если ключ содержит значение не строкового типа, команда вернет ошибку.
Записать несколько строковых значений
Чтобы записать значения нескольких ключей за одну операцию, используйте команду MSET.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Выполните команду:
При успешном выполнении вернется ответ
OK. Команда перезапишет значения всех указанных ключей за одну операцию.
Прочитать несколько строковых значений
Чтобы прочитать значения нескольких ключей за одну операцию, используйте команду MGET.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Выполните команду:
Команда вернет список значений в том же порядке, в котором были указаны ключи. Для несуществующих ключей вернется ответ
nil. Если ключ содержит значение не строкового типа, для него вернется ответnil, и ошибка не возникнет.
Дописать строковое значение ключа в конец строки
Чтобы добавить значение ключа в конец существующей строки, используйте команду APPEND.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Выполните команду:
Если ключ существует, значение допишется в конец строки. Если ключ не существует, команда создаст его и запишет указанное значение. Вернется длина строки после операции. Если ключ содержит значение не строкового типа, команда вернет ошибку.
Получить длину строки
Для получения длины строки используйте команду STRLEN.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Выполните команду:
Команда вернет длину строки в байтах. Если ключ не существует, вернется
0. Если ключ содержит значение не строкового типа, команда вернет ошибку.
Получить часть строки
Чтобы получить часть строки, используйте команду GETRANGE.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Выполните команду:
В команде
<начало>,<конец>— индексы начала и конца подстроки. Включаются обе границы. Индексы могут быть отрицательными:−1— последний символ,−2— предпоследний символ и так далее.Команда вернет подстроку. Если ключ содержит значение не строкового типа, команда вернет ошибку.
Заменить часть строки
Чтобы заменить часть строки, используйте команду SETRANGE.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Узнайте имя ключа с помощью итеративного обхода.
Выполните команду:
В команде:
<смещение>— позиция, с которой начинается замена;<значение>— строка, которой заменяется часть исходной строки.
Смещение отсчитывается в байтах от
0, а длина результата также возвращается в байтах.Команда заменит часть строки, начиная с указанного смещения, и вернет длину строки после замены. Если смещение больше длины строки, строка дополнится нулевыми байтами. Если ключ содержит значение не строкового типа, команда вернет ошибку.
Увеличить числовое значение
Чтобы увеличить числовое значение ключа, используйте одну из команд:
- INCR — увеличивает значение на 1;
- INCRBY — увеличивает значение на указанный шаг;
- INCRBYFLOAT — увеличивает число с плавающей точкой.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Выполните нужную команду:
- INCR
- INCRBY
- INCRBYFLOAT
Если значение ключа не является числом, является дробным или выходит за пределы допустимого диапазона, команда вернет ошибку.
В командах
<шаг>— значение, на которое нужно увеличить или уменьшить число.Если ключ не существует, он будет создан со значением
0перед выполнением операции. Если значение ключа не является числом, команда вернет ошибку. Если ключ содержит значение не строкового типа, команда вернет ошибку. Команда вернет новое значение ключа после увеличения.
Уменьшить числовое значение
Чтобы уменьшить числовое значение ключа, используйте одну из команд:
- DECR — уменьшает значение на 1;
- DECRBY — уменьшает значение на указанный шаг;
- INCRBYFLOAT — уменьшает число с плавающей точкой.
Подключитесь к кластеру.
Переключитесь на нужную базу данных.
Выполните нужную команду:
- DECR
- DECRBY
- INCRBYFLOAT
Если значение ключа не является числом, является дробным или выходит за пределы допустимого диапазона, команда вернет ошибку.
В командах
<шаг>— значение, на которое нужно увеличить или уменьшить число.Если ключ не существует, он будет создан со значением
0перед выполнением операции. Если значение ключа не является числом, команда вернет ошибку. Если ключ содержит значение не строкового типа, команда вернет ошибку. Команда вернет новое значение ключа после уменьшения.