Redis 键(key) keys 命令

野性酷女 2022-12-26 04:54 201阅读 0赞

### 文章目录 ###

*  Redis 键(key)
 *   *   *  语法
         *  实例
     *  Redis keys 命令
     *   *  DEL key : 删除已存在的键
         *  DUMP key : 序列化给定 key
         *  EXISTS key : key 是否存在
         *  EXPIRE key seconds : 秒计过期时间
         *  EXPIREAT key timestamp : UNIX 时间戳
         *  PEXPIRE key milliseconds : 毫秒计
         *  PEXPIREAT key milliseconds-timestamp : unix 毫秒计时
         *  KEYS pattern ： 查找所有符合给定模式
         *  MOVE key db ： key 移动到给定的数据库 db
         *  PERSIST key ：移除 key 的过期时间
         *  PTTL key ：毫秒为单位返回 key 剩余的过期时间
         *  TTL key ：剩余生存时间
         *  RANDOMKEY ：随机返回一个 key
         *  RENAME key newkey ：修改 key 的名称
         *  RENAMENX key newkey ：修改 key 的名称
         *  SCAN cursor \[ MATCH pattern \] \[COUNT count\] ：迭代
         *  TYPE key ：key 所储存的值的类型
 *

# Redis 键(key) #

Redis 键命令用于管理 redis 的键。

### 语法 ###

Redis 键命令的基本语法如下：

redis 127.0.0.1:6379> COMMAND KEY_NAME

### 实例 ###

redis 127.0.0.1:6379> SET mykey redisvalue
    OK
    redis 127.0.0.1:6379> DEL mykey
    (integer) 1

在以上实例中 **DEL** 是一个命令， **runoobkey** 是一个键。 如果键被删除成功，命令执行后输出 **(integer) 1**，否则将输出 **(integer) 0**

## Redis keys 命令 ##

下表给出了与 Redis 键相关的基本命令：

### DEL key : 删除已存在的键 ###

Redis DEL 命令用于删除已存在的键。不存在的 key 会被忽略。

redis DEL 命令基本语法如下：

redis 127.0.0.1:6379> DEL KEY_NAME

在 redis 中创建一个 key 并设置值。

redis 127.0.0.1:6379> SET w3ckey redis
    OK

现在我们删除已创建的 key。

redis 127.0.0.1:6379> DEL w3ckey
    (integer) 1

### DUMP key : 序列化给定 key ###

Redis DUMP 命令用于序列化给定 key ，并返回被序列化的值。

redis DUMP 命令基本语法如下：

redis 127.0.0.1:6379> DUMP KEY_NAME

如果 key 不存在，那么返回 nil 。 否则，返回序列化之后的值。

在 redis 中创建一个 key 并设置值。

redis> SET greeting "hello, dumping world!"
    OK

现在使用 DUMP 序列化键值。

redis> DUMP greeting
    "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde"
    
    redis> DUMP not-exists-key
    (nil)

### EXISTS key : key 是否存在 ###

检查给定 key 是否存在。

redis EXISTS 命令基本语法如下：

redis 127.0.0.1:6379> EXISTS KEY_NAME

若 key 存在返回 1 ，否则返回 0 。

redis 127.0.0.1:6379> EXISTS new-key
    (integer) 0

现在我们创建一个名为 new-key 的键并赋值，再使用 EXISTS 命令。

redis 127.0.0.1:6379> set new-key newkey
    OK
    redis 127.0.0.1:6379> EXISTS new-key
    (integer) 1
    redis 127.0.0.1:6379>

### EXPIRE key seconds : 秒计过期时间 ###

为给定 key 设置过期时间，以秒计。key 过期后将不再可用。

redis 127.0.0.1:6379> Expire KEY_NAME TIME_IN_SECONDS

设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

首先创建一个 key 并赋值：

redis 127.0.0.1:6379> SET mykey redis
    OK

为 key 设置过期时间：

redis 127.0.0.1:6379> EXPIRE mykey 60
    (integer) 1

以上实例中我们为键 mykey 设置了过期时间为 1 分钟，1分钟后该键会自动删除。

### EXPIREAT key timestamp : UNIX 时间戳 ###

EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置过期时间。 不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。以 UNIX 时间戳(unix timestamp)格式设置 key 的过期时间。key 过期后将不再可用。

redis 127.0.0.1:6379> Expireat KEY_NAME TIME_IN_UNIX_TIMESTAMP

设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

首先创建一个 key 并赋值：

redis 127.0.0.1:6379> SET mykey redis
    OK

为 key 设置过期时间：

redis 127.0.0.1:6379> EXPIREAT mykey 1293840000
    (integer) 1
    redis 127.0.0.1:6379> EXISTS mykey
    (integer) 0

### PEXPIRE key milliseconds : 毫秒计 ###

设置 key 的过期时间以毫秒计。

以毫秒为单位设置 key 的生存时间。

PEXPIRE key milliseconds

设置成功，返回 1

key 不存在或设置失败，返回 0

首先创建一个 key 并赋值：

redis> SET mykey "Hello"
    "OK"
    redis> PEXPIRE mykey 1500
    (integer) 1
    redis> TTL mykey
    (integer) 1
    redis> PTTL mykey
    (integer) 1498
    redis>

### PEXPIREAT key milliseconds-timestamp : unix 毫秒计时 ###

设置 key 过期时间的时间戳(unix timestamp) 以毫秒计

redis 127.0.0.1:6379> PEXPIREAT KEY_NAME TIME_IN_MILLISECONDS_IN_UNIX_TIMESTAMP

设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

首先创建一个 key 并赋值：

redis 127.0.0.1:6379> SET mykey redis
    OK

为 key 设置过期时间：

redis 127.0.0.1:6379> PEXPIREAT mykey 1555555555005
    (integer) 1

### KEYS pattern ： 查找所有符合给定模式 ###

查找所有符合给定模式( pattern)的 key 。

redis 127.0.0.1:6379> KEYS PATTERN

返回：符合给定模式的 key 列表 (Array)。

首先创建一些 key，并赋上对应值：

redis 127.0.0.1:6379> SET mykey1 redis
    OK
    redis 127.0.0.1:6379> SET mykey2 mysql
    OK
    redis 127.0.0.1:6379> SET mykey3 mongodb
    OK

查找以 my 为开头的 key：

redis 127.0.0.1:6379> KEYS my*
    1) "mykey3"
    2) "mykey1"
    3) "mykey2"

获取 redis 中所有的 key 可用使用 \*\*\*\*\*。

redis 127.0.0.1:6379> KEYS *
    1) "mykey3"
    2) "mykey1"
    3) "mykey2"

### MOVE key db ： key 移动到给定的数据库 db ###

将当前数据库的 key 移动到给定的数据库 db 当中。

redis 127.0.0.1:6379> MOVE KEY_NAME DESTINATION_DATABASE

移动成功返回 1 ，失败则返回 0 。

# key 存在于当前数据库
    
    redis> SELECT 0                             # redis默认使用数据库 0，为了清晰起见，这里再显式指定一次。
    OK
    
    redis> SET song "secret base - Zone"
    OK
    
    redis> MOVE song 1                          # 将 song 移动到数据库 1
    (integer) 1
    
    redis> EXISTS song                          # song 已经被移走
    (integer) 0
    
    redis> SELECT 1                             # 使用数据库 1
    OK
    
    redis:1> EXISTS song                        # 证实 song 被移到了数据库 1 (注意命令提示符变成了"redis:1"，表明正在使用数据库 1)
    (integer) 1
    
    
    # 当 key 不存在的时候
    
    redis:1> EXISTS fake_key
    (integer) 0
    
    redis:1> MOVE fake_key 0                    # 试图从数据库 1 移动一个不存在的 key 到数据库 0，失败
    (integer) 0
    
    redis:1> select 0                           # 使用数据库0
    OK
    
    redis> EXISTS fake_key                      # 证实 fake_key 不存在
    (integer) 0
    
    
    # 当源数据库和目标数据库有相同的 key 时
    
    redis> SELECT 0                             # 使用数据库0
    OK
    redis> SET favorite_fruit "banana"
    OK
    
    redis> SELECT 1                             # 使用数据库1
    OK
    redis:1> SET favorite_fruit "apple"
    OK
    
    redis:1> SELECT 0                           # 使用数据库0，并试图将 favorite_fruit 移动到数据库 1
    OK
    
    redis> MOVE favorite_fruit 1                # 因为两个数据库有相同的 key，MOVE 失败
    (integer) 0
    
    redis> GET favorite_fruit                   # 数据库 0 的 favorite_fruit 没变
    "banana"
    
    redis> SELECT 1
    OK
    
    redis:1> GET favorite_fruit                 # 数据库 1 的 favorite_fruit 也是
    "apple"

