Redis基礎知識(學習筆記9--Redis命令(2))

东山絮柳仔發表於2024-06-28

四. Hash型Value操作命令

Redis儲存資料的Value可以是一個Hash型別。Hash型別也稱為Hash表、字典等。

Hash表就是一個對映表Map,也是有鍵-值對構成,為了與整體的key進行區分,這裡的鍵稱為field,值稱為value。

注意:Redis的Hash表中的field-value對均為String型別。

4.1 hset

>hset key field value

將雜湊表key中的域field的值設為value。

說明:如果key不存在,一個新的雜湊表被建立並進行hset 操作。如果域field已經存在於雜湊表中,舊值將被覆蓋。如果field是雜湊表中的一個新建域,並且值設定成功,返回1。如果雜湊表中域field已經存在且舊值已被新值覆蓋,返回0。

4.2 hget

>hget key field

返回雜湊表key中給定域field的值。

說明:當給定域不存在或是給定key不存在時,返回nil。

4.3 hmset

> hmset key field value [field value ...]

同時將多個field-value(域-值)對設定到雜湊表中。

說明:此命令會覆蓋雜湊表中已存在的域。如果key不存在,一個空雜湊表被建立並執行hmset 操作。如果命令執行成功,返回OK。當key不是雜湊表(hash)型別時,返回一個錯誤。

4.4 hmget

HMGET key field [field ...]

返回雜湊表 key 中,一個或多個給定域的值。

說明:如果給定的域不存在於雜湊表,那麼返回一個 nil 值。因為不存在的 key 被當作一個空雜湊表來處理,所以對一個不存在的 key 進行 HMGET 操作將返回一個只帶有 nil 值的表。

一個包含多個給定域的關聯值的表,表值的排列順序和給定域引數的請求順序一樣。

4.5 hgetall

>HGETALL key

返回雜湊表 key 中,所有的域和值。

說明:在返回值裡,緊跟每個域名(field name)之後是域的值(value),所以返回值的長度是雜湊表大小的兩倍。

以列表形式返回雜湊表的域和域的值。若 key 不存在,返回空列表。

4.6 hsetnx

>HSETNX key field value

將雜湊表 key 中的域 field 的值設定為 value ,當且僅當域 field 不存在。

說明:若域 field 已經存在,該操作無效。如果 key 不存在,一個新雜湊表被建立並執行 HSETNX 命令。

設定成功,返回 1 。如果給定域已經存在且沒有操作被執行,返回 0

4.7 hdel

>HDEL key field [field ...]

刪除雜湊表 key 中的一個或多個指定域,不存在的域將被忽略。

說明:在Redis2.4以下的版本里, HDEL 每次只能刪除單個域。返回值:被成功移除的域的數量,不包括被忽略的域。

4.8 hexists

>HEXISTS key field

檢視雜湊表 key 中,給定域 field 是否存在。

說明:如果雜湊表含有給定域,返回 1 。如果雜湊表不含有給定域,或 key 不存在,返回 0

4.9 hincrby 與 incrbyfloat

>hincrby key field increment

為雜湊表key中的域field的值加上增量increment。hincrby命令只能增加整數值,而hincrbyfloat 可以增加小數值。

說明:增量也可以為負數,相當於對給定域進行減操作。如果key不存在,一個新的雜湊表被建立並執行hincrby命令。如果域field不存在,那麼在執行命令前,域的值被初始化為0。對一個儲存字串的域field執行hincrby命令會造成一個錯誤。

4.10 hkeys 與 hvals

>hkeys key 或者 hvals key

返回雜湊表key中的所有域 或 所有值。

說明:當key不存在時,返回一個空表。

4.11 hlen

>HLEN key

返回雜湊表 key 中域的數量。

說明:返回值為 雜湊表中域的數量。當 key 不存在時,返回 0

4.12 hstrlen

>HSTRLEN key field

返回雜湊表 key 中, 與給定域 field 相關聯的值的字串長度(string length)。

說明:返回值為一個整數。但是,如果給定的鍵或者域不存在, 那麼命令返回 0

4.13 hscan

HSCAN key cursor [MATCH pattern] [COUNT count]

需要展開講解。

4.14 應用場景

hash型value 非常適合儲存物件資料。key為物件名稱,value為描述物件屬性的Map,對物件屬性的修改在Redis中就可以直接完成。其不像String型Value儲存物件,那個物件是序列化過的,例如序列化為JSON串,對物件屬性值的修改需要先反序列化為物件後再修改,修改後再序列化為JSON串後寫入到Redis。

