ODBC Driver for Salesforce Marketing Cloud Connection String Parameters - ODBC Driver for Salesforce Marketing Cloud |
The following table lists the connection string parameters for Salesforce Marketing Cloud.
Parameter | Description | |
---|---|---|
Authentication |
Used to specify the authentication type when connecting to Salesforce Marketing Cloud. The available values are:
The default value - UserandPassword. |
|
Partner IDs |
The list of specific partner accounts or business units for retrieve requests. |
|
User and Password Authentication |
||
Server |
The server address to connect to. Devart ODBC Driver for Salesforce Marketing Cloud can connect to Salesforce Marketing Cloud (formerly known as ExactTarget) CRM servers. The default value is |
|
User ID |
Used to supply a unique User ID to connect to a Salesforce Marketing Cloud account. |
|
Password |
Used to supply a password to login to Salesforce Marketing Cloud. |
|
App Center Client Authentication |
||
Client ID |
Used to supply Application Client ID for App Center Client authentication. |
|
Client Secret |
Used to supply Application center client secret for App Center Client authentication. |
|
Sandbox |
Allows using a production or sandbox account for App Center Client authentication. |
Option | Description |
---|---|
Subdomain |
Used to provide subdomain, which is a 28-character string starting with the letters “mc”, |
App Client Id |
Used to supply application center client ID for server-to-server authentication. |
App Client Secret |
Used to supply application center client secret for server-to-server authentication. |
Proxy Server
The proxy hostname or IP address.
Proxy Port
The proxy port.
Proxy User
The proxy username.
Proxy Password
The proxy password.
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
Connection Timeout
The time (in seconds) to wait for a connection to open before terminating an attempt. The default value is 60.
Extension Objects
ODBC Driver for Salesforce Marketing Cloud allows creating custom objects called Data Extensions. If the parameter is set to true, the data extension information will be read and processed in the same way as the predefined Salesforce Marketing Cloud objects are. Please note that reading data extension information might take additional time.
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:
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.
ReturnForeignKeys
Use the parameter 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.
String Types
Sets the string value types returned by the driver as Default, Ansi or Unicode.
The parameter value should be changed if any third-party tool supports only Ansi string types or Unicode ones.
QueryTimeout
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.
DRIVER={Devart ODBC Driver for Salesforce Marketing Cloud};Authentication=UserandPassword;Server=https://webservice.s7.exacttarget.com/Service.asmx;User ID=00932000000ibZf;Password=****** |
DRIVER={Devart ODBC Driver for Salesforce Marketing Cloud};Authentication=AppCenterClient;AppClientID=8m6chyukyd26sv9858j5hdeq;AppClientSecret=6Jqz8dgxrMJZaPY5zjdfmB7N |
DRIVER={Devart ODBC Driver for Salesforce Marketing Cloud};Authentication=ServerToServer;Subdomain=mc-3930091-23laksnmzx1h1nasz;AppClientID=8m6chyukyd26sv9858j5hdeq;AppClientSecret=6Jqz8dgxrMJZaPY5zjdfmB7N |