### PERSIST key ：移除 key 的过期时间 ###

移除 key 的过期时间，key 将持久保持。

redis 127.0.0.1:6379> PERSIST KEY_NAME

当过期时间移除成功时，返回 1 。 如果 key 不存在或 key 没有设置过期时间，返回 0 。

redis> SET mykey "Hello"
    OK
    
    redis> EXPIRE mykey 10  # 为 key 设置生存时间
    (integer) 1
    
    redis> TTL mykey
    (integer) 10
    
    redis> PERSIST mykey    # 移除 key 的生存时间
    (integer) 1
    
    redis> TTL mykey
    (integer) -1

### PTTL key ：毫秒为单位返回 key 剩余的过期时间 ###

以毫秒为单位返回 key 的剩余的过期时间。

redis 127.0.0.1:6379> PTTL KEY_NAME

当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以毫秒为单位，返回 key 的剩余生存时间。

\*\*注意：\*\*在 Redis 2.8 以前，当 key 不存在，或者 key 没有设置剩余生存时间时，命令都返回 -1 。

# 不存在的 key
    
    redis> FLUSHDB
    OK
    
    redis> PTTL key
    (integer) -2
    
    
    # key 存在，但没有设置剩余生存时间
    
    redis> SET key value
    OK
    
    redis> PTTL key
    (integer) -1
    
    
    # 有剩余生存时间的 key
    
    redis> PEXPIRE key 10086
    (integer) 1
    
    redis> PTTL key
    (integer) 6179

### TTL key ：剩余生存时间 ###

以秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)

redis 127.0.0.1:6379> TTL KEY_NAME

当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以秒为单位，返回 key 的剩余生存时间。

\*\*注意：\*\*在 Redis 2.8 以前，当 key 不存在，或者 key 没有设置剩余生存时间时，命令都返回 -1 。

# 不存在的 key
    
    redis> FLUSHDB
    OK
    
    redis> TTL key
    (integer) -2
    
    
    # key 存在，但没有设置剩余生存时间
    
    redis> SET key value
    OK
    
    redis> TTL key
    (integer) -1
    
    
    # 有剩余生存时间的 key
    
    redis> EXPIRE key 10086
    (integer) 1
    
    redis> TTL key
    (integer) 10084

### RANDOMKEY ：随机返回一个 key ###

从当前数据库中随机返回一个 key 。

redis 127.0.0.1:6379> RANDOMKEY

当数据库不为空时，返回一个 key 。 当数据库为空时，返回 nil （windows 系统返回 null）。

# 数据库不为空
    
    redis> MSET fruit "apple" drink "beer" food "cookies"   # 设置多个 key
    OK
    
    redis> RANDOMKEY
    "fruit"
    
    redis> RANDOMKEY
    "food"
    
    redis> KEYS *    # 查看数据库内所有key，证明 RANDOMKEY 并不删除 key
    1) "food"
    2) "drink"
    3) "fruit"
    
    # 数据库为空
    
    redis> FLUSHDB  # 删除当前数据库所有 key
    OK
    
    redis> RANDOMKEY
    (nil)

### RENAME key newkey ：修改 key 的名称 ###

修改 key 的名称

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

改名成功时提示 OK ，失败时候返回一个错误。

当 OLD\_KEY\_NAME 和 NEW\_KEY\_NAME 相同，或者 OLD\_KEY\_NAME 不存在时，返回一个错误。

当 NEW\_KEY\_NAME 已经存在时， RENAME 命令将覆盖旧值。

