macOS DSN ConfigurationCData ODBC Driver for Amazon Marketplace 2019 - Build 19.0.7354
This section shows how to set up ODBC connectivity and configure DSNs on macOS.
Minimum macOS Version
The driver requires macOS Sierra (10.12) or above.
Licensing the Driver
In a terminal, run the following commands to license the driver. To activate a trial, omit the <key> input.
cd "/Applications/CData ODBC Driver for AmazonMarketplace/bin" sudo ./install-license <key>
You'll be prompted for a name and password. These refer to your name and your machine's password.
Connecting through a Driver Manager
On macOS, the CData ODBC Driver for Amazon Marketplace 2019 is preconfigured for use with the iODBC driver manager, as are many other products like Filemaker Pro, Microsoft Excel, and Tableau. You can find the latest version of iODBC on the iODBC site.
The driver installation registers the driver with iODBC and creates a system DSN, which you can use in any tools or applications that support ODBC connectivity.
The driver manager loads the driver and passes function calls from the application to the driver. The driver must be registered with the driver manager and DSNs are defined in the driver manager's configuration files.
To configure a DSN, you can use the iODBC Administrator 64-bit, the GUI installed with iODBC. Note that the ODBC Manager must match the bitness of the ODBC driver. The most recent version of the CData ODBC Driver for Amazon Marketplace 2019 is 64-bit only. Alternatively, you can edit the iODBC configuration files.
You can configure User or System DSNs. User data sources are restricted to a user account. System data sources can be accessed by all users.
Configuring a DSN with the iODBC Administrator
You can create user DSNs by opening the iODBC Administrator 64-bit from Launchpad.
To modify the system DSN installed by the driver or create a system DSN, open the iODBC Administrator 64-bit with elevated permissions. To do so, enter the following command into a terminal:
sudo /Applications/iODBC/iODBC\ Administrator64.app/Contents/MacOS/iODBC\ Administrator64After opening the iODBC Administrator 64-bit, you will see the CData AmazonMarketplace Source listed under the System tab. Select the DSN and click the Configure button to set connection properties as name-value pairs.
To create your own DSN, instead click Add on the User or System tab and then select the CData ODBC Driver for AmazonMarketplace option.
Connecting to Amazon Marketplace
When using the Amazon Marketplace Webservice (MWS) to connect to the Amazon Marketplace , AWSAccessKeyId MWSAuthToken AWSSecretKey SellerId is required.
Configure Access to Amazon Marketplace
To obtain the AWSAccessKeyId MWSAuthToken AWSSecretKey SellerId , follow the steps below:
- Log in to Amazon Seller Central and go to [User Permissions] under [Settings].
- In the [Amazon MWS Developer Permissions] section click [View your credentials] to retrieve their respective values.
Authenticate an Amazon Marketplace Account
Set the following connection properties to connect:
- AWSAccessKeyId: The AWS Access Key Id from the Amazon Marketplace web service settings.
- MWSAuthToken: The MWS Auth Token from the Amazon Marketplace web service settings.
- SellerId: The Seller ID from the Amazon Marketplace web service settings.
- AWSSecretKey: The AWS Secret Key from the Amazon Marketplace web service settings.
- Marketplace: The Amazon Marketplace location (United States, Canada, Japan etc.).
Configuring a DSN in the iODBC INI Files
Configure DSNs in odbc.ini. Register ODBC drivers in odbcinst.ini.
Define ODBC data sources in sections in the odbc.ini file. User data sources can only be accessed by the user account whose home folder the odbc.ini is located in. System data sources can be accessed by all users.
Modifying iODBC's system-wide settings requires elevated permissions; to do so, you can use the sudo command to open a text editor from the terminal. For example:
sudo nano /Library/ODBC/odbc.ini
In addition to the connection properties required to connect to your data source, the Driver property specifies either a driver definition in the odbcinst.ini file or the path to the driver library.
[CData AmazonMarketplace Source] Driver = CData ODBC Driver for AmazonMarketplace AWS Access Key Id=myAWSAccessKeyId AWS Secret Key=myAWSSecretKey MWS Auth Token=myMWSAuthToken Seller Id=mySellerId Marketplace=United States
Additionally, in the ODBC Data Sources section, the DSN must be set to a driver defined in the odbcinst.ini file. For example, below is the entry for the DSN created during the driver install:
[ODBC Data Sources] CData AmazonMarketplace Source = CData ODBC Driver for AmazonMarketplace
You may need to modify the installed driver definition if you change the path to the driver library.
To register an ODBC driver, modify the odbcinst.ini file. With iODBC, drivers can be available to only one user account or drivers can be available system wide.
Drivers are defined in sections in the odbcinst.ini file. The section name specifies the name of the driver. In this section, the Driver property specifies the path to the driver library. The driver library is the .dylib file located in the lib subfolder of the installation directory, by default in /Applications/CData ODBC Driver for AmazonMarketplace.
[CData ODBC Driver for AmazonMarketplace] Driver = /Applications/CData ODBC Driver for AmazonMarketplace/lib/libamazonmarketplaceodbc.dylib
The ODBC Drivers section must also contain a property with the driver name, set to "Installed". For example:
[ODBC Drivers] CData ODBC Driver for AmazonMarketplace = Installed
Testing the Connection
You can use the iODBC Demo, available in most iODBC installations, to connect to Amazon Marketplace and execute SQL queries.
Complete the following steps to connect from the iODBC Demo:
- Open Launchpad and search for "iODBC".
- If you need to connect to Amazon Marketplace from an application that can use only the ANSI ODBC API, click iODBC Demo Ansi. Otherwise, click iODBC Demo Unicode.
- In the Environment menu, click Open Connection.
- Select the DSN on the corresponding tab and test the connection.
Set the Driver Encoding
The ODBC drivers need to specify which encoding to use with the ODBC Driver Manager. By default, the CData ODBC Drivers for Mac are configured to use UTF-32 which is compatible with iODBC, but other Driver Managers may require alternative encoding.
Alternatively, if you are using the ODBC driver from an application that uses the ANSI ODBC API it may be necessary to set the ANSI code page. For example, to import Japanese characters in an ANSI application, you can specify the code page in the config file '/Applications/CData ODBC Driver for AmazonMarketplace/lib/cdata.odbc.amazonmarketplace.ini':
[Driver] AnsiCodePage = 932
Uninstalling the Driver
The easiest way to uninstall the driver is to open a terminal and run the included uninstall.sh script, located in the installation directory. For example:
cd "/Applications/CData ODBC Driver for AmazonMarketplace" sudo ./uninstall.sh
Note: The script needs to be run from the installation directory.