- j3_liuliang
- Redis常用API即應用場景開始系列(String),如果覺得有用可以關注博主,不定時更新哦!
一、字串(String)
1.1 SETNX(setnx)
只有在 key 不存在時設定 key 的值,
Redis Setnx(SET if Not eXists) 命令在指定的 key 不存在時,為 key 設定指定的值,
語法
127.0.0.1:6379> SETNX KEY_NAME VALUE
可以版本:>= 1.0.0
回傳值:設定成功,回傳 1 , 設定失敗,回傳 0 ,
案例
127.0.0.1:6379> flushall #清空資料庫
OK
127.0.0.1:6379> exists j3-liuliang 18 #查看key是否存在
(integer) 0
127.0.0.1:6379> setnx j3-liuliang 18 #設定key并賦值
(integer) 1
127.0.0.1:6379> setnx j3-liuliang 28 #嘗試覆寫key
(integer) 0 #覆寫失敗
127.0.0.1:6379> get j3-liuliang #key沒有變化
"18"
127.0.0.1:6379>
1.2 GETRANGE(getrange )
回傳key中字串值得子字符
Redis Getrange 命令用于獲取存盤在指定 key 中字串的子字串,字串的截取范圍由 start 和 end 兩個偏移量決定(包括 start 和 end 在內),
語法
127.0.0.1:6379> GETRANGE KEY_NAME start end
可以版本:>= 2.4.0
回傳值:截取得到的子字串,
案例
127.0.0.1:6379> flushall #清空資料庫
OK
127.0.0.1:6379> set j3-liuliang "This is my test key" #設定key并賦值
OK
127.0.0.1:6379> getrange j3-liuliang 0 3 #截取key部分內容
"This"
127.0.0.1:6379> getrange j3-liuliang 6 9
"s my"
127.0.0.1:6379> getrange j3-liuliang 0 -1 #截取key得所有內容
"This is my test key"
127.0.0.1:6379>
1.3 MSET(mset)
同時設定一個或多個 key-value 對,
Redis Mset 命令用于同時設定一個或多個 key-value 對,
語法
127.0.0.1:6379> MSET key1 value1 key2 value2 .. keyN valueN
可以版本:>= 1.0.1
回傳值:總是回傳 OK ,
案例
127.0.0.1:6379> mset k1 v1 k2 v2 k3 v3 #同時設定多個key value對
OK
127.0.0.1:6379> get k1 #獲取值
"v1"
127.0.0.1:6379> get k2
"v2"
127.0.0.1:6379> get k3
"v3"
127.0.0.1:6379>
1.4 SETEX(setex)
將值 value 關聯到 key ,并將 key 的過期時間設為 seconds (以秒為單位),
Redis Setex 命令為指定的 key 設定值及其過期時間,如果 key 已經存在, SETEX 命令將會替換舊的值,
語法
127.0.0.1:6379> SETEX KEY_NAME TIMEOUT VALUE
可以版本:>= 2.0.0
回傳值:設定成功時回傳 OK ,
案例
127.0.0.1:6379> flushall #清空資料庫
OK
127.0.0.1:6379> set j3-liuliang 18 #設定key并賦值
OK
127.0.0.1:6379> get j3-liuliang #獲取可以得值
"18"
127.0.0.1:6379> setex j3-liuliang 60 28 #設定key如果key存在就覆寫,且設定過期時間60秒,新值28
OK
127.0.0.1:6379> ttl j3-liuliang #查看剩余時間
(integer) 53
127.0.0.1:6379> get j3-liuliang #獲取可以得值
"28"
127.0.0.1:6379>
1.5 SET(set)
設定指定 key 的值
Redis SET 命令用于設定給定 key 的值,如果 key 已經存盤其他值, SET 就覆寫舊值,且無視型別,
語法
127.0.0.1:6379> SET KEY_NAME VALUE
可以版本:>= 1.0.0
回傳值:
在 Redis 2.6.12 以前版本, SET 命令總是回傳 OK ,
從 Redis 2.6.12 版本開始, SET 在設定操作成功完成時,才回傳 OK ,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set j3-liuliang 18 #設定key并賦值
OK
127.0.0.1:6379> get j3-liuliang #獲取key得值
"18"
127.0.0.1:6379> set j3-liuliang 28 #設定key并賦值,key存在則覆寫舊值
OK
127.0.0.1:6379> get j3-liuliang #獲取值
"28" #被覆寫了
127.0.0.1:6379>
1.6 GET(get)
Redis Get 命令用于獲取指定 key 的值,如果 key 不存在,回傳 nil ,如果key 儲存的值不是字串型別,回傳一個錯誤,
語法
127.0.0.1:6379> GET KEY_NAME
可以版本:>= 1.0.0
回傳值:回傳 key 的值,如果 key 不存在時,回傳 nil, 如果 key 不是字串型別,那么回傳一個錯誤,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set j3-liuliang 18 #設定key并賦值
OK
127.0.0.1:6379> get j3-liuliang #獲取key
"18"
127.0.0.1:6379> del j3-liuliang #洗掉key
(integer) 1
127.0.0.1:6379> lpush names j3-liuliang zhangsan #設定list型別key
(integer) 2
127.0.0.1:6379> get names #嘗試獲取list型別key
(error) WRONGTYPE Operation against a key holding the wrong kind of value
#“對持有錯誤型別值的鍵執行錯誤型別操作”,可以簡單理解為就是命令和要執行得key型別不匹配
127.0.0.1:6379>
1.7 GETBIT(getbit)
對 key 所儲存的字串值,獲取指定偏移量上的位(bit),
Redis Getbit 命令用于對 key 所儲存的字串值,獲取指定偏移量上的位(bit),
語法
127.0.0.1:6379> GETBIT KEY_NAME OFFSET
可以版本:>= 2.2.0
回傳值:
字串值指定偏移量上的位(bit,0 或 1 ),
當偏移量 OFFSET 比字串值的長度大,或者 key 不存在時,回傳 0 ,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> setbit bitkey 1 1 #給bitkey的key在 1 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> setbit bitkey 2 1 #給bitkey的key在 2 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> setbit bitkey 3 1 #給bitkey的key在 3 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> getbit bitkey 2 #獲取bitkey在 2 位上的值(默認為 0 )
(integer) 1
127.0.0.1:6379> getbit bitkey 3 #獲取bitkey在 3 位上的值(默認為 0 )
(integer) 1
127.0.0.1:6379> getbit bitkey 4 #獲取bitkey在 4 位上的值(默認為 0 )
(integer) 0
127.0.0.1:6379>
1.8 SETBIT(setbit)
對 key 所儲存的字串值,設定或清除指定偏移量上的位(bit),
Redis Setbit 命令用于對 key 所儲存的字串值,設定或清除指定偏移量上的位(bit),
語法
127.0.0.1:6379> Setbit KEY_NAME OFFSET
可以版本:>= 2.2.0
回傳值:指定偏移量原來儲存的位,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> setbit bitkey 1 1 #給bitkey的key在 1 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> setbit bitkey 2 1 #給bitkey的key在 2 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> setbit bitkey 3 1 #給bitkey的key在 3 位上設定值 1(默認為 0 )
(integer) 0
127.0.0.1:6379> getbit bitkey 2 #獲取bitkey在 2 位上的值(默認為 0 )
(integer) 1
127.0.0.1:6379> getbit bitkey 3 #獲取bitkey在 3 位上的值(默認為 0 )
(integer) 1
127.0.0.1:6379> getbit bitkey 4 #獲取bitkey在 4 位上的值(默認為 0 )
(integer) 0
127.0.0.1:6379>
1.9 DECR(decr)
將 key 中儲存的數字值減一,
Redis Decr 命令將 key 中儲存的
數字值減一,如果 key 不存在,那么 key 的值會先被初始化為 0 ,然后再執行 DECR 操作,
如果值包含錯誤的型別,或字串型別的值不能表示為數字,那么回傳一個錯誤,
本操作的值限制在
64 位(bit)有符號數字表示之內,
語法
127.0.0.1:6379> DECR KEY_NAME
可以版本:>= 1.0.0
回傳值:執行命令之后 key 的值,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set money 100 #對存在數字值得key進行 decr
OK
127.0.0.1:6379> decr money #decr操作
(integer) 99
127.0.0.1:6379> decr money
(integer) 98
127.0.0.1:6379> exists math #對不存在得key進行decr
(integer) 0
127.0.0.1:6379> decr math
(integer) -1
127.0.0.1:6379> set name j3-liuliang #對不是數字值得key進行decr
OK
127.0.0.1:6379> decr name
(error) ERR value is not an integer or out of range #出錯
127.0.0.1:6379>
1.10 DECRBY(decrby)
key 所儲存的值減去給定的減量值(decrement) ,
Redis Decrby 命令將 key 所儲存的值減去指定的減量值,
如果 key 不存在,那么 key 的值會先被初始化為 0 ,然后再執行 DECRBY 操作,
如果值包含錯誤的型別,或字串型別的值不能表示為數字,那么回傳一個錯誤,
本操作的值限制在 64 位(bit)有符號數字表示之內,
語法
127.0.0.1:6379> DECRBY KEY_NAME DECREMENT_AMOUNT
可以版本:>= 1.0.0
回傳值:減去指定減量值之后, key 的值,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set money 100 #對存在數字值得key進行 decr
OK
127.0.0.1:6379> decrby money 10 #decr操作
(integer) 90
127.0.0.1:6379> decrby money 10
(integer) 80
127.0.0.1:6379> exists math #對不存在得key進行decr
(integer) 0
127.0.0.1:6379> decrby math 10
(integer) -10
127.0.0.1:6379> set name j3-liuliang #對不是數字值得key進行decr
OK
127.0.0.1:6379> decrby name 10
(error) ERR value is not an integer or out of range #出錯
127.0.0.1:6379>
1.11 STRLEN(strlen)
回傳 key 所儲存的字串值的長度,
Redis Strlen 命令用于獲取指定 key 所儲存的字串值的長度,當 key 儲存的不是字串值時,回傳一個錯誤,
語法
127.0.0.1:6379> STRLEN KEY_NAME
可以版本:>= 2.2.0
回傳值:字串值的長度, 當 key 不存在時,回傳 0,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set name j3_liuliang #設定key并賦值
OK
127.0.0.1:6379> strlen name #獲取存在key的value長度
(integer) 11
127.0.0.1:6379> strlen notkey #獲取不存在key的value傳長度
(integer) 0
127.0.0.1:6379>
1.12 MSETNX(msetnx)
同時設定一個或多個 key-value 對,當且僅當所有給定 key 都不存在,(原子操作,全部成功才成功)
Redis Msetnx 命令用于所有給定 key 都不存在時,同時設定一個或多個 key-value 對,
語法
127.0.0.1:6379> MSETNX key1 value1 key2 value2 .. keyN valueN
可以版本:>= 1.0.1
回傳值:當所有 key 都成功設定,回傳 1 , 如果所有給定 key 都設定失敗(至少有一個 key 已經存在),那么回傳 0 ,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> msetnx k1 v1 k2 v2 k3 v3 #一次性設定多個不存在的key value
(integer) 1
127.0.0.1:6379> keys *
1) "k1"
2) "k3"
3) "k2"
127.0.0.1:6379> msetnx k1 v1 m1 n1 m2 n2 #當設定得key中有存在的key則全部設定失敗(表明是原子操作)
(integer) 0
127.0.0.1:6379>
1.13 INCR(incr)
將 key 中儲存的數字值增一
Redis Incr 命令將 key 中儲存的數字值增一,
如果 key 不存在,那么 key 的值會先被初始化為 0 ,然后再執行 INCR 操作,
如果值包含錯誤的型別,或字串型別的值不能表示為數字,那么回傳一個錯誤,
本操作的值限制在 64 位(bit)有符號數字表示之內,
語法
127.0.0.1:6379> INCR KEY_NAME
可以版本:>= 1.0.0
回傳值:執行 INCR 命令之后 key 的值,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set money 100 #設定key并設定數字值
OK
127.0.0.1:6379> incr money #加一
(integer) 101
127.0.0.1:6379> incr money
(integer) 102
127.0.0.1:6379> get money #獲取值
"102"
127.0.0.1:6379> exists math #判斷key是否存在
(integer) 0
127.0.0.1:6379> incr math #給不存在的key加一,先創建然后加一
(integer) 1
127.0.0.1:6379> get math #獲取值
"1"
127.0.0.1:6379> set name j3_liuliang #創建不是數字值得key
OK
127.0.0.1:6379> incr name #加一操作失敗
(error) ERR value is not an integer or out of range
127.0.0.1:6379>
1.14 INCRBY(incrby)
將 key 所儲存的值加上給定的增量值(increment) ,
Redis Incrby 命令將 key 中儲存的數字加上指定的增量值,
如果 key 不存在,那么 key 的值會先被初始化為 0 ,然后再執行 INCRBY 命令,
如果值包含錯誤的型別,或字串型別的值不能表示為數字,那么回傳一個錯誤,
本操作的值限制在 64 位(bit)有符號數字表示之內,
語法
127.0.0.1:6379> INCRBY KEY_NAME INCR_AMOUNT
可以版本:>= 1.0.0
回傳值:加上指定的增量值之后, key 的值,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set money 100 #設定key并設定數字值
OK
127.0.0.1:6379> incrby money 20 #給key值增加 20
(integer) 120
127.0.0.1:6379> incrby money 20
(integer) 140
127.0.0.1:6379> get money #獲取key得值
"140"
127.0.0.1:6379> exists day #判斷key是否存在
(integer) 0
127.0.0.1:6379> incrby day 10 #給不存在得key進行增加 10 操作,它會先創建對于得key然后加 10
(integer) 10
127.0.0.1:6379> get day #獲取key得值
"10"
127.0.0.1:6379> set name j3_liuliang #創建不是數字值得key
OK
127.0.0.1:6379> incrby name 10 ##加操作失敗
(error) ERR value is not an integer or out of range
127.0.0.1:6379>
1.15 INCRBYFLOAT(incrbyfloat)
將 key 所儲存的值加上給定的浮點增量值(increment) ,
Redis Incrbyfloat 命令為 key 中所儲存的值加上指定的浮點數增量值,
如果 key 不存在,那么 INCRBYFLOAT 會先將 key 的值設為 0 ,再執行加法操作,
語法
127.0.0.1:6379> INCRBYFLOAT KEY_NAME INCR_AMOUNT
可以版本:>= 2.6.0
回傳值:執行命令之后 key 的值,
案例
127.0.0.1:6379> flushall
OK
# 值和增量都不是指數符號
127.0.0.1:6379> set money 100.50
OK
127.0.0.1:6379> incrbyfloat money 0.3
"100.8"
# 值和增量都是指數符號
127.0.0.1:6379> set pai 314e-2
OK
127.0.0.1:6379> get pai # 用 SET 設定的值可以是指數符號
"314e-2"
127.0.0.1:6379> incrbyfloat pai 0 # 但執行 INCRBYFLOAT 之后格式會被改成非指數符號
"3.14"
127.0.0.1:6379> get pai
"3.14"
127.0.0.1:6379> incrbyfloat pai 0.1
"3.24"
# 可以對整數型別執行
127.0.0.1:6379> set money 100
OK
127.0.0.1:6379> incrbyfloat money 0.1
"100.1"
127.0.0.1:6379> set km 3.0
OK
127.0.0.1:6379> get km # SET 設定的值小數部分可以是 0
"3.0"
127.0.0.1:6379> incrbyfloat km 1.000000000000000 # 但 INCRBYFLOAT 會將無用的 0 忽略掉,有需要的話,將浮點變為整數
"4"
127.0.0.1:6379> get km
"4"
127.0.0.1:6379>
1.16 SETRANGE(setrange)
用 value 引數覆寫給定 key 所儲存的字串值,從偏移量 offset 開始,
Redis Setrange 命令用指定的字串覆寫給定 key 所儲存的字串值,覆寫的位置從偏移量 offset 開始,
語法
127.0.0.1:6379> SETRANGE KEY_NAME OFFSET VALUE
可以版本:>= 2.2.0
回傳值:被修改后的字串長度,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set mykey "the is a good key" #設定key
OK
127.0.0.1:6379> setrange mykey 9 AAA #從指定位置開始覆寫key得值
(integer) 17
127.0.0.1:6379> get mykey #獲取覆寫后得值
"the is a AAAd key"
127.0.0.1:6379>
1.17 PSETEX(psetex)
這個命令和 SETEX 命令相似,但它以毫秒為單位設定 key 的生存時間,而不是像 SETEX 命令那樣,以秒為單位,
Redis Psetex 命令以毫秒為單位設定 key 的生存時間,
語法
127.0.0.1:6379> PSETEX key1 EXPIRY_IN_MILLISECONDS value1
可以版本:>= 2.6.0
回傳值:設定成功時回傳 OK ,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> psetex name 20000 j3_liuliang #以毫秒單位設定key得過期時間
OK
127.0.0.1:6379> pttl name #查看key得過期時間,毫秒值
(integer) 16577
127.0.0.1:6379> get name #在未過期時間內獲取key
"j3_liuliang"
127.0.0.1:6379> pttl name #過期后
(integer) -2
127.0.0.1:6379> get name #獲取過期后的key值
(nil)
127.0.0.1:6379>
1.18 APPEND(append)
如果 key 已經存在并且是一個字串, APPEND 命令將 value 追加到 key 原來的值的末尾,
Redis Append 命令用于為指定的 key 追加值,
如果 key 已經存在并且是一個字串, APPEND 命令將 value 追加到 key 原來的值的末尾,
如果 key 不存在, APPEND 就簡單地將給定 key 設為 value ,就像執行 SET key value 一樣,
語法
127.0.0.1:6379> APPEND KEY_NAME NEW_VALUE
可以版本:>= 2.0.0
回傳值:追加指定值之后, key 中字串的長度,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> exists name #查看key是否存在
(integer) 0
127.0.0.1:6379> append name j3_liuliang #給不存在的key 追加字串
(integer) 11
127.0.0.1:6379> get name #獲取key對應得值
"j3_liuliang"
127.0.0.1:6379> set j3_liuliang 18 #設定key并賦值
OK
127.0.0.1:6379> append j3_liuliang 0 #給存在得key追加值
(integer) 3
127.0.0.1:6379> get j3_liuliang #查看追加后得key的值
"180"
127.0.0.1:6379>
1.19 GETSET(getset)
將給定 key 的值設為 value ,并回傳 key 的舊值(old value),
Redis Getset 命令用于設定指定 key 的值,并回傳 key 舊的值,
語法
127.0.0.1:6379> GETSET KEY_NAME VALUE
可以版本:>= 1.0.0
回傳值:
回傳給定 key 的舊值, 當 key 沒有舊值時,即 key 不存在時,回傳 nil ,
當 key 存在但不是字串型別時,回傳一個錯誤,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> exists name #判斷key是否存在
(integer) 0
127.0.0.1:6379> getset name j3_liuliang #對不存在的key進行getset
(nil) #先回傳nil然后給name設定值j3_liuliang
127.0.0.1:6379> get name #獲取key的值
"j3_liuliang"
127.0.0.1:6379> set mykey name:j3_liulaing #設定key并賦值
OK
127.0.0.1:6379> getset mykey name:liuliang #對存在的key進行 getset
"name:j3_liulaing" #先是回傳key的值,然后將新值覆寫給key
127.0.0.1:6379> get mykey #獲得覆寫后的值
"name:liuliang"
127.0.0.1:6379>
1.20 MGET(mget)
獲取所有(一個或多個)給定 key 的值,
Redis Mget 命令回傳所有(一個或多個)給定 key 的值, 如果給定的 key 里面,有某個 key 不存在,那么這個 key 回傳特殊值 nil ,
語法
127.0.0.1:6379> MGET KEY1 KEY2 .. KEYN
可以版本:>= 1.0.0
回傳值:一個包含所有給定 key 的值的串列,
案例
127.0.0.1:6379> flushall
OK
127.0.0.1:6379> set k1 v1 #設定key并賦值
OK
127.0.0.1:6379> set k2 v2
OK
127.0.0.1:6379> mget k1 k2 k3 #一次性獲取多個key的值,不存在的則回傳nil
1) "v1"
2) "v2"
3) (nil)
127.0.0.1:6379>

