ODBC Driver for Oracle

Connection String Options - ODBC Driver for Oracle

Oracle Connection Options

The following table describes the options that you can include in the connection string for Oracle:

Option Description

Direct

Enables the Direct mode.

Home

Used to select the Oracle client to use with the application.

Host

Used to specify the host of the data source.

Password

Used to specify the password.

Port

Used to specify the port number for the connection. 1521 by default.

Schema

Used to change the current schema of the session to the specified schema.

Server

Used to specify the server name.

Service Name

Used to specify the name of the Oracle Client. The value may be selected from the drop-down list of available clients.

SID

Used to specify the Oracle system identifier of the database instance.

User ID

Used to specify the username.

Advanced Settings

Option Description

AllSchemas

Enables the use of all schemas that an Oracle user has been granted privileges on. The default value is False.

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

Character Set

Used to set the character set that the driver uses to read and write character data.

ConnectMode Used to specify the system privilege for the user who connects to the server. The privilege must be granted to the user before connecting to the server.
Normal
The default value. Connect as a normal user.
SysOper
Connect with the SYSOPER privilege.
SysDBA
Connect with the SYSDBA privilege.
SysASM
Connect with the SYSASM privilege.
SysBkp
Connect with the SysBackup privilege.
SysDG
Connect with the SysDG privilege.
SysKM
Connect with the SYSKM privilege.

Connection Timeout

Used to specify the time in seconds before an attempt to make a connection is considered unsuccessful.

Date Type

  • Default - The default value. The driver maps the Oracle DATE data type to the ODBC data type SQL_TYPE_TIMESTAMP.
  • Date Only - The driver maps the Oracle DATE data type to the ODBC data type SQL_TYPE_DATE.

IPVersion

Used to specify the version of the Internet Protocol. IPv4 and IPv6 are available. The IPv4 + IPv6 value allows to check for available protocol versions and use the first available automatically.

MinFetchRows

Respectively, if the SQL_ATTR_ROW_ARRAY_SIZE attribute value is less than MinFetchRows, then the number of rows queried from the server will equal MinFetchRows. Otherwise - it will be equal to SQL_ATTR_ROW_ARRAY_SIZE.

In order to make the driver to query from the server exactly the same number of rows as specified in the SQL_ATTR_ROW_ARRAY_SIZE attribute, it is enough to set the MinFetchRows parameter to 0. However, in this case, you should take into account, that the SQL_ATTR_ROW_ARRAY_SIZE value is 1 by default, and therefore performance decreases dramatically at this value.

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 using local regional settings when converting numbers to string.

RegionalDateTimeSettings

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

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.

Use Unicode

Used to enable Unicode support.

Sample Oracle ODBC Connection String in Direct Mode

Using Service Name:

DRIVER={Devart ODBC Driver for Oracle};Direct=True;Host=myServer;Service Name=myServiceName;User ID=myUsername;Password=myPassword

Using SID:

DRIVER={Devart ODBC Driver for Oracle};Direct=True;Host=myServer;SID=mySID;User ID=myUsername;Password=myPassword

Sample Oracle ODBC Connection String in OCI Mode

DRIVER={Devart ODBC Driver for Oracle};Data Source=myServer;Home Name=myHomeName;User ID=myUsername;Password=myPassword

See also:

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