五. List 型Value操作命令

Redis儲存資料的value 可以是一個String列表型別資料,即該列表中的每個元素均為string型別資料。列表中的資料會按照插入順序進行排序。不過,該列表的底層實際是一個無頭節點的雙向列表,所以對列表表頭與表尾的操作效能較高,但對中間元素的插入與刪除的操作的效能相對較差。

5.1 lpush / rpush

>lpush key value [value ...]  或 rpush key value [value ...]

將一個或多個值value 插入到列表key的表頭 / 表尾 (表頭在左表尾在右)。

說明:如果有多個value,對於lpush來說,各個value會按從左到右的順序依次插入到表頭;對於rpush來說,各個value會按從左到右的順序依次插入到表尾。如果key不存在,一個空列表會被建立並執行。當key存在但不是列表型別時,返回一個錯誤。執行成功時,返回列表的長度。

順序描述的可能有點亂,舉例說明下:

LPUSH

redis> LPUSH mylist a b c
(integer) 3

redis> LRANGE mylist 0 -1
1) "c"
2) "b"
3) "a"

RPUSH

redis> RPUSH mylist a b c
(integer) 3

redis> LRANGE mylist 0 -1
1) "a"
2) "b"
3) "c"

5.2 llen

>llen key

返回列表key的長度。

說明:如果key不存在,則key被解釋為一個空列表,返回0,如果key不是列表型別,返回一個錯誤。

5.3 lindex

>lindex key index

返回列表key中,下標為index的元素,列表從0開始計數。

說明:如果inde引數的值不住列表的區間範圍內(out of range),返回nil。

5.4 lset

>LSET key index value

將列表 key 下標為 index 的元素的值設定為 value

說明:當 index 引數超出範圍,或對一個空列表( key 不存在)進行 LSET 時,返回一個錯誤。操作成功返回 ok ,否則返回錯誤資訊。

需要注意的是:對頭元素或尾元素進行 LSET 操作,複雜度為 O(1)。其他情況下,為 O(N), N 為列表的長度。

5.5 lrange

>LRANGE key start stop

返回列表 key 中指定區間內的元素,區間以偏移量 startstop 指定。

說明:下標(index)引數 startstop 都以 0 為底,也就是說,以 0 表示列表的第一個元素,以 1 表示列表的第二個元素,以此類推。你也可以使用負數下標,以 -1 表示列表的最後一個元素, -2 表示列表的倒數第二個元素,以此類推。超出範圍的下標值不會引起錯誤。如果 start 下標比列表的最大下標 end ( LLEN list 減去 1 )還要大,那麼 LRANGE 返回一個空列表。如果 stop 下標比 end 下標還要大,Redis將 stop 的值設定為 end 。返回值:一個列表,包含指定區間內的元素。

注意LRANGE命令和程式語言區間函式的區別:假如你有一個包含一百個元素的列表,對該列表執行 LRANGE list 0 10 ,結果是一個包含11個元素的列表,這表明 stop 下標也在 LRANGE 命令的取值範圍之內(閉區間),這和某些語言的區間函式可能不一致,比如Ruby的 Range.newArray#slice 和Python的 range() 函式。

5.6 lpushx / rpushx

>LPUSHX key value

將值 value 插入到列表 key 的表頭,當且僅當 key 存在並且是一個列表。

說明:和 LPUSH 命令相反,當 key 不存在時, LPUSHX 命令什麼也不做。返回值:LPUSHX 命令執行之後,表的長度。

>RPUSHX key value

將值 value 插入到列表 key 的表尾,當且僅當 key 存在並且是一個列表。

說明:和 RPUSH 命令相反,當 key 不存在時, RPUSHX 命令什麼也不做。返回值:RPUSHX 命令執行之後,表的長度。

5.7 linsert

>linsert key before | after pivot value

將值value插入到列表key當中,位於元素pivot之前或之後。

說明:當pivot元素不存在於列表當中時,不執行任何操作,返回-1;當key不存在時,key被視為空列表,不執行任何操作,返回0;如果key不是類別型別,返回一個錯誤;如果命令執行成功,返回插入操作完成之後,列表的長度。

5.8 lpop / rpop

>lpop key [count] / rpop key [count]

從列表key的表頭 / 表尾 移除 count個元素,並返回移除的元素。count 預設值為1。

說明:當key不存在時,返回nil。

5.9 blpop / brpop

>blpop key [key ... ] timeout / brpop key [key ...] timeout

