12. CockroachDB
12.1. CockroachDB Version Support
The driver enables standards-based access to Cockroach DB version 2.0 and later.
 
12.2. Connection Options
12.2.1. Authentication
Property
Description
Server
The host name or IP address of the server.
Port
The port number of the CockroachDB server.
Database
The name of the Cockroach database.
User
The CockroachDB user account used to authenticate.
Password
The password used to authenticate the user.
UseSSL
Whether SSL is enabled.
12.2.2. 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.
SSLServerCert
The certificate to be accepted from the server when connecting using TLS/SSL.
12.2.3. 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.
12.2.4. 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.
12.2.5. 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.
12.2.6. Miscellaneous
Property
Description
AllowPreparedStatement
Allow the preparation of a query statement before its execution.
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 CockroachDB when the connection is opened.
FetchResultSetMetadata
This field sets whether the provider is getting detailed information about resultset columns from the server.
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.
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.
QueryPassthrough
This option passes the query to the CockroachDB server as is.
Readonly
You can use this property to enforce read-only access to CockroachDB from the provider.
RTK
The runtime key used for licensing.
Timeout
The value in seconds until the timeout error is thrown, canceling the operation.
TimeZone
The time zone for the current session.
UseConnectionPooling
This property enables connection pooling.