Connection String Parameters - ODBC Driver for Microsoft Excel Online

Refresh Token

The refresh token that authorizes the driver to access your account data.

WorkBook

The name of the currently active workbook. You can use only one workbook within one connection.

WorkBook Id

The unique id of the active workbook consisting of the specific string of characters.

Proxy Settings

Proxy Server

The proxy hostname or IP address.

Proxy User ID

The proxy username.

Proxy Password

The proxy password.

Proxy Port

The proxy port.

Advanced Settings

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

ReturnForeignKeys

Use the option to specify whether the driver must return foreign keys. Retrieving metadata about foreign key constraints is a time-consuming operation; many third-party tools request foreign key metadata even whey they do not actually need this information. Note that enabling the option may degrade performance of data access operations. The default value is False.

Header As ColumnName

Specifies whether to use the first row of a spreadsheet to identify the column names. By default, the standard A-Z column names are used.

Use Header to Detect Column Names

Use this parameter to define how to read the first row of a sheet. If there are no column names in the spreadsheet, then standard Excel column names will be displayed (A-Z).

Connection Timeout

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

Query Timeout

The time to wait for a query execution result before terminating and generating an error.

UTC Dates

Specifies whether all the datetime values retrieved from the data source are returned as UTC values or converted to local time and whether the date values specified on the application side (e.g., in SQL statements) are considered UTC or local. The default value is false.

Sheet Tables

Specifies whether tables in a spreadsheet will be treated as separate objects. The possible values are True and False. The default value is False.

Max Cell Length

Specifies the maximum number of characters in a cell. The default value is 4000 characters.

Min Column Count

Sets the minimum column count with data on a sheet. This parameter is in use when Use Header to Detect Column Names is disabled, or when the sheet is lacking headers. The default value is 26 (A-Z range).

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.

ODBC Behavior

• Default - The default value. The ODBC behavior is 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.

String Types

• Default - The driver defines the string types.
• Ansi - All string types are returned as SQL_CHAR, SQL_VARCHAR, and SQL_LONGVARCHAR.
• Unicode - All string types are returned as SQL_WCHAR, SQL_WVARCHAR, and SQL_WLONGVARCHAR.

Set the parameter to Ansi or Unicode, if your third-party tool supports only Ansi or Unicode strings.