ODBC Driver for NexusDB

Connection String Options - ODBC Driver for NexusDB

NexusDB ODBC Connection String Options

The following table lists the connection string options for NexusDB.

Option Description

Database

Used to specify the path to the Embedded database.

Used to specify the database name (alias) of the Remote database.

DatabaseReadOnly

Used to prevent users from modifying data in the database. The default value is False.

Password

Used to specify the password for the NexusDB database user.

Port

Used to specify the port for connection to the database server, 16000 by default.

Server

Used to specify the NexusDB server address.

User ID

Used to specify the NexusDB database user.

Advanced Settings

Option Description

Allow NULL strings

To retrieve metadata, not all parameters according to MSDN can accept a null value. If NULL, the driver should return an error. But some 3rd-party tools pass NULL to the parameters. These options should be enabled for compatibility with such tools.

Empty strings as NULL

Command Timeout

Used to specify the amount of time in seconds before an attempt to execute a command is considered unsuccessful. The default value is 15.

Connection Timeout

The time (in seconds) to wait for a connection to open before terminating an attempt. The default value is 15.

HeartbeatInterval

Used to specify how often the client will send a hearbeat message to the server. The default value is 10.

ODBC Behavior

Used to set the behavior corresponding to the ODBC specification version that a third-party tool expects. The behavior of ODBC driver can be changed by setting a value for the SQL_ATTR_ODBC_VERSION attribute by calling the SQLSetEnvAttr function. But some third-party tools expect the driver to exhibit ODBC 2.x behavior, but forget to call SQLSetEnvAttr with the specified version or pass an incorrect value there. In this case, the required behavior can be explicitly specified in the Connection String by setting the ODBC Behavior parameter. The possible values are:

  • Default - default ODBC behavior determined by a third-party tool.
  • Ver 2.x - ODBC 2.x behavior is explicitly set.
  • Ver 3.x - ODBC 3.x behavior is explicitly set.

RegionalNumberSettings

Enables the use of local regional settings when converting numbers to strings.

RegionalDateTimeSettings

Enables the use of local regional settings when converting dates and times to strings.

String Types

Sets the string value types returned by the driver as Default, Ansi or Unicode.

  • Default - the driver defines the string types.
  • Ansi - all string types will be returned as SQL_CHAR, SQL_VARCHAR and SQL_LONGVARCHAR.
  • Unicode - all string types will be returned as SQL_WCHAR, SQL_WVARCHAR and SQL_WLONGVARCHAR.

The option value should be changed if any third-party tool supports only Ansi string types or Unicode ones.

WatchdogInterval

Used to to specify how often the client will check all connections. The default value is 10.

Sample NexusDB ODBC connection string for the Embedded database.

DRIVER={Devart ODBC Driver for NexusDB};Database=D:\NexusDB

Sample NexusDB ODBC connection string for the Remote database.

DRIVER={Devart ODBC Driver for NexusDB};Server=myserver;Port=myport;Database=mydatabase;User ID=myuser;Password=mypassword

© 2015-2022 Devart. All Rights Reserved. Request Support ODBC Forum Provide Feedback