# SORT
**SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] [ASC | DESC] [ALPHA] [STORE destination]**
返回或保存给定列表、集合、有序集合 `key` 中经过排序的元素。
排序默认以数字作为对象，值被解释为双精度浮点数，然后进行比较。
## 一般 SORT 用法
最简单的 [SORT](#sort) 使用方法是 `SORT key` 和 `SORT key DESC` ：
* `SORT key` 返回键值从小到大排序的结果。
* `SORT key DESC` 返回键值从大到小排序的结果。
假设 `today_cost` 列表保存了今日的开销金额， 那么可以用 [SORT](#sort) 命令对它进行排序：
```
# 开销金额列表
redis> LPUSH today_cost 30 1.5 10 8
(integer) 4
# 排序
redis> SORT today_cost
1) "1.5"
2) "8"
3) "10"
4) "30"
# 逆序排序
redis 127.0.0.1:6379> SORT today_cost DESC
1) "30"
2) "10"
3) "8"
4) "1.5"
```
## 使用 ALPHA 修饰符对字符串进行排序
因为 [SORT](#sort) 命令默认排序对象为数字， 当需要对字符串进行排序时， 需要显式地在 [SORT](#sort) 命令之后添加 `ALPHA` 修饰符：
```
# 网址
redis> LPUSH website "www.reddit.com"
(integer) 1
redis> LPUSH website "www.slashdot.com"
(integer) 2
redis> LPUSH website "www.infoq.com"
(integer) 3
# 默认（按数字）排序
redis> SORT website
1) "www.infoq.com"
2) "www.slashdot.com"
3) "www.reddit.com"
# 按字符排序
redis> SORT website ALPHA
1) "www.infoq.com"
2) "www.reddit.com"
3) "www.slashdot.com"
```
如果系统正确地设置了 `LC_COLLATE` 环境变量的话，Redis能识别 `UTF-8` 编码。
## 使用 LIMIT 修饰符限制返回结果
排序之后返回元素的数量可以通过 `LIMIT` 修饰符进行限制， 修饰符接受 `offset` 和 `count` 两个参数：
* `offset` 指定要跳过的元素数量。
* `count` 指定跳过 `offset` 个指定的元素之后，要返回多少个对象。
以下例子返回排序结果的前 5 个对象( `offset` 为 `0` 表示没有元素被跳过)。
```
# 添加测试数据，列表值为 1 指 10
redis 127.0.0.1:6379> RPUSH rank 1 3 5 7 9
(integer) 5
redis 127.0.0.1:6379> RPUSH rank 2 4 6 8 10
(integer) 10
# 返回列表中最小的 5 个值
redis 127.0.0.1:6379> SORT rank LIMIT 0 5
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
```
可以组合使用多个修饰符。以下例子返回从大到小排序的前 5 个对象。
```
redis 127.0.0.1:6379> SORT rank LIMIT 0 5 DESC
1) "10"
2) "9"
3) "8"
4) "7"
5) "6"
```
## 使用外部 key 进行排序
可以使用外部 `key` 的数据作为权重，代替默认的直接对比键值的方式来进行排序。
假设现在有用户数据如下：
| uid | user_name_{uid} | user_level_{uid} |
| --- | --- | --- |
| 1 | admin | 9999 |
| 2 | jack | 10 |
| 3 | peter | 25 |
| 4 | mary | 70 |
以下代码将数据输入到 Redis 中：
```
# admin
redis 127.0.0.1:6379> LPUSH uid 1
(integer) 1
redis 127.0.0.1:6379> SET user_name_1 admin
OK
redis 127.0.0.1:6379> SET user_level_1 9999
OK
# jack
redis 127.0.0.1:6379> LPUSH uid 2
(integer) 2
redis 127.0.0.1:6379> SET user_name_2 jack
OK
redis 127.0.0.1:6379> SET user_level_2 10
OK
# peter
redis 127.0.0.1:6379> LPUSH uid 3
(integer) 3
redis 127.0.0.1:6379> SET user_name_3 peter
OK
redis 127.0.0.1:6379> SET user_level_3 25
OK
# mary
redis 127.0.0.1:6379> LPUSH uid 4
(integer) 4
redis 127.0.0.1:6379> SET user_name_4 mary
OK
redis 127.0.0.1:6379> SET user_level_4 70
OK
```
### BY 选项
默认情况下， `SORT uid` 直接按 `uid` 中的值排序：
```
redis 127.0.0.1:6379> SORT uid
1) "1" # admin
2) "2" # jack
3) "3" # peter
4) "4" # mary
```
通过使用 `BY` 选项，可以让 `uid` 按其他键的元素来排序。
比如说， 以下代码让 `uid` 键按照 `user_level_{uid}` 的大小来排序：
```
redis 127.0.0.1:6379> SORT uid BY user_level_*
1) "2" # jack , level = 10
2) "3" # peter, level = 25
3) "4" # mary, level = 70
4) "1" # admin, level = 9999
```
`user_level_*` 是一个占位符， 它先取出 `uid` 中的值， 然后再用这个值来查找相应的键。
比如在对 `uid` 列表进行排序时， 程序就会先取出 `uid` 的值 `1` 、 `2` 、 `3` 、 `4` ， 然后使用 `user_level_1` 、 `user_level_2` 、 `user_level_3` 和 `user_level_4` 的值作为排序 `uid` 的权重。
### GET 选项
使用 `GET` 选项， 可以根据排序的结果来取出相应的键值。
比如说， 以下代码先排序 `uid` ， 再取出键 `user_name_{uid}` 的值：
```
redis 127.0.0.1:6379> SORT uid GET user_name_*
1) "admin"
2) "jack"
3) "peter"
4) "mary"
```
### 组合使用 BY 和 GET
通过组合使用 `BY` 和 `GET` ， 可以让排序结果以更直观的方式显示出来。
比如说， 以下代码先按 `user_level_{uid}` 来排序 `uid` 列表， 再取出相应的 `user_name_{uid}` 的值：
```
redis 127.0.0.1:6379> SORT uid BY user_level_* GET user_name_*
1) "jack" # level = 10
2) "peter" # level = 25
3) "mary" # level = 70
4) "admin" # level = 9999
```
现在的排序结果要比只使用 `SORT uid BY user_level_*` 要直观得多。
### 获取多个外部键
可以同时使用多个 `GET` 选项， 获取多个外部键的值。
以下代码就按 `uid` 分别获取 `user_level_{uid}` 和 `user_name_{uid}` ：
```
redis 127.0.0.1:6379> SORT uid GET user_level_* GET user_name_*
1) "9999" # level
2) "admin" # name
3) "10"
4) "jack"
5) "25"
6) "peter"
7) "70"
8) "mary"
```
`GET` 有一个额外的参数规则，那就是 —— 可以用 `#` 获取被排序键的值。
以下代码就将 `uid` 的值、及其相应的 `user_level_*` 和 `user_name_*` 都返回为结果：
```
redis 127.0.0.1:6379> SORT uid GET # GET user_level_* GET user_name_*
1) "1" # uid
2) "9999" # level
3) "admin" # name
4) "2"
5) "10"
6) "jack"
7) "3"
8) "25"
9) "peter"
10) "4"
11) "70"
12) "mary"
```
### 获取外部键，但不进行排序
通过将一个不存在的键作为参数传给 `BY` 选项， 可以让 `SORT` 跳过排序操作， 直接返回结果：
```
redis 127.0.0.1:6379> SORT uid BY not-exists-key
1) "4"
2) "3"
3) "2"
4) "1"
```
这种用法在单独使用时，没什么实际用处。
不过，通过将这种用法和 `GET` 选项配合， 就可以在不排序的情况下， 获取多个外部键， 相当于执行一个整合的获取操作（类似于 SQL 数据库的 `join` 关键字）。
以下代码演示了，如何在不引起排序的情况下，使用 `SORT` 、 `BY` 和 `GET` 获取多个外部键：
```
redis 127.0.0.1:6379> SORT uid BY not-exists-key GET # GET user_level_* GET user_name_*
1) "4" # id
2) "70" # level
3) "mary" # name
4) "3"
5) "25"
6) "peter"
7) "2"
8) "10"
9) "jack"
10) "1"
11) "9999"
12) "admin"
```
### 将哈希表作为 GET 或 BY 的参数
除了可以将字符串键之外， 哈希表也可以作为 `GET` 或 `BY` 选项的参数来使用。
比如说，对于前面给出的用户信息表：
| uid | user_name_{uid} | user_level_{uid} |
| --- | --- | --- |
| 1 | admin | 9999 |
| 2 | jack | 10 |
| 3 | peter | 25 |
| 4 | mary | 70 |
我们可以不将用户的名字和级别保存在 `user_name_{uid}` 和 `user_level_{uid}` 两个字符串键中， 而是用一个带有 `name` 域和 `level` 域的哈希表 `user_info_{uid}` 来保存用户的名字和级别信息：
```
redis 127.0.0.1:6379> HMSET user_info_1 name admin level 9999
OK
redis 127.0.0.1:6379> HMSET user_info_2 name jack level 10
OK
redis 127.0.0.1:6379> HMSET user_info_3 name peter level 25
OK
redis 127.0.0.1:6379> HMSET user_info_4 name mary level 70
OK
```
之后， `BY` 和 `GET` 选项都可以用 `key->field` 的格式来获取哈希表中的域的值， 其中 `key` 表示哈希表键， 而 `field` 则表示哈希表的域：
```
redis 127.0.0.1:6379> SORT uid BY user_info_*->level
1) "2"
2) "3"
3) "4"
4) "1"
redis 127.0.0.1:6379> SORT uid BY user_info_*->level GET user_info_*->name
1) "jack"
2) "peter"
3) "mary"
4) "admin"
```
## 保存排序结果
默认情况下， [SORT](#sort) 操作只是简单地返回排序结果，并不进行任何保存操作。
通过给 `STORE` 选项指定一个 `key` 参数，可以将排序结果保存到给定的键上。
如果被指定的 `key` 已存在，那么原有的值将被排序结果覆盖。
```
# 测试数据
redis 127.0.0.1:6379> RPUSH numbers 1 3 5 7 9
(integer) 5
redis 127.0.0.1:6379> RPUSH numbers 2 4 6 8 10
(integer) 10
redis 127.0.0.1:6379> LRANGE numbers 0 -1
1) "1"
2) "3"
3) "5"
4) "7"
5) "9"
6) "2"
7) "4"
8) "6"
9) "8"
10) "10"
redis 127.0.0.1:6379> SORT numbers STORE sorted-numbers
(integer) 10
# 排序后的结果
redis 127.0.0.1:6379> LRANGE sorted-numbers 0 -1
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
8) "8"
9) "9"
10) "10"
```
可以通过将 [SORT](#sort) 命令的执行结果保存，并用 [_EXPIRE_](expire.html#expire) 为结果设置生存时间，以此来产生一个 [SORT](#sort) 操作的结果缓存。
这样就可以避免对 [SORT](#sort) 操作的频繁调用：只有当结果集过期时，才需要再调用一次 [SORT](#sort) 操作。
另外，为了正确实现这一用法，你可能需要加锁以避免多个客户端同时进行缓存重建(也就是多个客户端，同一时间进行 [SORT](#sort) 操作，并保存为结果集)，具体参见 [_SETNX_](../string/setnx.html#setnx) 命令。
**可用版本：**
>= 1.0.0
**时间复杂度：**
O(N+M*log(M))， `N` 为要排序的列表或集合内的元素数量， `M` 为要返回的元素数量。如果只是使用 [SORT](#sort) 命令的 `GET` 选项获取数据而没有进行排序，时间复杂度 O(N)。
**返回值：**
没有使用 `STORE` 参数，返回列表形式的排序结果。使用 `STORE` 参数，返回排序结果的元素数量。<split>
# TTL
**TTL key**
以秒为单位，返回给定 `key` 的剩余生存时间(TTL, time to live)。
**可用版本：**
>= 1.0.0
**时间复杂度：**
O(1)
**返回值：**
当 `key` 不存在时，返回 `-2` 。当 `key` 存在但没有设置剩余生存时间时，返回 `-1` 。否则，以秒为单位，返回 `key` 的剩余生存时间。
Note
在 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
```
- Redis 文档
- 键空间通知（keyspace notification）
- 事务（transaction）
- 发布与订阅（pub/sub）
- 复制（Replication）
- 通信协议（protocol）
- 持久化（persistence）
- Sentinel
- 集群教程
- Redis 集群规范
- Redis 命令参考
- Key（键）
- DEL
- DUMP
- EXISTS
- EXPIRE
- EXPIREAT
- KEYS
- MIGRATE
- MOVE
- OBJECT
- PERSIST
- PEXPIRE
- PEXPIREAT
- PTTL
- RANDOMKEY
- RENAME
- RENAMENX
- RESTORE
- SORT
- TYPE
- SCAN
- String（字符串）
- APPEND
- BITCOUNT
- BITOP
- DECR
- DECRBY
- GET
- GETBIT
- GETRANGE
- GETSET
- INCR
- INCRBY
- INCRBYFLOAT
- MGET
- MSET
- MSETNX
- PSETEX
- SET
- SETBIT
- SETEX
- SETNX
- SETRANGE
- STRLEN
- Hash（哈希表）
- HDEL
- HEXISTS
- HGET
- HGETALL
- HINCRBY
- HINCRBYFLOAT
- HKEYS
- HLEN
- HMGET
- HMSET
- HSET
- HSETNX
- HVALS
- HSCAN
- List（列表）
- BLPOP
- BRPOP
- BRPOPLPUSH
- LINDEX
- LINSERT
- LLEN
- LPOP
- LPUSH
- LRANGE
- LREM
- LSET
- LTRIM
- RPOP
- RPOPLPUSH
- RPUSH
- RPUSHX
- Set（集合）
- SADD
- SCARD
- SDIFF
- SDIFFSTORE
- SINTER
- SINTER
- SINTERSTORE
- SISMEMBER
- SMEMBERS
- SMOVE
- SPOP
- SRANDMEMBER
- SREM
- SUNION
- SUNIONSTORE
- SSCAN
- SortedSet（有序集合）
- ZADD
- ZCARD
- ZCOUNT
- ZINCRBY
- ZRANGE
- ZRANGEBYSCORE
- ZRANK
- ZREM
- ZREMRANGEBYRANK
- ZREMRANGEBYSCORE
- ZREVRANGE
- ZREVRANGEBYSCORE
- ZREVRANK
- ZSCORE
- ZUNIONSTORE
- ZINTERSTORE
- ZSCAN
- Pub/Sub（发布/订阅）
- PSUBSCRIBE
- PUBLISH
- PUBSUB
- PUNSUBSCRIBE
- SUBSCRIBE
- UNSUBSCRIBE
- Transaction（事务）
- DISCARD
- EXEC
- MULTI
- UNWATCH
- WATCH
- Script（脚本）
- EVAL
- EVALSHA
- SCRIPT EXISTS
- SCRIPT FLUSH
- SCRIPT KILL
- SCRIPT LOAD
- Connection（连接）
- AUTH
- ECHO
- PING
- QUIT
- SELECT
- Server（服务器）
- BGREWRITEAOF
- BGSAVE
- CLIENT GETNAME
- CLIENT KILL
- CLIENT LIST
- CLIENT SETNAME
- CONFIG GET
- CONFIG RESETSTAT
- CONFIG REWRITE
- CONFIG SET
- DBSIZE
- DEBUG OBJECT
- DEBUG SEGFAULT
- FLUSHALL
- FLUSHDB
- INFO
- LASTSAVE
- MONITOR
- PSYNC
- SAVE
- SHUTDOWN
- SLAVEOF
- SLOWLOG
- SYNC
- TIME
- 关于