client-id.3valkey - Man Page
Returns the unique client ID of the connection.
Synopsis
CLIENT ID
Description
The command just returns the ID of the current connection. Every connection ID has certain guarantees:
- It is never repeated, so if
CLIENT ID
returns the same number, the caller can be sure that the underlying client did not disconnect and reconnect the connection, but it is still the same connection. - The ID is monotonically incremental. If the ID of a connection is greater than the ID of another connection, it is guaranteed that the second connection was established with the server at a later time.
This command is especially useful together with CLIENT UNBLOCK
. Check the CLIENT UNBLOCK
command page for a pattern involving the two commands.
Reply
valkey-protocol(7) Integer reply: the ID of the client.
Complexity
O(1)
Acl Categories
@connection @slow
History
- Available since: 5.0.0
Examples
127.0.0.1:6379> CLIENT ID (integer) 2873
See Also
auth(3valkey), client(3valkey), client-caching(3valkey), client-capa(3valkey), client-getname(3valkey), client-getredir(3valkey), client-help(3valkey), client-info(3valkey), client-kill(3valkey), client-list(3valkey), client-no-evict(3valkey), client-no-touch(3valkey), client-pause(3valkey), client-reply(3valkey), client-setinfo(3valkey), client-setname(3valkey), client-tracking(3valkey), client-trackinginfo(3valkey), client-unblock(3valkey), client-unpause(3valkey), echo(3valkey), hello(3valkey), ping(3valkey), reset(3valkey), select(3valkey)