二、應用場景
-
單值快取:商品庫存,key=商品id,value=庫存數量
(set,get) -
物件快取:
- set 存盤用戶資訊,key=user:id value=json格式資料
mset批量存盤用戶資訊,適用于資料不斷變化的應用場景,
如用戶微信余額,存取方便,效率高
-
分布式鎖:
適用場景:在一個集群環境下,多個web應用時對同一個商品進行搶購和減庫存操作時,
可能出現超賣時會用到分布式鎖
SETNX命令(SET if Not eXists)
語法:SETNX key value
功能:當且僅當 key 不存在,將 key 的值設為 value ,并回傳1;
若給定的 key 已經存在,則 SETNX 不做任何動作,并回傳0, -
計算器:文章
訪問量,每當用戶訪問,閱讀數加1(incr) -
共享session:出于負載均衡的考慮,分布式服務會將用戶資訊的訪問均衡到不同服務器上,用戶重繪一次訪問可能會需要重新登錄,為避免這個問題可以用redis將用戶session集中管理,在這種模式下只要保證redis的高可用和擴展性的,每次獲取用戶更新或查詢登錄資訊都直接從redis中集中獲取,
-
**限速:**處于安全考慮,每次進行登錄時讓用戶輸入手機驗證碼,為了短信介面不被頻繁訪問,會限制用戶每分鐘獲取驗證碼的頻率,
-
分布式系統全域序列號:
- 適用場景:一般資料庫表的主鍵用自增長序列號,假如系統壓力大,后端做了分庫分表,
資料庫自帶的auto_increment就不適用了,可以使用redis的自增,由于Redis為單行程單執行緒模式, 采用佇列模式將并發訪問變成串行訪問,且多客戶端對Redis的連接并不存在競爭關系,
incr orderId redis壓力大
incr orderId 1000 提升性能,降低redis壓力
假設有3臺機器訪問redis,利用redis的特點:單執行緒
incrby orderid 1000 //每臺每次拿1000,01000,10012000,2001~3000
拿完后再各自慢慢處理這1000的容量 - 適用場景:一般資料庫表的主鍵用自增長序列號,假如系統壓力大,后端做了分庫分表,
結束語
- 本文結合Redis中文網和博主的實踐案例所寫,下期寫List型別
- 由于博主才疏學淺,難免會有紕漏,假如你發現了錯誤或偏見的地方,還望留言給我指出來,我會對其加以修正,
- 如果你覺得文章還不錯,你的轉發、分享、點贊、留言就是對我最大的鼓勵,
- 感謝您的閱讀,十分歡迎并感謝您的關注,

轉載請註明出處,本文鏈接:https://www.uj5u.com/qianduan/154074.html
標籤:其他
