INCRBY

将键的整数值增加一个数字。如果键不存在，则使用 0 作为初始值。

语法

INCRBY key increment

引入版本：1.0.0

复杂度摘要：O(1)

将 key 中存储的数字增加 increment。如果该键不存在，则在执行操作之前将其设置为 0。如果键包含错误类型的值或包含无法表示为整数的字符串，则会返回错误。此操作仅限于 64 位有符号整数。

有关递增/递减操作的更多信息，请参阅 INCR。

必需参数

key

键名称。

increment

要添加到该值的整数金额。

示例

redis> SET mykey "10"
OK
redis> INCRBY mykey 5
(integer) 15

Redis Software 与 Redis Cloud 兼容性

Redis
软件		 Redis
Cloud		 说明
✅ 标准
✅ 主动-主动		 ✅ 标准
✅ 主动-主动

返回值

RESP2

整数回复：递增后key的值。

RESP3

整数回复：递增后key的值。

资料来源：Redis 官方 INCRBY 文档；中文内容参考 Redis 文档许可。