Dropbox Connector for SSIS : Read CSV file

Integrate SSIS and Dropbox
Integrate SSIS and Dropbox

Learn how to read CSV file using the Dropbox Connector for SSIS. This connector enables you to read and write Dropbox data effortlessly. Integrate, manage, and automate files and folders — almost no coding required. We'll walk you through the exact setup.

Let's dive in!

Video tutorial

Watch this quick video to see the integration in action. It walks you through the end-to-end setup, including:

  • Installing the SSIS PowerPack
  • Configuring a secure connection to Dropbox
  • Working with Dropbox data directly inside SSIS
  • Exploring advanced API Source features
While this video uses the OData Connector as an example, the core concepts and setup process are exactly the same for the Dropbox Connector.

Once you are done watching, simply follow the step-by-step written guide below to configure your data source.

Prerequisites

Before we begin, make sure the following prerequisites are met:

  1. SSIS designer installed. Sometimes it is referred as BIDS or SSDT (download it from Microsoft).
  2. Basic knowledge of SSIS package development using Microsoft SQL Server Integration Services.
  3. SSIS PowerPack is installed (if you are new to SSIS PowerPack, then get started!).

Read CSV file in SSIS

  1. Open Visual Studio and click Create a new project.

  2. Select Integration Services Project. Enter a name and location for your project, then click OK.

  3. From the SSIS Toolbox, drag and drop a Data Flow Task onto the Control Flow surface, and double-click it:

    Drag Data Flow Task onto Control Flow to use SSIS PowerPack Data Flow components
  4. Make sure you are in the Data Flow Task designer:

    Make sure you are in Data Flow designer in SSIS package
  5. From the SSIS toolbox drag and API Source (Predefined Templates) on the data flow designer surface, and double click on it to edit it:

    SSIS API Source (Predefined Templates) - Drag and Drop
  6. Select New Connection to create a new connection:

    API Source - New Connection
  7. Use a preinstalled Dropbox Connector from Popular Connector List or press Search Online radio button to download Dropbox Connector. Once downloaded simply use it in the configuration:

    Dropbox
    Dropbox Connector Selection
  8. Select your authentication scenario below to expand connection configuration steps to:

    • Configure the authentication in Dropbox.
    • Enter those details into the API Connection Manager configuration.
    Dropbox authentication

    To use OAuth authentication, firstly, you need to create OAuth application:

    1. Log into your Dropbox account.
    2. Go to Dropbox My Apps.
    3. Then press Create app button to create a new app: My OAuth apps in Dropbox
    4. Once a new page opens, select Scoped access option: Create OAuth app to get Dropbox REST API data
    5. Next, select Full Dropbox to access all files and folders or App folder to access specific folder's files and folders option.
    6. Continue by giving your app a name.
    7. Then check I agree to Dropbox API Terms and Conditions checkbox.
    8. Click Create app button.
    9. Once a new page opens, click Enable additional teams and Enable additional users buttons: Configure OAuth app in Dropbox
    10. Then copy App key and App secret and copy paste them into your favorite text editor (you will need them later).
    11. Proceed by setting a Redirect URI and clicking Add button.

      NOTE: If you don't have a working Redirect URI, you can use https://zappysys.com/oauth (it's safe).

    12. Then click on Permissions tab and select application scopes: Set OAuth app permissions in Dropbox
    13. Select all Individual Scopes and Team Scopes if you want to manage team data.
    14. Click Submit button.
    15. Now go to SSIS package or ODBC data source and in User Account authentication set these parameters:
      1. For ClientId field use App key value.
      2. For ClientSecret field use App secret value.
      3. For ReturnUrl field use Redirect URI value.
    16. Done! Now you are ready to use Dropbox Connector!
    NOTE: If you are planning to use your current data connection/token for automated processes, we recommend that you use a generic account for token generation when the login box appears (e.g. sales_automation@mycompany.com instead of bob_smith@mycompany.com). When you use a personal account which is tied to a specific employee profile and that employee leaves the company, the token may become invalid and any automated processes using that token will fail. Another potentially unwanted effect of using a personal token is incorrect logging; the API calls (e.g. Read, Edit, Delete, Upload) made with that token will record the specific user as performing the calls instead of an automated process.
    API Connection Manager configuration

    Just perform these simple steps to finish authentication configuration:

    1. Set Authentication Type to User Account [OAuth]
    2. Optional step. Modify API Base URL if needed (in most cases default will work).
    3. Fill in all the required parameters and set optional parameters if needed.
    4. Press Generate Token button to generate the tokens.
    5. Finally, hit OK button:
    Dropbox
    User Account [OAuth]
    https://api.dropboxapi.com/2/
    Required Parameters
    UseCustomApp Fill-in the parameter...
    ReturnUrl Fill-in the parameter...
    Optional Parameters
    ClientId
    ClientSecret
    Scope
    RetryMode RetryWhenStatusCodeMatch
    RetryStatusCodeList 429
    RetryCountMax 5
    RetryMultiplyWaitTime True
    ZappySys OAuth Connection
    Find full details in the Dropbox Connector authentication reference.
  9. Select Read CSV file endpoint from the dropdown and hit Preview Data:

    API Source - Dropbox
    Read and write Dropbox data effortlessly. Integrate, manage, and automate files and folders — almost no coding required.
    Dropbox
    Read CSV file
    Required Parameters
    File path or ID Fill-in the parameter...
    SSIS API Source - Read from table or endpoint
  10. That's it! We are done! Just in a few clicks we configured the call to Dropbox using Dropbox Connector.

    You can load the source data into your desired destination using the Upsert Destination , which supports SQL Server, PostgreSQL, and Amazon Redshift. We also offer other destinations such as CSV , Excel , Azure Table , Salesforce , and more . You can check out our SSIS PowerPack Tasks and components for more options. (*loaded in Trash Destination)

    Execute Package - Reading data from Dropbox and load into target

Conclusion

And there you have it — a complete guide on how to read CSV file in SSIS without writing complex code. All of this was powered by Dropbox 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 Dropbox Connector

Got another use case in mind? We've documented the exact setups for a variety of essential Dropbox operations directly in SSIS, so you can skip the trial and error. Find your next step-by-step guide below:

More Dropbox integrations

All
Data Integration
Database
BI & Reporting
Productivity
Programming Languages
Automation & Scripting
ODBC applications