Download documentation

Choose the products and versions you want. Everything arrives as one .tar.gz, with a directory per product.

Format

This page

	Products	Version
	Develop with Redis Clients, data types, programmability, and Redis for AI. RedisVL is listed separately.
	Libraries and tools Client libraries, observability, and cloud integrations. Redis Data Integration is listed separately.
	RedisVL
	Redis Software
	Redis Cloud
	Redis for Kubernetes
	Redis Open Source
	Redis Iris context engine
	Redis Feature Form
	Redis Insight
	Redis Data Integration
	Glossary
	Command reference

SUNIONSTORE

Syntax text Syntax diagram API methods

SUNIONSTORE destination key [key ...]

Client:

sunionstore(
    dest: KeyT,
    keys: List,
    *args: List
) → Union[Awaitable[int], int]

SUNIONSTORE(
    destination: RedisArgument,
    keys: RedisVariadicArgument
) → Any

sunionstore(
    dstkey: byte[],
    keys: byte[]...
) → long  // The number of elements in the resulting set

sunionstore(
    dstkey: String,
    keys: String...
) → long  // The number of elements in the resulting set

sunionstore(
    destination: K,  // the destination type: key.
    keys: K...  // the key.
) → Long  // Long integer-reply the number of elements in the resulting set.

sunionstore(
    destination: K,  // the destination type: key.
    keys: K...  // the key.
) → RedisFuture<Long>  // Long integer-reply the number of elements in the resulting set.

sunionstore(
    destination: K,  // the destination type: key.
    keys: K...  // the key.
) → Mono<Long>  // Long integer-reply the number of elements in the resulting set.

SUnionStore(
    ctx: context.Context,
    destination: string,
    keys: ...string
) → *IntCmd

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    first: RedisKey,
    second: RedisKey,
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    keys: RedisKey[],  // The keys of the sets to operate on.
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    first: RedisKey,
    second: RedisKey,
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    keys: RedisKey[],  // The keys of the sets to operate on.
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    first: RedisKey,
    second: RedisKey,
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    keys: RedisKey[],  // The keys of the sets to operate on.
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    first: RedisKey,
    second: RedisKey,
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

SetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key of the destination set.
    keys: RedisKey[],  // The keys of the sets to operate on.
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting set.

sunionstore(
    $destination: string,
    $keys: array|string
) → int

sunionstore(
    dstkey: D,
    keys: K
) → (usize)

sunionstore(
    dstkey: D,
    keys: K
) → (usize)

Available since:: Redis Open Source 1.0.0
Time complexity:: O(N) where N is the total number of elements in all given sets.
ACL categories:: @write, @set, @slow,
Compatibility:: Redis Software and Redis Cloud compatibility

Note:

This command's behavior varies in clustered Redis environments. See the multi-key operations page for more information.

This command is equal to SUNION, but instead of returning the resulting set, it is stored in destination.

If destination already exists, it is overwritten.

Required arguments

destination

The key to store the resulting set in.

key [key ...]

One or more set keys to union.

Examples

redis> SADD key1 "a"
(integer) 1
redis> SADD key1 "b"
(integer) 1
redis> SADD key1 "c"
(integer) 1
redis> SADD key2 "c"
(integer) 1
redis> SADD key2 "d"
(integer) 1
redis> SADD key2 "e"
(integer) 1
redis> SUNIONSTORE key key1 key2
(integer) 5
redis> SMEMBERS key
1) "a"
2) "b"
3) "c"
4) "d"
5) "e"

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
✅ Standard ✅ Active-Active	✅ Standard ✅ Active-Active

Return information

RESP2 RESP3

Integer reply: the number of elements in the resulting set.

SUNIONSTORE

Required arguments

Examples

Redis Software and Redis Cloud compatibility

Return information

See also