VOOZH about

URL: https://www.cdata.com/kb/tech/csv-jdbc-snaplogic.rst

⇱ Integrate CSV with External Services using SnapLogic


Integrate CSV with External Services using SnapLogic

πŸ‘ Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Use CData JDBC drivers in SnapLogic to integrate CSV with External Services.

SnapLogic is an integration platform-as-a-service (iPaaS) that allows users to create data integration flows with no code. When paired with the CData JDBC Drivers, users get access to live data from more than 250+ SaaS, Big Data and NoSQL sources, including CSV, in their SnapLogic workflows.

With built-in optimized data processing, the CData JDBC Driver offers unmatched performance for interacting with live CSV data. When platforms issue complex SQL queries to CSV, the driver pushes supported SQL operations, like filters and aggregations, directly to CSV and utilizes the embedded SQL engine to process unsupported operations client-side (often SQL functions and JOIN operations). Its built-in dynamic metadata querying lets you work with CSV data using native data types.

Connect to CSV in SnapLogic

To connect to CSV data in SnapLogic, download and install the CData CSV JDBC Driver. Follow the installation dialog. When the installation is complete, the JAR file can be found in the installation directory (C:/Program Files/CData/CData JDBC Driver for CSV/lib by default).

Upload the CSV JDBC Driver

After installation, upload the JDBC JAR file to a location in SnapLogic (for example, projects/Jerod Johnson) from the Manager tab.

πŸ‘ Uploaded JDBC Driver (Salesforce & QuickBooks Online are shown)

Configure the Connection

Once the JDBC Driver is uploaded, we can create the connection to CSV.

  1. Navigate to the Designer tab
  2. Expand "JDBC" from Snaps and drag a "Generic JDBC - Select" snap onto the designer πŸ‘ Adding a Generic JDBC snap onto the designer
  3. Click Add Account (or select an existing one) and click "Continue"
  4. In the next form, configure the JDBC connection properties:
    • Under JDBC JARs, add the JAR file we previously uploaded
    • Set JDBC Driver Class to cdata.jdbc.csv.CSVDriver
    • Set JDBC URL to a JDBC connection string for the CSV JDBC Driver, for example:

      jdbc:csv:URI=/PATH/TO/MyCSVFilesFolder;RTK=XXXXXX;

      NOTE: RTK is a trial or full key. Contact our Support team for more information. πŸ‘ Configuring a connection (Salesforce is shown)

      Built-In Connection String Designer

      For assistance in constructing the JDBC URL, use the connection string designer built into the CSV JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

      java -jar cdata.jdbc.csv.jar

      Fill in the connection properties and copy the connection string to the clipboard.

      Connecting to Local or Cloud-Stored (Box, Google Drive, Amazon S3, SharePoint) CSV Files

      CData Drivers let you work with CSV files stored locally and stored in cloud storage services like Box, Amazon S3, Google Drive, or SharePoint, right where they are.

      Setting connection properties for local files

      Set the URI property to local folder path.

      Setting connection properties for files stored in Amazon S3

      To connect to CSV file(s) within Amazon S3, set the URI property to the URI of the Bucket and Folder where the intended CSV files exist. In addition, at least set these properties:

      • AWSAccessKey: AWS Access Key (username)
      • AWSSecretKey: AWS Secret Key

      Setting connection properties for files stored in Box

      To connect to CSV file(s) within Box, set the URI property to the URI of the folder that includes the intended CSV file(s). Use the OAuth authentication method to connect to Box.

      Dropbox

      To connect to CSV file(s) within Dropbox, set the URI proprerty to the URI of the folder that includes the intended CSV file(s). Use the OAuth authentication method to connect to Dropbox. Either User Account or Service Account can be used to authenticate.

      SharePoint Online (SOAP)

      To connect to CSV file(s) within SharePoint with SOAP Schema, set the URI proprerty to the URI of the document library that includes the intended CSV file. Set User, Password, and StorageBaseURL.

      SharePoint Online REST

      To connect to CSV file(s) within SharePoint with REST Schema, set the URI proprerty to the URI of the document library that includes the intended CSV file. StorageBaseURL is optional. If not set, the driver will use the root drive. OAuth is used to authenticate.

      Google Drive

      To connect to CSV file(s) within Google Drive, set the URI property to the URI of the folder that includes the intended CSV file(s). Use the OAuth authentication method to connect and set InitiateOAuth to GETANDREFRESH.

      πŸ‘ Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)
  5. After entering the connection properties, click "Validate" and "Apply"

Read CSV Data

In the form that opens after validating and applying the connection, configure your query.

  • Set Schema name to "CSV"
  • Set Table name to a table for CSV using the schema name, for example: "CSV"."Customer" (use the drop-down to see the full list of available tables)
  • Add Output fields for each item you wish to work with from the table
πŸ‘ Configuring a Select snap (Salesforce is shown)

Save the Generic JDBC - Select snap.

With connection and query configured, click the end of the snap to preview the data (highlighted below).

πŸ‘ Click the end of the snap to preview the data.

Once you confirm the results are what you expect, you can add additional snaps to funnel your CSV data to another endpoint.

πŸ‘ Previewing data (Salesforce is shown).

Piping CSV Data to External Services

For this article, we will load data in a Google Spreadsheet. You can use any of the supported snaps, or even use a Generic JDBC snap with another CData JDBC Driver, to move data into an external service.

  1. Start by dropping a "Worksheet Writer" snap onto the end of the "Generic JDBC - Select" snap.
  2. Add an account to connect to Google Sheets πŸ‘ Connecting to Google
  3. Configure the Worksheet Writer snap to write your CSV data to a Google Spreadsheet πŸ‘ Writing to a Google Spreadsheet

You can now execute the fully configured pipeline to extract data from CSV and push it into a Google Spreadsheet.

πŸ‘ Data written to Google Spreadsheets (Salesforce is shown)

More Information & Free Trial

Using the CData JDBC Driver for CSV you can create a pipeline in SnapLogic for integrating CSV data with external services. For more information about connecting to CSV, check at our CData JDBC Driver for CSV page. Download a free, 30 day trial of the CData JDBC Driver for CSV and get started today.