redis_connect/3

Availability::- use_module(library(redis)).(can be autoloaded)

[det]redis_connect(-Connection)

[det]redis_connect(+Address, -Connection, +Options)

[det]redis_connect(-Connection, +Host, +Port)

Connect to a redis server. The main mode is redis_connect(+Address, -Connection, +Options). redis_connect/1 is equivalent to redis_connect(localhost:6379, Connection, []). Options:

reconnect(+Boolean): If true, try to reconnect to the service when the connection seems lost. Default is true for connections specified using redis_server/3 and false for explictly opened connections.
user(+User): If version(3) and password(Password) are specified, these are used to authenticate using the HELLO command.
password(+Password): Authenticate using Password
version(+Version): Specify the connection protocol version. Initially this is version 2. Redis 6 also supports version 3. When specified as 3, the HELLO command is used to upgrade the protocol.
tls(true): When specified, initiate a TLS connection. If this option is specified we must also specify the cacert, key and cert options.
cacert(+File): CA Certificate file to verify with.
cert(+File): Client certificate to authenticate with.
key(+File): Private key file to authenticate with.
sentinels(+ListOfAddresses): Used together with an Address of the form sentinel(MasterName) to enable contacting a network of Redis servers guarded by a sentinel network.
sentinel_user(+User)
sentinel_password(+Password): Authentication information for the senitels. When omitted we try to connect withour authentication.

Instead of using these predicates, redis/2 and redis/3 are normally used with a server name argument registered using redis_server/3. These predicates are meant for creating a temporary paralel connection or using a connection with a blocking call.

Address is a term Host:Port, unix(File) or the name of a server registered using redis_server/3. The latter realises a new connection that is typically used for blocking redis commands such as listening for published messages, waiting on a list or stream.

Compatibility: redis_connect(-Connection, +Host, +Port) provides compatibility to the original GNU-Prolog interface and is equivalent to redis_connect(Host:Port, Connection, []).