前提條件：
安裝並運行redis服務端程序，安裝RedisPy庫
說明：Redis 是 StrictRedis 的子類，它的主要功能是用於向后兼容舊版本庫里的幾個方法，官方推薦使用 StrictRedis。
1.連接
# 方法1 from redis import StrictRedis redis = StrictRedis(host='localhost',port=6379,db=0,password='foobar2000') redis.set('name', 'Bob') print(redis.get('name'))
# 方法2 pool = ConnectionPool(host='localhost', port=6379, db=0, password='foobar2000')
redis = StrictRedis(connection_pool=pool)
redis.set('name', 'Bob') print(redis.get('name'))
“”
另外 ConnectionPool 還支持通過 URL 來構建，URL 的格式支持如下三種：
redis://[:password]@host:port/db
rediss://[:password]@host:port/db
unix://[:password]@/path/to/socket.sock?db=db
這三種 URL 分別表示創建 Redis TCP 連接、Redis TCP+SSL 連接、Redis Unix Socket 連接
“”
2.key操作
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| exists(name) |
判斷一個key是否存在 |
name: key名 |
|
是否存在name這個key |
True |
| delete(name) |
刪除一個key |
name: key名 |
|
刪除name這個key |
1 |
| type(name) |
判斷key類型 |
name: key名 |
|
判斷name這個key類型 |
b'string' |
| keys(pattern) |
獲取所有符合規則的key |
pattern: 匹配規則 |
|
獲取所有以n開頭的key |
[b'name'] |
| randomkey() |
獲取隨機的一個key |
|
獲取隨機的一個key |
b'name' |
|
| rename(src, dst) |
將key重命名 |
src: 原key名 dst: 新key名 |
|
將name重命名為nickname |
True |
| dbsize() |
獲取當前數據庫中key的數目 |
|
獲取當前數據庫中key的數目 |
100 |
|
| expire(name, time) |
設定key的過期時間，單位秒 |
name: key名 time: 秒數 |
|
將name這key的過期時間設置2秒 |
True |
| ttl(name) |
獲取key的過期時間，單位秒，-1為永久不過期 |
name: key名 |
|
獲取name這key的過期時間 |
-1 |
| move(name, db) |
將key移動到其他數據庫 |
name: key名 db: 數據庫代號 |
|
將name移動到2號數據庫 |
True |
| flushdb() |
刪除當前選擇數據庫中的所有key |
|
刪除當前選擇數據庫中的所有key |
True |
|
| flushall() |
刪除所有數據庫中的所有key |
|
刪除所有數據庫中的所有key |
True |
3.string操作
Redis 中存在最基本的鍵值對形式存儲
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| set(name, value) |
給數據庫中key為name的string賦予值value |
name: key名 value: 值 |
|
給name這個key的value賦值為Bob |
True |
| get(name) |
返回數據庫中key為name的string的value |
name: key名 |
|
返回name這個key的value |
b'Bob' |
| getset(name, value) |
給數據庫中key為name的string賦予值value並返回上次的value |
name: key名 value: 新值 |
|
賦值name為Mike並得到上次的value |
b'Bob' |
| mget(keys, *args) |
返回多個key對應的value |
keys: key的列表 |
|
返回name和nickname的value |
[b'Mike', b'Miker'] |
| setnx(name, value) |
如果key不存在才設置value |
name: key名 |
|
如果newname這key不存在則設置值為James |
第一次運行True，第二次False |
| setex(name, time, value) |
設置可以對應的值為string類型的value，並指定此鍵值對應的有效期 |
name: key名 time: 有效期 value: 值 |
|
將name這key的值設為James，有效期1秒 |
True |
| setrange(name, offset, value) |
設置指定key的value值的子字符串 |
name: key名 offset: 偏移量 value: 值 |
|
設置name為Hello字符串，並在index為6的位置補World |
11，修改后的字符串長度 |
| mset(mapping) |
批量賦值 |
mapping: 字典 |
|
將name1設為Durant，name2設為James |
True |
| msetnx(mapping) |
key均不存在時才批量賦值 |
mapping: 字典 |
|
在name3和name4均不存在的情況下才設置二者值 |
True |
| incr(name, amount=1) |
key為name的value增值操作，默認1，key不存在則被創建並設為amount |
name: key名 amount:增長的值 |
|
age對應的值增1，若不存在則會創建並設置為1 |
1，即修改后的值 |
| decr(name, amount=1) |
key為name的value減值操作，默認1，key不存在則被創建並設置為-amount |
name: key名 amount:減少的值 |
|
age對應的值減1，若不存在則會創建並設置為-1 |
-1，即修改后的值 |
| append(key, value) |
key為name的string的值附加value |
key: key名 |
|
向key為nickname的值后追加OK |
13，即修改后的字符串長度 |
| substr(name, start, end=-1) |
返回key為name的string的value的子串 |
name: key名 start: 起始索引 end: 終止索引，默認-1截取到末尾 |
|
返回key為name的值的字符串，截取索引為1-4的字符 |
b'ello' |
| getrange(key, start, end) |
獲取key的value值從start到end的子字符串 |
key: key名 start: 起始索引 end: 終止索引 |
|
返回key為name的值的字符串，截取索引為1-4的字符 |
b'ello' |
4.列表操作
List，即列表。Redis 還提供了列表存儲，列表內的元素可以重復，而且可以從兩端存儲
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| rpush(name, *values) |
在key為name的list尾添加值為value的元素，可以傳多個 |
name: key名 values: 值 |
|
給list這個key的list尾添加1、2、3 |
3，list大小 |
| lpush(name, *values) |
在key為name的list頭添加值為value的元素，可以傳多個 |
name: key名 values: 值 |
|
給list這個key的list頭添加0 |
4，list大小 |
| llen(name) |
返回key為name的list的長度 |
name: key名 |
|
返回key為list的列表的長度 |
4 |
| lrange(name, start, end) |
返回key為name的list中start至end之間的元素 |
name: key名 start: 起始索引 end: 終止索引 |
|
返回起始為1終止為3的索引范圍對應的list |
|
| ltrim(name, start, end) |
截取key為name的list，保留索引為start到end的內容 |
name:key名 start: 起始索引 end: 終止索引 |
|
保留key為list的索引為1到3的元素 |
True |
| lindex(name, index) |
返回key為name的list中index位置的元素 |
name: key名 index: 索引 |
|
返回key為list的列表index為1的元素 |
b'2' |
| lset(name, index, value) |
給key為name的list中index位置的元素賦值，越界則報錯 |
name: key名 index: 索引位置 value: 值 |
|
將key為list的list索引1位置賦值為5 |
True |
| lrem(name, count, value) |
刪除count個key的list中值為value的元素 |
name: key名 count: 刪除個數 value: 值 |
|
將key為list的列表刪除2個3 |
1，即刪除的個數 |
| lpop(name) |
返回並刪除key為name的list中的首元素 |
name: key名 |
|
返回並刪除名為list的list第一個元素 |
b'5' |
| rpop(name) |
返回並刪除key為name的list中的尾元素 |
name: key名 |
|
返回並刪除名為list的list最后一個元素 |
b'2' |
| blpop(keys, timeout=0) |
返回並刪除名稱為在keys中的list中的首元素，如果list為空，則會一直阻塞等待 |
keys: key列表 timeout: 超時等待時間，0為一直等待 |
|
返回並刪除名為list的list的第一個元素 |
[b'5'] |
| brpop(keys, timeout=0) |
返回並刪除key為name的list中的尾元素，如果list為空，則會一直阻塞等待 |
keys: key列表 timeout: 超時等待時間，0為一直等待 |
|
返回並刪除名為list的list的最后一個元素 |
[b'2'] |
| rpoplpush(src, dst) |
返回並刪除名稱為src的list的尾元素，並將該元素添加到名稱為dst的list的頭部 |
src: 源list的key dst: 目標list的key |
|
將key為list的list尾元素刪除並返回並將其添加到key為list2的list頭部 |
b'2' |
5.集合操作
Set，即集合。Redis 還提供了集合存儲，集合中的元素都是不重復的
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| sadd(name, *values) |
向key為name的set中添加元素 |
name: key名 values: 值，可為多個 |
|
向key為tags的set中添加Book、Tea、Coffee三個內容 |
3，即插入的數據個數 |
| srem(name, *values) |
從key為name的set中刪除元素 |
name: key名 values: 值，可為多個 |
|
從key為tags的set中刪除Book |
1，即刪除的數據個數 |
| spop(name) |
隨機返回並刪除key為name的set中一個元素 |
name: key名 |
|
從key為tags的set中隨機刪除並返回該元素 |
b'Tea' |
| smove(src, dst, value) |
從src對應的set中移除元素並添加到dst對應的set中 |
src: 源set dst: 目標set value: 元素值 |
|
從key為tags的set中刪除元素Coffee並添加到key為tags2的set |
True |
| scard(name) |
返回key為name的set的元素個數 |
name: key名 |
|
獲取key為tags的set中元素個數 |
3 |
| sismember(name, value) |
測試member是否是key為name的set的元素 |
name:key值 |
|
判斷Book是否為key為tags的set元素 |
True |
| sinter(keys, *args) |
返回所有給定key的set的交集 |
keys: key列表 |
|
返回key為tags的set和key為tags2的set的交集 |
{b'Coffee'} |
| sinterstore(dest, keys, *args) |
求交集並將交集保存到dest的集合 |
dest:結果集合 keys:key列表 |
|
求key為tags的set和key為tags2的set的交集並保存為inttag |
1 |
| sunion(keys, *args) |
返回所有給定key的set的並集 |
keys: key列表 |
|
返回key為tags的set和key為tags2的set的並集 |
{b'Coffee', b'Book', b'Pen'} |
| sunionstore(dest, keys, *args) |
求並集並將並集保存到dest的集合 |
dest:結果集合 keys:key列表 |
|
求key為tags的set和key為tags2的set的並集並保存為inttag |
3 |
| sdiff(keys, *args) |
返回所有給定key的set的差集 |
keys: key列表 |
|
返回key為tags的set和key為tags2的set的差集 |
{b'Book', b'Pen'} |
| sdiffstore(dest, keys, *args) |
求差集並將差集保存到dest的集合 |
dest:結果集合 keys:key列表 |
|
求key為tags的set和key為tags2的set的差集並保存為inttag |
3 |
| smembers(name) |
返回key為name的set的所有元素 |
name: key名 |
|
返回key為tags的set的所有元素 |
{b'Pen', b'Book', b'Coffee'} |
| srandmember(name) |
隨機返回key為name的set的一個元素，但不刪除元素 |
name: key值 |
|
隨機返回key為tags的set的一個元素 |
6.有序集合
Sorted Set，即有序集合，它相比集合多了一個分數字段，利用它我們可以對集合中的數據進行排序
注意：在redis-py 3.0之前，添加一個有序集合的值，代碼：
import redis
client = redis.Redis()
client.zadd('key', value1, score1, value2, score2)
在redis-py 3.0及以后的版本，上面這種寫法會導致如下的報錯：
redis.exceptions.DataError: ZADD allows either 'nx' or 'xx', not both
或者：AttributeError: 'str' object has no attribute 'items'
在新版本中，正確的寫法為：
import redis
client = redis.Redis()
client.zadd('key', {value1: score1, value2: score2})
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| zadd(name, args, *kwargs) |
向key為name的zset中添加元素member，score用於排序。如果該元素存在，則更新其順序 |
name: key名 args: 可變參數 |
|
向key為grade的zset中添加Bob，score為100，添加Mike，score為98 |
2，即添加的元素個數 |
| zrem(name, *values) |
刪除key為name的zset中的元素 |
name: key名 values: 元素 |
|
從key為grade的zset中刪除Mike |
1，即刪除的元素個數 |
| zincrby(name, value, amount=1) |
如果在key為name的zset中已經存在元素value，則該元素的score增加amount，否則向該集合中添加該元素，其score的值為amount |
name: key名 value: 元素 amount: 增長的score值 |
|
key為grade的zset中Bob的score減2 |
98.0，即修改后的值 |
| zrank(name, value) |
返回key為name的zset中元素的排名（按score從小到大排序）即下標 |
name: key名 value: 元素值 |
|
得到key為grade的zset中Amy的排名 |
1 |
| zrevrank(name, value) |
返回key為name的zset中元素的倒數排名（按score從大到小排序）即下標 |
name: key名 value: 元素值 |
|
得到key為grade的zset中Amy的倒數排名 |
2 |
| zrevrange(name, start, end, withscores=False) |
返回key為name的zset（按score從大到小排序）中的index從start到end的所有元素 |
name: key值 start: 開始索引 end: 結束索引 withscores: 是否帶score |
|
返回key為grade的zset前四名元素 |
[b'Bob', b'Mike', b'Amy', b'James'] |
| zrangebyscore(name, min, max, start=None, num=None, withscores=False) |
返回key為name的zset中score在給定區間的元素 |
name:key名 min: 最低score max:最高score start: 起始索引 num: 個數 withscores: 是否帶score |
|
返回key為grade的zset中score在80和95之間的元素 |
[b'Amy', b'James'] |
| zcount(name, min, max) |
返回key為name的zset中score在給定區間的數量 |
name:key名 min: 最低score max: 最高score |
|
返回key為grade的zset中score在80到95的元素個數 |
2 |
| zcard(name) |
返回key為name的zset的元素個數 |
name: key名 |
|
獲取key為grade的zset中元素個數 |
3 |
| zremrangebyrank(name, min, max) |
刪除key為name的zset中排名在給定區間的元素 |
name:key名 min: 最低位次 max: 最高位次 |
|
刪除key為grade的zset中排名第一的元素 |
1，即刪除的元素個數 |
| zremrangebyscore(name, min, max) |
刪除key為name的zset中score在給定區間的元素 |
name:key名 min: 最低score max:最高score |
|
刪除score在80到90之間的元素 |
1，即刪除的元素個數 |
7.哈希操作
Hash，即哈希。我們可以用name指定一個哈希表的名稱，然后表內存儲了各個鍵值對
| 方法 |
作用 |
參數說明 |
示例 |
示例說明 |
示例結果 |
| hset(name, key, value) |
向key為name的hash中添加映射 |
name: key名 key: 映射鍵名 value: 映射鍵值 |
|
向key為price的hash中添加映射關系，cake的值為5 |
1，即添加的映射個數 |
| hsetnx(name, key, value) |
向key為name的hash中添加映射，如果映射鍵名不存在 |
name: key名 key: 映射鍵名 value: 映射鍵值 |
|
向key為price的hash中添加映射關系，book的值為6 |
1，即添加的映射個數 |
| hget(name, key) |
返回key為name的hash中field對應的value |
name: key名 key: 映射鍵名 |
|
獲取key為price的hash中鍵名為cake的value |
5 |
| hmget(name, keys, *args) |
返回key為name的hash中各個鍵對應的value |
name: key名 keys: 映射鍵名列表 |
|
獲取key為price的hash中apple和orange的值 |
[b'3', b'7'] |
| hmset(name, mapping) |
向key為name的hash中批量添加映射 |
name: key名 mapping: 映射字典 |
|
向key為price的hash中批量添加映射 |
True |
| hincrby(name, key, amount=1) |
將key為name的hash中映射的value增加amount |
name: key名 key: 映射鍵名 amount: 增長量 |
|
key為price的hash中apple的值增加3 |
6，修改后的值 |
| hexists(name, key) |
key為namehash中是否存在鍵名為key的映射 |
name: key名 key: 映射鍵名 |
|
key為price的hash中banana的值是否存在 |
True |
| hdel(name, *keys) |
key為namehash中刪除鍵名為key的映射 |
name: key名 key: 映射鍵名 |
|
從key為price的hash中刪除鍵名為banana的映射 |
True |
| hlen(name) |
從key為name的hash中獲取映射個數 |
name: key名 |
|
從key為price的hash中獲取映射個數 |
6 |
| hkeys(name) |
從key為name的hash中獲取所有映射鍵名 |
name: key名 |
|
從key為price的hash中獲取所有映射鍵名 |
[b'cake', b'book', b'banana', b'pear'] |
| hvals(name) |
從key為name的hash中獲取所有映射鍵值 |
name: key名 |
|
從key為price的hash中獲取所有映射鍵值 |
[b'5', b'6', b'2', b'6'] |
| hgetall(name) |
從key為name的hash中獲取所有映射鍵值對 |
name: key名 |
|
從key為price的hash中獲取所有映射鍵值對 |
{b'cake': b'5', b'book': b'6', b'orange': b'7', b'pear': b'6'} |
8.導入/導出
確保已經安裝好了 RedisDump，RedisDump 提供兩個可執行命令，redis-dump 用於導出數據，redis-load 用於導入數據
redis-dump
我們可以首先輸入如下命令查看所有可選項：
redis-dump -h
運行結果如下：
Usage: redis-dump [global options] COMMAND [command options]
-u, --uri=S Redis URI (e.g. redis://hostname[:port])
-d, --database=S Redis database (e.g. -d 15)
-s, --sleep=S Sleep for S seconds after dumping (for debugging)
-c, --count=S Chunk size (default: 10000)
-f, --filter=S Filter selected keys (passed directly to redis' KEYS command)
-O, --without_optimizations Disable run time optimizations
-V, --version Display version
-D, --debug
--nosafe
可以看到其參數，-u 代表 Redis 連接字符串，-d 代表數據庫代號，默認全部，-s 代表導出之后的休眠時間，-c 代表分塊大小，默認是 10000，-f 代表導出時的過濾器，-O 代表禁用運行時優化，-V 顯示版本，-D 開啟調試。
我們拿本地的 Redis 做測試，運行在 6379 端口上，密碼為 foobared，導出命令如下：
redis-dump -u :foobared@localhost:6379
如果沒有密碼的話可以不加密碼前綴，命令如下：
redis-dump -u localhost:6379
運行之后可以將本地 0-15號 數據庫的所有數據輸出出來，例如：
{"db":0,"key":"name","ttl":-1,"type":"string","value":"James","size":5}
{"db":0,"key":"name2","ttl":-1,"type":"string","value":"Durant","size":6}
{"db":0,"key":"name3","ttl":-1,"type":"string","value":"Durant","size":6}
{"db":0,"key":"name4","ttl":-1,"type":"string","value":"HelloWorld","size":10}
{"db":0,"key":"name5","ttl":-1,"type":"string","value":"James","size":5}
{"db":0,"key":"name6","ttl":-1,"type":"string","value":"James","size":5}
{"db":0,"key":"age","ttl":-1,"type":"string","value":"1","size":1}
{"db":0,"key":"age2","ttl":-1,"type":"string","value":"-5","size":2}
每條數據都包含五個字段，db 即數據庫代號，key 即鍵名，ttl 即該鍵值對的有效時間，type 即鍵值類型，size 即占用空間。
如果想要將其輸出為 Json 行文件，可以使用如下命令：
redis-dump -u :foobared@localhost:6379 > ./redis_data.jl
這樣我們就可以成功將 Redis 的所有數據庫的所有數據導出成 Json 行文件了。
另外我們可以使用 -d 參數指定某個數據庫的導出，例如只導出 1 號數據庫的內容：
redis-dump -u :foobared@localhost:6379 -d 1 > ./redis.data.jl
如果只想導出特定的內容，如想導出 adsl 開頭的數據，可以加入 -f 參數用來過濾，命令如下：
redis-dump -u :foobared@localhost:6379 -f adsl:* > ./redis.data.jl
其中 -f 的參數即 Redis 的 keys 命令的參數，可以寫一些過濾規則。
redis-load
我們同樣可以首先輸入如下命令查看所有可選項：
redis-load -h
運行結果如下：
redis-load --help
Try: redis-load [global options] COMMAND [command options]
-u, --uri=S Redis URI (e.g. redis://hostname[:port])
-d, --database=S Redis database (e.g. -d 15)
-s, --sleep=S Sleep for S seconds after dumping (for debugging)
-n, --no_check_utf8
-V, --version Display version
-D, --debug
--nosafe
可以看到其參數，-u 代表 Redis 連接字符串，-d 代表數據庫代號，默認全部，-s 代表導出之后的休眠時間，-n 代表不檢測 UTF-8 編碼，-V 顯示版本，-D 開啟調試。
我們可以將 Json 行文件導入到 Redis 數據庫中：
< redis_data.json redis-load -u :foobared@localhost:6379
這樣就可以成功將 Json 行文件導入到數據庫中了。
另外如下命令同樣可以達到同樣的效果：
cat redis_data.json | redis-load -u :foobared@localhost:6379