Redis Iris

Redis install Data types

Tools Community Docs

Login Sign up

Develop with Redis Libraries and tools Redis products

Commands

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

HSCAN

Syntax text Syntax diagram API methods

HSCAN key cursor [MATCH pattern] [COUNT count] [NOVALUES]

Client:

hscan(
    name: KeyT,
    cursor: int = 0,
    match: Union[PatternT, None] = None,
    count: Optional[int] = None,
    no_values: Union[bool, None] = None
) → ResponseT

Possible errors

ERR syntax error: ResponseError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

HSCAN(
    key: RedisArgument,
    cursor: RedisArgument,
    options?: ScanCommonOptions
) → Any

Possible errors

ERR syntax error: SimpleError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

hscan(
    key: byte[],
    params: byte[] cursor final ScanParams
) → ScanResult<Map.Entry<byte[], byte[]>>

hscan(
    key: String,
    params: String cursor final ScanParams
) → ScanResult<Map.Entry<String, String>>

hscanNoValues(
    key: String,
    cursor: String,
    params: ScanParams
) → ScanResult<String>  // OK @deprecated Use Jedis#set(String, String, redis.clients.jedis.params.SetParams) with redis.clients.jedis.params.SetParams#px(long). Deprecated in Jedis 8.0.0. Mirrors Redis deprecation since 2.6.12.

Possible errors

ERR syntax error: JedisDataException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

hscan(
    key: K  // the key.
) → MapScanCursor<K, V>  // StreamScanCursor scan cursor.

hscanNovalues(
    key: K  // the key.
) → KeyScanCursor<K>  // StreamScanCursor scan cursor. @since 6.4

hscan(
    key: K,  // the key.
    scanArgs: ScanArgs
) → MapScanCursor<K, V>  // StreamScanCursor scan cursor.

hscanNovalues(
    key: K,  // the key.
    scanArgs: ScanArgs
) → KeyScanCursor<K>  // StreamScanCursor scan cursor. @since 6.4

hscan(
    key: K,  // the key.
    scanCursor: ScanCursor,  // cursor to resume from a previous scan, must not be null.
    scanArgs: ScanArgs
) → MapScanCursor<K, V>  // StreamScanCursor scan cursor.

Possible errors

ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

hscan(
    key: K  // the key.
) → RedisFuture<MapScanCursor<K, V>>  // StreamScanCursor scan cursor.

hscanNovalues(
    key: K  // the key.
) → RedisFuture<KeyScanCursor<K>>  // StreamScanCursor scan cursor. @since 6.4

hscan(
    key: K,  // the key.
    scanArgs: ScanArgs
) → RedisFuture<MapScanCursor<K, V>>  // StreamScanCursor scan cursor.

hscanNovalues(
    key: K,  // the key.
    scanArgs: ScanArgs
) → RedisFuture<KeyScanCursor<K>>  // StreamScanCursor scan cursor. @since 6.4

hscan(
    key: K,  // the key.
    scanCursor: ScanCursor,  // cursor to resume from a previous scan, must not be null.
    scanArgs: ScanArgs
) → RedisFuture<MapScanCursor<K, V>>  // StreamScanCursor scan cursor.

Possible errors

ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

hscan(
    key: K  // the key.
) → Mono<MapScanCursor<K, V>>  // StreamScanCursor scan cursor. @deprecated since 6.0 in favor of consuming large results through the org.reactivestreams.Publisher returned by #hscan.

hscanNovalues(
    key: K  // the key.
) → Mono<KeyScanCursor<K>>  // StreamScanCursor scan cursor. @deprecated since 6.4 in favor of consuming large results through the org.reactivestreams.Publisher returned by #hscanNovalues.

hscan(
    key: K,  // the key.
    scanArgs: ScanArgs
) → Mono<MapScanCursor<K, V>>  // StreamScanCursor scan cursor. @deprecated since 6.0 in favor of consuming large results through the org.reactivestreams.Publisher returned by #hscan.

