summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/select.md
blob: ff366c6ef1f01668c589ba726657060bf60f1429 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Select the Redis logical database having the specified zero-based numeric index.
New connections always use the database 0.

Selectable Redis databases are a form of namespacing: all databases are still
persisted in the same RDB / AOF file. However different databases can have keys
with the same name, and commands like `FLUSHDB`, `SWAPDB` or `RANDOMKEY` work on
specific databases.

In practical terms, Redis databases should be used to separate different keys
belonging to the same application (if needed), and not to use a single Redis
instance for multiple unrelated applications.

When using Redis Cluster, the `SELECT` command cannot be used, since Redis
Cluster only supports database zero. In the case of a Redis Cluster, having
multiple databases would be useless and an unnecessary source of complexity.
Commands operating atomically on a single database would not be possible with
the Redis Cluster design and goals.

Since the currently selected database is a property of the connection, clients
should track the currently selected database and re-select it on reconnection.
While there is no command in order to query the selected database in the current
connection, the `CLIENT LIST` output shows, for each client, the currently
selected database.

@return

@simple-string-reply