blpop / brpop 時列表的阻塞式(blocking)彈出命令。它們是blpop / brpop命令的阻塞版本,當給定列表內沒有任何元素可供彈出的時候,連線將被 blpop / brpop 命令阻塞,直到timeout超時或者發現可彈出元素為止。當給定多個key引數時,按引數key的先後順序依次檢查各個列表,彈出第一個非空列表的頭元素。timeout為阻塞時長,單位為秒,其值若為0,則表示只要沒有可彈出元素,則一直阻塞。

說明:假如在指定時間內沒有任何元素被彈出,則返回一個nil 和等待時長。反之,返回一個含有兩個元素的列表,第一個元素時被彈出元素所屬的key,第二個元素時被彈出的元素的值。

5.10 rpoplpush

>rpoplpush source destination

在一個原子時間內,執行以下兩個動作:

* 將列表source中的最後一個元素(尾元素)彈出,並返回給客戶端;

*將source彈出的元素插入到列表destination,作為destination列表的頭元素。

說明:如果source不存在,值nil被返回,並且不執行其他動作。如果source 和 destination 相同,則列表中的表尾元素被移動到表頭,並返回該元素,可以把這種特殊情況視作列表的旋轉(rotation)操作。

5.11 brpoplpush

>brpoplpush source destimation timeout

brpoplpush 是 rpoplpush的阻塞版本,當給定列表source不為空時,brpoplpush的表現和rpoplpush一樣。當列表source為空時,brpoplpush的命令為阻塞連線,直到等待超時,或有另一個客戶端對source執行lpush或者rpush命令為止。timeout為阻塞時長,單位為秒,其值若為0,則表示只要沒有可彈出元素,則一直阻塞。

說明:假如在指定時間內沒有任何元素被彈出,則返回一個nil和等待時長。反之,返回一個含有兩個元素的列表,第一個元素是被彈出的值,第二個是等待時長。

5.12 lrem

>lrem key count value

根據引數count的值,移除類別中與引數value相同的元素。count的值可以有以下一種:

*** count>0:從表頭開始向表尾搜尋,移除與value 相等的元素,數量為count。

*** count<0:從表尾開始向表頭搜尋,移除與value 相等的元素,數量為count的絕對值。

*** count=0:移除表中所有與value 相等的元素。

說明:返回被移除元素的數量。當key不存在時,lrem命令返回0,因為不存在的key被視為空表(empty list)。

5.13 ltrim

>ltrim key start stop

對一個列表進行修剪(trim),即讓列表只保留指定區間內的元素,不在指定區間之內的元素都將被移除。

說明:下標(index)引數start 和 stop 都是以0為底,即以0表示列表的第一個元素,以1表示列表的第二個元素,以此類推。也可以使用負數下標,以-1表示列表的最後一個元素,-2表示列表的倒數第二個元素,以此類推。當key不是列表型別時,返回一個錯誤。如果start下標比列表的最大下標end(llen list 減去1)還要大,或者start>end,ltrim返回一個空列表,因為ltrim已將整個列表清空。

5.14 主要應用場景

透過構建不通的資料結構來實現相應的業務功能。

(1)棧

透過lpush + lpop 可以實現棧資料結構:先進後出。透過lpush從列表左側插入資料,透過lpop從列表左側取出資料。當然rpush+rpop也可以實現相同效果,只不過操作的時列表右側。

(2)佇列

透過lpush +rpop 可以實現佇列資料結構效果:先進先出。透過lpush從列表左側插入資料,透過rpop從列表右側取出資料。當然,透過rpush + lpop也可以實現相同的效果,只不過操作的方向與前者組合相反。

(3)阻塞式訊息佇列

透過lpush+brpop 可以實現阻塞式訊息佇列效果。作為訊息生產者的客戶端使用lpush從列表左側插入資料,作為訊息消費者的多個客戶端使用brpop阻塞是”搶佔“列表尾部資料進行消費,保證了消費的負載均衡與高可用性。

(4)動態有限集合

透過lpush+ltrim可以實現有限集合。透過lpush從列表左側向列表中新增資料,透過ltrim保持集合的動態有限性。當然,透過rpush+ltrim也可以實現相同效果,只不過操作的方向正好相反。

學習參閱宣告

1.【Redis影片從入門到高階】

https://www.bilibili.com/video/BV1U24y1y7jF?p=11&vd_source=0e347fbc6c2b049143afaa5a15abfc1c】

2. 【Redis 命令參考】

https://haiyong.site/doc/redis/redis-gh-pages/hash/hscan.html

相關文章