hscanNovalues(
    key: K,  // the key.
    scanArgs: ScanArgs
) → Mono<KeyScanCursor<K>>  // StreamScanCursor scan cursor. @deprecated since 6.4 in favor of consuming large results through the org.reactivestreams.Publisher returned by #hscanNovalues.

hscan(
    key: K,  // the key.
    scanCursor: ScanCursor,  // cursor to resume from a previous scan, must not be null.
    scanArgs: ScanArgs
) → Mono<MapScanCursor<K, V>>  // StreamScanCursor scan cursor. @deprecated since 6.0 in favor of consuming large results through the org.reactivestreams.Publisher returned by #hscan.

Possible errors

ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

HScan(
    ctx: context.Context,
    key: string,
    cursor: uint64,
    match: string,
    count: int64
) → *ScanCmd

HScanNoValues(
    ctx: context.Context,
    key: string,
    cursor: uint64,
    match: string,
    count: int64
) → *ScanCmd

Possible errors

ERR syntax error: redis.Error

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

HashScan(
    key: RedisKey,  // The key of the hash.
    pattern: RedisValue,  // The pattern of keys to get entries for.
    pageSize: int,  // The page size to iterate by.
    flags: CommandFlags  // The flags to use for this operation.
) → IEnumerable<HashEntry>  // Yields all elements of the hash matching the pattern.

HashScan(
    key: RedisKey,  // The key of the hash.
    pattern: RedisValue,  // The pattern of keys to get entries for.
    pageSize: int,  // The page size to iterate by.
    cursor: long,  // The cursor position to start at.
    pageOffset: int,  // The page offset to start at.
    flags: CommandFlags  // The flags to use for this operation.
) → IEnumerable<HashEntry>  // Yields all elements of the hash matching the pattern.

Possible errors

ERR syntax error: RedisServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

HashScan(
    key: RedisKey,  // The key of the hash.
    pattern: RedisValue,  // The pattern of keys to get entries for.
    pageSize: int,  // The page size to iterate by.
    flags: CommandFlags  // The flags to use for this operation.
) → IEnumerable<HashEntry>  // Yields all elements of the hash matching the pattern.

HashScan(
    key: RedisKey,  // The key of the hash.
    pattern: RedisValue,  // The pattern of keys to get entries for.
    pageSize: int,  // The page size to iterate by.
    cursor: long,  // The cursor position to start at.
    pageOffset: int,  // The page offset to start at.
    flags: CommandFlags  // The flags to use for this operation.
) → IEnumerable<HashEntry>  // Yields all elements of the hash matching the pattern.

Possible errors

ERR syntax error: RedisServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

hscan(
    $key: string,
    $cursor: Any,
    ?array $options = null: Any
) → array

Possible errors

ERR syntax error: Predis\Response\ServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

Available since:: Redis Open Source 2.8.0
Time complexity:: O(1) for every call. O(N) for a complete iteration, including enough command calls for the cursor to return back to 0. N is the number of elements inside the collection.
ACL categories:: @read, @hash, @slow,
Compatibility:: Redis Software and Redis Cloud compatibility

See SCAN for HSCAN documentation.

Required arguments

key

The name of the key that holds the hash.

cursor

The cursor value. Start an iteration with 0, then use the cursor returned by each call as the argument to the next call.

Optional arguments

MATCH pattern

Only return fields whose names match the given glob-style pattern.

COUNT count

A hint for the number of fields to return per iteration. The default is 10.

NOVALUES

Return only the field names, without their values.

Redis Software and Redis Cloud compatibility

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

Return information

RESP2 RESP3

Array reply: a two-element array.

The first element is a Bulk string reply that represents an unsigned 64-bit number, the cursor.
The second element is an Array reply of field/value pairs that were scanned. When the NOVALUES flag (since Redis 7.4) is used, only the field names are returned.