# key 存在且 newkey 不存在
    
    redis> SET message "hello world"
    OK
    
    redis> RENAME message greeting
    OK
    
    redis> EXISTS message               # message 不复存在
    (integer) 0
    
    redis> EXISTS greeting              # greeting 取而代之
    (integer) 1
    
    
    # 当 key 不存在时，返回错误
    
    redis> RENAME fake_key never_exists
    (error) ERR no such key
    
    
    # newkey 已存在时， RENAME 会覆盖旧 newkey
    
    redis> SET pc "lenovo"
    OK
    
    redis> SET personal_computer "dell"
    OK
    
    redis> RENAME pc personal_computer
    OK
    
    redis> GET pc
    (nil)
    
    redis:1> GET personal_computer      # 原来的值 dell 被覆盖了
    "lenovo"

### RENAMENX key newkey ：修改 key 的名称 ###

仅当 newkey 不存在时，将 key 改名为 newkey 。新的 key 不存在时修改 key 的名称 。

redis 127.0.0.1:6379> RENAMENX OLD_KEY_NAME NEW_KEY_NAME

修改成功时，返回 1 。 如果 NEW\_KEY\_NAME 已经存在，返回 0 。

# newkey 不存在，改名成功
    
    redis> SET player "MPlyaer"
    OK
    
    redis> EXISTS best_player
    (integer) 0
    
    redis> RENAMENX player best_player
    (integer) 1
    
    
    # newkey存在时，失败
    
    redis> SET animal "bear"
    OK
    
    redis> SET favorite_animal "butterfly"
    OK
    
    redis> RENAMENX animal favorite_animal
    (integer) 0
    
    redis> get animal
    "bear"
    
    redis> get favorite_animal
    "butterfly"

### SCAN cursor \[ MATCH pattern \] \[COUNT count\] ：迭代 ###

迭代数据库中的数据库键。

SCAN 命令是一个基于游标的迭代器，每次被调用之后， 都会向用户返回一个新的游标， 用户在下次迭代时需要使用这个新游标作为 SCAN 命令的游标参数， 以此来延续之前的迭代过程。

SCAN 返回一个包含两个元素的数组， 第一个元素是用于进行下一次迭代的新游标， 而第二个元素则是一个数组， 这个数组中包含了所有被迭代的元素。如果新游标返回 0 表示迭代已结束。

*  SSCAN 命令用于迭代集合键中的元素。
 *  HSCAN 命令用于迭代哈希键中的键值对。
 *  ZSCAN 命令用于迭代有序集合中的元素（包括元素成员和元素分值）。

SCAN cursor [MATCH pattern] [COUNT count]

*  cursor - 游标。
 *  pattern - 匹配的模式。
 *  count - 指定从数据集里返回多少元素，默认值为 10 。

返回数组列表。

使用 SCAN 命令迭代：

redis 127.0.0.1:6379> scan 0   # 使用 0 作为游标，开始新的迭代
    1) "17"                        # 第一次迭代时返回的游标
    2)  1) "key:12"
        2) "key:8"
        3) "key:4"
        4) "key:14"
        5) "key:16"
        6) "key:17"
        7) "key:15"
        8) "key:10"
        9) "key:3"
       10) "key:7"
       11) "key:1"
    redis 127.0.0.1:6379> scan 17  # 使用的是第一次迭代时返回的游标 17 开始新的迭代
    1) "0"
    2) 1) "key:5"
       2) "key:18"
       3) "key:0"
       4) "key:2"
       5) "key:19"
       6) "key:13"
       7) "key:6"
       8) "key:9"
       9) "key:11"

### TYPE key ：key 所储存的值的类型 ###

返回 key 所储存的值的类型。

redis 127.0.0.1:6379> TYPE KEY_NAME

返回 key 的数据类型，数据类型有：

*  none (key不存在)
 *  string (字符串)
 *  list (列表)
 *  set (集合)
 *  zset (有序集)
 *  hash (哈希表)

# 字符串
    
    redis> SET weather "sunny"
    OK
    
    redis> TYPE weather
    string
    
    
    # 列表
    
    redis> LPUSH book_list "programming in scala"
    (integer) 1
    
    redis> TYPE book_list
    list
    
    
    # 集合
    
    redis> SADD pat "dog"
    (integer) 1
    
    redis> TYPE pat
    set

#  #