ODBC Driver for Smartsheet

Connection String Parameters - ODBC Driver for Smartsheet


ODBC Driver for Smartsheet ODBC Connection String Parameters

The following table lists the connection string parameters for ODBC Driver for Smartsheet.

Parameter Description

Refresh Token

The refresh token that authorizes the driver to access your ODBC Driver for Smartsheet data.

Region

 Specifies the reqion, where the datacenter is located. Possible parameter values are as follows:
  • US - The datacenter is located in North America (www.smartsheet.com).
  • Europe - The datacenter is located in Europe (www.smartsheet.eu).
The default value is US.

Proxy Settings

Proxy Server

The proxy hostname or IP address.

Port

The proxy port.

Proxy User ID

The proxy username.

Proxy Password

The proxy password.

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

Return Foreign Keys

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.

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.

Suppress Extended Requests

Select this option to reduce the number of API calls. Otherwise, additional extended API requests will be performed to query values of lacking fields.

Typed Sheet Cells

This parameter is enabled by default. In this case it determines that the actual data types are assigned for the fields. If disabled, data types will be assigned to the fields regardless of the type.

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.

Regional Number Settings

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

Regional Dates and Times

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

ODBC Behavior

 Sets the behavior corresponding to the ODBC specification version expected by a third-party tool. The behavior of the ODBC driver can be changed by calling the SQLSetEnvAttr function to set the SQL_ATTR_ODBC_VERSION environment attribute. Some third-party tools expect the driver to exhibit ODBC 2.x behavior, but forget to call SQLSetEnvAttr with the required version, or pass an incorrect value. In this case, the behavior can be explicitly set in the Connection String by setting the ODBC Behavior parameter.
  • Default - The ODBC behavior is determined by a third-party tool. This is a default value.
  • Ver 2.x - ODBC 2.x behavior is explicitly set.
  • Ver 3.x - ODBC 3.x behavior is explicitly set.

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 parameter value should be changed if any third-party tool supports only Ansi string types or Unicode ones.

ODBC Driver for Smartsheet Connection String sample

DRIVER=Devart ODBC Driver for ODBC Driver for Smartsheet;Refresh Token=myrefreshtoken

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