A service that provides connections to Redis.


redis, cache


In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, whether a property supports the NiFi Expression Language, and whether a property is considered “sensitive”, meaning that its value will be encrypted. Before entering a value in a sensitive property, ensure that the file has an entry for the property nifi.sensitive.props.key.


Default Value

Allowable Values


Redis Mode

Standalone * Standalone
* Sentinel
* Cluster 
The type of Redis being communicated with - standalone, sentinel, or clustered.

Connection String

The connection string for Redis. In a standalone instance this value will be of the form hostname:port. In a sentinel instance this value will be the comma-separated list of sentinels, such as host1:port1,host2:port2,host3:port3. In a clustered instance this value will be the comma-separated list of cluster masters, such as host1:port,host2:port,host3:port.

Supports Expression Language: true

Database Index

0 The database index to be used by connections created from this connection pool. See the databases property in redis.conf, by default databases 0-15 will be available.

Supports Expression Language: true

Communication Timeout

10 seconds The timeout to use when attempting to communicate with Redis.

Cluster Max Redirects

5 The maximum number of redirects that can be performed when clustered.
Sentinel Master The name of the sentinel master, require when Mode is set to Sentinel

Supports Expression Language: true

Password The password used to authenticate to the Redis server. See the requirepass property in redis.conf.

Sensitive Property: true

Supports Expression Language: true

Pool - Max Total

8 The maximum number of connections that can be allocated by the pool (checked out to clients, or idle awaiting checkout). A negative value indicates that there is no limit.

Pool - Max Idle

8 The maximum number of idle connections that can be held in the pool, or a negative value if there is no limit.

Pool - Min Idle

0 The target for the minimum number of idle connections to maintain in the pool. If the configured value of Min Idle is greater than the configured value for Max Idle, then the value of Max Idle will be used instead.

Pool - Block When Exhausted

true * true
* false
If clients should block and wait when trying to obtain a connection from the pool when the pool has no available connections. Setting this to false means an error will occur immediately when a client requests a connection and none are available.

Pool - Max Wait Time

10 seconds The amount of time to wait for an available connection when Block When Exhausted is set to true.

Pool - Min Evictable Idle Time

60 seconds The minimum amount of time an object may sit idle in the pool before it is eligible for eviction.

Pool - Time Between Eviction Runs

30 seconds The amount of time between attempting to evict idle connections from the pool.

Pool - Num Tests Per Eviction Run

-1 The number of connections to tests per eviction attempt. A negative value indicates to test all connections.

Pool - Test on Create

false * true
* false
If connections should be tested upon creation.

Pool - Test on Borrow

false * true
* false
If connections should be tested upon borrowing from the pool.

Pool - Test on Return

false * true
* false
If connections should be tested upon returning to the pool.

Pool - Test While Idle

true * true
* false
If connections should be tested while idle.

State management:

This component does not store state.


This component is not restricted.