Using a Connection String
For some applications, you might need to use a connection string to connect to your data source. For detailed information about how to use a connection string in an ODBC application, refer to the documentation for the application that you are using.
The connection strings in the following sections are examples showing the minimum set of connection attributes that you must specify to successfully connect to the data source. Depending on the configuration of the data source and the type of connection you are working with, you might need to specify additional connection attributes. For detailed information about all the attributes that you can use in the connection string, see Connector Configuration Options.
Note:
If the server does not support HTTPS connections or SSL verification, then you must disable those features by setting additional properties in your connection string. For more information, see Configuring SSL Verification.
DSN Connection String Example
The following is an example of a connection string for a connection that uses a DSN:
DSN=[DataSourceName]
[DataSourceName] is the DSN that you are using for the connection.
You can set additional configuration options by appending key-value pairs to the connection string. Configuration options that are passed in using a connection string take precedence over configuration options that are set in the DSN.
DSN-less Connection String Examples
Some applications provide support for connecting to a data source using a connector without a DSN. To connect to a data source without using a DSN, use a connection string instead.
The placeholders in the examples are defined as follows, in alphabetical order:
- [Endpoint] is the endpoint of the Shopify server that you are connecting to.
- [RedirectURL] is the redirect URL associated with your Shopify application.
- [YourAccessToken] is your access token for authenticating to Shopify. For a list of the scopes that the connector supports, see https://help.shopify.com/en/api/getting-started/authentication/oauth/scopes.
- [YourOAuthID] is the API key associated with your Shopify application, which is used as the OAuth 2.0 client ID.
- [YourOAuthScope] is a comma-separated list of OAuth scopes for the access token.
- [YourOAuthSecret] is the credential set associated with your Shopify application, which is used as the OAuth 2.0 client secret.
- [YourPath] is the full path of the
.pem
file containing trusted CA certificates for verifying the server during SSL authentication.
Connecting to Shopify Using an Access Token
You can connect to the data source using an access token through either SQLBrowseConnect or SQLDriverConnect. The following is the format of a DSN-less connection string for connecting to Shopify using an access token:
Driver=Simba Shopify ODBC Driver;Host=[Endpoint];
Auth_Type=Access Token;Auth_AccessToken=[YourAccessToken];
For example:
Driver=Simba Shopify ODBC Driver;
Host=simbastore.myshopify.com;
Auth_Type=Access Token;Auth_AccessToken=1jt9Pcyq8pr3lvu143pfl4r86;
Connecting to Shopify Using Your Shopify Credentials
You can connect to the data source using your Shopify application information through SQLBrowseConnect only. The connector initiates an OAuth 2.0 authentication flow based on your credentials, and then uses the retrieved access token to authenticate the connection. The following is the format of a DSN-less connection string for connecting to Shopify using your Shopify application information:
Driver=Simba Shopify ODBC Driver;Host=[Endpoint];
Auth_Type=OAuth_2.0;Auth_BaseRedirectUri=[RedirectURL];
Auth_Client_ID=[YourOAuthID];Auth_Client_Secret=[YourOAuthSecret];Auth_Scope=[YourOAuthScope];
For example:
Driver=Simba Shopify ODBC Driver;
Host=simbastore.myshopify.com;
Auth_Type=OAuth_2.0;
Auth_BaseRedirectUri=http://localhost:2500/;
Auth_Client_ID=f145kn9Pcyq9pr4lvumdapfl4rive;
Auth_Client_Secret=45kn9Pcyq9pr4lvu123pfl4r57;
Auth_Scope=read_content,write_content;
Connecting to Shopify Using Windows Trust Store
The following is the format of a DSN-less connection string for connecting to the Shopify server that requires SSL and uses the Windows trust store:
Driver=Simba Shopify ODBC Driver;Host=[Endpoint];Auth_Type=Access Token;Auth_AccessToken=[YourAccessToken];SystemTrustStore=1;
For example:
Driver=Simba Shopify ODBC Driver;Host=simbastore.myshopify.com;Auth_Type=OAuth_2.0;Auth_AccessToken=
kN9PcyQ9prK4LvL4R+lVE=;SystemTrustStore=1;
The following is the format of a DSN-less connection string for connecting to the Shopify server that requires SSL and uses the path provided in the TrustCertsPath
property:
Driver=Simba Shopify ODBC Driver;Host=[Endpoint];Auth_Type=Access Token;Auth_AccessToken=[YourAccessToken];SystemTrustStore=0;TrustCertsPath=[YourPath];
For example:
Driver=Simba Shopify ODBC Driver;Host=simbastore.myshopify.com;Auth_Type=OAuth_2.0;Auth_AccessToken=
kN9PcyQ9prK4LvL4R+lVE=;SystemTrustStore=0;TrustCertsPath=C:\Users\JSmith\Desktop\Cert\Shopify.pem;
- Creating a Data Source Name
- Configuring the Driver
- Connector Configuration Options