42. Redis
42.1. Redis Version Support
The driver models Redis instances as relational databases. The driver leverages the Redis commands to enable bidirectional access to Redis and Redis Enterprise data through SQL. Redis 2.8.0 or above is required.
 
42.2. Connection Options
42.2.1. Authentication
Property
Description
AuthScheme
The authentication mechanism that the provider will use to authenticate with Redis.
Server
The host name or IP address of the server hosting the Redis instance.
Port
The port for the Redis database.
LogicalDatabase
The index of the Redis Logical Database.
Password
The password used to authenticate with Redis.
EnableCluster
This field sets whether the Redis Cluster Mode is enabled.
UseSSL
This field sets whether SSL is enabled.
42.2.2. Connection
Property
Description
DefineTables
Define the tables exposed by the provider using table names and Redis key patterns.
PatternSeparator
Define the table pattern's separator.
TablePattern
Define the tables exposed by the provider using Redis key patterns.
42.2.3. SSL
Property
Description
SSLClientCert
The TLS/SSL client certificate store for SSL Client Authentication (2-way SSL).
SSLClientCertType
The type of key store containing the TLS/SSL client certificate.
SSLClientCertPassword
The password for the TLS/SSL client certificate.
SSLClientCertSubject
The subject of the TLS/SSL client certificate.
SSLStartMode
This property determines how the provider starts the SSL negotiation.
SSLServerCert
The certificate to be accepted from the server when connecting using TLS/SSL.
42.2.4. SSH
Property
Description
SSHAuthMode
The authentication method to be used to log on to an SFTP server.
SSHClientCert
A certificate to be used for authenticating the user.
SSHClientCertPassword
The password of the SSHClientCert certificate if it has one.
SSHClientCertSubject
The subject of the SSH client certificate.
SSHClientCertType
The type of SSHClientCert certificate.
SSHServer
The SSH server.
SSHPort
The SSH port.
SSHUser
The SSH user.
SSHPassword
The SSH password.
SSHServerFingerprint
The SSH server fingerprint.
UseSSH
Whether to tunnel the Redis connection over SSH. Use SSH.
42.2.5. Firewall
Property
Description
FirewallType
The protocol used by a proxy-based firewall.
FirewallServer
The name or IP address of a proxy-based firewall.
FirewallPort
The TCP port for a proxy-based firewall.
FirewallUser
The user name to use to authenticate with a proxy-based firewall.
FirewallPassword
A password used to authenticate to a proxy-based firewall.
42.2.6. Logging
Property
Description
Logfile
A filepath which designates the name and location of the log file.
Verbosity
The verbosity level that determines the amount of detail included in the log file.
LogModules
Core modules to be included in the log file.
MaxLogFileSize
A string specifying the maximum size in bytes for a log file (for example, 10 MB).
MaxLogFileCount
A string specifying the maximum file count of log files.
42.2.7. Schema
Property
Description
Location
A path to the directory that contains the schema files defining tables, views, and stored procedures.
BrowsableSchemas
This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Tables
This property restricts the tables reported to a subset of the available tables. For example, Tables=TableA,TableB,TableC.
Views
Restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC.
42.2.8. Caching
Property
Description
AutoCache
Automatically caches the results of SELECT queries into a cache database specified by either CacheLocation or both of CacheConnection and CacheProvider .
CacheDriver
The database driver to be used to cache data.
CacheConnection
The connection string for the cache database. This property is always used in conjunction with CacheProvider . Setting both properties will override the value set for CacheLocation for caching data.
CacheLocation
Specifies the path to the cache when caching to a file.
CacheTolerance
The tolerance for stale data in the cache specified in seconds when using AutoCache .
Offline
Use offline mode to get the data from the cache instead of the live source.
CacheMetadata
This property determines whether or not to cache the table metadata to a file store.
42.2.9. Miscellaneous
Property
Description
BatchSize
The maximum size of each batch operation to submit.
ConnectionLifeTime
The maximum lifetime of a connection in seconds. Once the time has elapsed, the connection object is disposed.
ConnectOnOpen
This property species whether to connect to the Redis when the connection is opened.
IgnoreTypeErrors
Removes support for the specified data types and ignores casting exceptions for those types.
MaxRows
Limits the number of rows returned rows when no aggregation or group by is used in the query. This helps avoid performance issues at design time.
Other
These hidden properties are used only in specific use cases.
ParallelMode
This option sets whether the provider should use multiple connections when connecting to Redis.
PoolIdleTimeout
The allowed idle time for a connection before it is closed.
PoolMaxSize
The maximum connections in the pool.
PoolMinSize
The minimum number of connections in the pool.
PoolWaitTime
The max seconds to wait for an available connection.
PseudoColumns
This property indicates whether or not to include pseudo columns as columns to the table.
QueryTimeout
The timeout in seconds for which the provider will wait for the query response. The default value is -1, which indicates the provider should never time out.
Readonly
You can use this property to enforce read-only access to Redis from the provider.
RowScanDepth
The maximum number of rows to scan to look for the columns available in a table.
RTK
The runtime key used for licensing.
SupportEnhancedSQL
This property enhances SQL functionality beyond what can be supported through the API directly, by enabling in-memory client-side processing.
TableScanDepth
The maximum number of keys to scan when looking for tables available in your Redis database.
Timeout
The value in seconds until the timeout error is thrown, canceling the operation.
UseConnectionPooling
This property enables connection pooling.