SUBSCRIBE
Syntax
SUBSCRIBE channel [channel ...]
- Available since:
- Redis Open Source 2.0.0
- Time complexity:
- O(N) where N is the number of channels to subscribe to.
- ACL categories:
-
@pubsub
,@slow
,
Subscribes the client to the specified channels.
Once the client enters the subscribed state it is not supposed to issue any
other commands, except for additional SUBSCRIBE
, SSUBSCRIBE
, PSUBSCRIBE
, UNSUBSCRIBE
, SUNSUBSCRIBE
,
PUNSUBSCRIBE
, PING
, RESET
and QUIT
commands.
However, if RESP3 is used (see HELLO
) it is possible for a client to issue any commands while in subscribed state.
For more information, see Pub/sub.
Behavior change history
>= 6.2.0
:RESET
can be called to exit subscribed state.
Return information
When successful, this command doesn't return anything. Instead, for each channel, one message with the first element being the string
subscribe
is pushed as a confirmation that the command succeeded.