Amazon MWS Connector for Azure Data Factory (SSIS) : Make generic REST API request (bulk write)
Learn how to make generic REST API request (bulk write) using the Amazon MWS Connector for Azure Data Factory (SSIS). This connector enables you to read and write Amazon MWS data effortlessly. Integrate, manage, and automate listings, orders, payments, and reports — almost no coding required. We'll walk you through the exact setup.
Let's dive in!
Prerequisites
Before we begin, make sure the following prerequisites are met:
- SSIS designer installed. Sometimes it is referred as BIDS or SSDT (download it from Microsoft).
- Basic knowledge of SSIS package development using Microsoft SQL Server Integration Services.
- SSIS PowerPack is installed (if you are new to SSIS PowerPack, then get started!).
Make generic REST API request in SSIS
-
Begin with opening Visual Studio and Create a New Project.
-
Select Integration Service Project and in new project window set the appropriate name and location for project. And click OK.
In the new SSIS project screen you will find the following:
- SSIS ToolBox on left side bar
- Solution Explorer and Property Window on right bar
- Control flow, data flow, event Handlers, Package Explorer in tab windows
- Connection Manager Window in the bottom
Note: If you don't see ZappySys SSIS PowerPack Task or Components in SSIS Toolbox, please refer to this help link. -
Now, Drag and Drop SSIS Data Flow Task from SSIS Toolbox. Double click on the Data Flow Task to see Data Flow designer.
-
Read the data from the source, using any desired source component. You can even make an API call using the ZappySys JSON/XML/API Source and read data from there. In this example, we will use an OLE DB Source component to read real-time data from a SQL Server database.
-
From the SSIS Toolbox drag and drop API Destination (Predefined Templates) on the Data Flow Designer surface and connect source component with it, and double click to edit it.
-
Select New Connection to create a new connection:
API Destination - Amazon MWSRead and write Amazon MWS data effortlessly. Integrate, manage, and automate listings, orders, payments, and reports — almost no coding required.
-
To configure the Amazon MWS connector, choose one of the following methods:
- Choose from Popular Connector List: Select a pre-installed service directly from the dropdown menu.
- Search Online: Use this to find and download a new connector file to your computer.
- Use Saved/Downloaded File: Once the file is downloaded, browse your local drive to load it into the configuration.
After that, just click Continue >>:
Amazon MWS
-
Proceed with selecting the desired Authentication Type. Then select API Base URL (in most cases default one is the right one). Finally, fill in all the required parameters and set optional parameters if needed. You may press a link Steps to Configure which will help set certain parameters. More info is available in Authentication section.
Amazon MWS authentication
Please refer to external API reference
API Connection Manager configuration
Just perform these simple steps to finish authentication configuration:
-
Set Authentication Type to
OAuth [OAuth] - Optional step. Modify API Base URL if needed (in most cases default will work).
- Fill in all the required parameters and set optional parameters if needed.
- Press Generate Token button to generate the tokens.
- Finally, hit OK button:
Amazon MWSOAuth [OAuth]https://mws.amazonservices.comRequired Parameters AWSAccessKeyId Fill-in the parameter... Secret Key Fill-in the parameter... SellerId Fill-in the parameter...
-
Set Authentication Type to
-
Select Generic Table (Bulk Read or Write) table from the dropdown, then select Insert, Update as operation, and hit Preview Data:
API Destination - Amazon MWSRead and write Amazon MWS data effortlessly. Integrate, manage, and automate listings, orders, payments, and reports — almost no coding required.Amazon MWSGeneric Table (Bulk Read or Write)Insert, UpdateRequired Parameters Url Fill-in the parameter... Request Method Fill-in the parameter... Optional Parameters IsMultiPart Filter Request Format (Content-Type) Default Body {$rows$} JsonOutputFormat Multicontent DoNotOutputNullProperty Batch Size (Default=1) 1 Meta Detection Order StaticDynamicVirtual Input Columns - For Mapping (e.g. MyCol1:string(10); MyCol2:int32 ...) - Use bool, int32, int64, datetime, decimal, double Output Columns (e.g. MyCol1:string(10); MyCol2:int32 ...) - Use bool, int32, int64, datetime, decimal, double Request Format Response Format Default Headers Accept: */* || Cache-Control: no-cache Csv - Column Delimiter , Csv - Row Delimiter {NEWLINE} Csv - Quote Around Value True Csv - Always Quote regardless type Encoding CharacterSet Writer DateTime Format Csv - Has Header Row True Xml - ElementsToTreatAsArray Layout Map <?xml version="1.0" encoding="utf-8"?> <!-- Example#1: Output all columns --> <settings> <dataset id="root" main="True" readfrominput="True" /> <map src="*" /> </settings> <!-- Example#2: Records under array <?xml version="1.0" encoding="utf-8"?> <settings singledataset="True"> <dataset id="root" main="True" readfrominput="True" /> <map name="MyArray" dataset="root" maptype="DocArray"> <map src="OrderID" name="OrderID" /> <map src="OrderDate" name="OrderDate" /> </map> </settings> --> <!-- Example#3: Records under nested section <?xml version="1.0" encoding="utf-8"?> <settings> <dataset id="dsRoot" main="True" readfrominput="True" /> <map name="NestedSection"> <map src="OrderID" name="OrderID_MyLabel" /> <map src="OrderDate" name="OrderDate_MyLabel" /> </map> </settings> -->
-
Finally, map the desired columns:
API Destination - Amazon MWSRead and write Amazon MWS data effortlessly. Integrate, manage, and automate listings, orders, payments, and reports — almost no coding required.
-
That's it; we successfully configured the POST API Call. In a few clicks we configured the Amazon MWS API call using ZappySys Amazon MWS Connector
Deploy SSIS package to Azure Data Factory (ADF)
Once your SSIS package is complete,
deploy it to the
Azure-SSIS runtime
within Azure Data Factory.
The setup process requires you
to upload the
SSIS PowerPack
installer to Azure Blob Storage
and then customize the runtime configuration using the main.cmd file.
For a complete walkthrough of these steps,
see our detailed guide on the
Azure Data Factory (SSIS) and Amazon MWS integration.
Conclusion
And there you have it — a complete guide on how to make generic REST API request (bulk write) in Azure Data Factory (SSIS) without writing complex code. All of this was powered by Amazon MWS Connector, which handled the REST API pagination and authentication for us automatically.
Download the trial now or ping us via chat if you have any questions or are looking for a specific feature (you can also reach out to us by submitting a ticket):
More actions supported by Amazon MWS Connector
Got another use case in mind? We've documented the exact setups for a variety of essential Amazon MWS operations directly in Azure Data Factory (SSIS), so you can skip the trial and error. Find your next step-by-step guide below:
- Get CSV Report By ID - Cached Copy (Previously Generated)
- Get FlatFile Report (Live)
- Get Report Count
- Get Report List (Successful Only)
- Get Report Requests
- Get XML Report (Live)
- Get XML Report By ID - Cached Copy (Previously Generated)
- Orders: Get Single Order Information
- Orders: Read Order Items
- Orders: Read Orders
- Make Generic REST API Request