Ingest Salesforce Data Incrementally into Hive Using Apache Nifi

Introduction

Apache Nifi is an open source project that was built for data flow automation and management between different systems. Some of the key features of Nifi, in addition to data flow, are ease of use with a drag and drop UI, easily scalable to run a single server or in a clustered mode across many servers. Interesting trivia about Apache Nifi is that it has its roots in NSA and was donated to Apache Software Foundation in late 2014. 

To get you started with Apache Nifi, we will walk you through how to ingest Salesforce data into Hive tables with the help of Progress DataDirect JDBC drivers

Prerequisites

This tutorial assumes that you have Apache Nifi and a DataDirect JDBC driver. If you do not have those items, please follow these quick steps:

Download Apache Nifi
  1. Download Apache Nifi from here.
  2. Extract the contents from the package to your desired location.

Install Progress DataDirect Salesforce JDBC driver
  1. Download DataDirect Salesforce JDBC driver from here.
  2. To install the driver, execute the .jar package by running the following command in terminal or just by double clicking on the jar package.

  3. java -jar PROGRESS_DATADIRECT_JDBC_SF_ALL.jar

  4. This will launch an interactive java installer to install the Salesforce JDBC driver to your desired location as either a licensed or evaluation installation.
  5. Note that this will install Salesforce JDBC driver and other drivers for your trial purposes in the same folder.


Add Drivers to the Nifi Classpath

  1. Go to the install location of Progress DataDirect drivers, which is usually at

  2. /home/<user>/Progress/DataDirect/Connect_for_JDBC_51

  3. Copy the Salesforce JDBC driver (sforce.jar) and Hive JDBC driver (hive.jar) from the lib folder in the above location to
    /path/to/nifi/lib
    folder.
  4. If you have already started Nifi atthis point, you will have to restart it to be able to use the drivers from Nifi.

Set up the Salesforce JDBC driver for the Nifi Flow

  1. Run the Nifi if you haven’t started it yet. You can do this by running
    bin/nifi.sh
    run command on your terminal. Note that your pwd must be the root directory of nifi, when you run this command.
  2. Open your browser and go to
    to access the Nifi UI, where you can create the flow. You should be seeing a canvas as shown below when the page loads.
  3. Nifi_setup_1

  4. To start with building the flow, let’s start with configuring the JDBC drivers first. On your canvas, there are two side bars, one says Navigate and another says Operate. Under the Operate open the settings for the process group named Nifi Flow as shown below.
  5. Nifi_setup_2

  6. You should now see a pop with two tabs named General and Controller Services. Go to Controller Services tab and click on + button to add a new controller service.
  7. Nifi_setup_3

  8. You should now see a new popup displaying various Controller services you can choose from. Choose DBCPConnectionPool as your controller service and click on Add button as shown below.
  9. Nifi_setup_4

  10. Click on Edit button of the newly created controller service and you should now see a screen as shown below
  11. Nifi_setup_5

  12. Fill in the details to connect to Salesforce as below.
  13. Nifi_driver

  14. Go to Settings tab and rename the controller service if you want to. I changed mine to SalesforceConnect and click on Apply button to save the settings.
  15. Now it’s time to enable this controller service. On the Controller Service, you should find an Enable button between edit and delete as shown below. Click on it to enable the service.
  16. Nifi_setup_6

Set up the Hive JDBC driver for the Nifi Flow

Create another controller service for configuring the Hive connection. Repeat steps 4 through 9 above, except in step 7 substitute the details for the Hive driver, as follows:
nifi_driver2
Once you have both the Salesforce and Hive drivers configured, this is how the controllers will look after they have been enabled:
Nifi_setup_7

Close the Nifi Flow Configuration pop up and you should now be back on canvas. Let’s build the flow now that we have everything in place.

Build the Nifi Flow

  1. To build the Nifi Flow, first we would have to read the data from Salesforce and it can be done using a processor called QueryDatabaseTable which supports incremental pulling of the data.
  2. Now drag a processor on to canvas and choose QueryDatabaseTable and Add it on to canvas as shown below.
  3. Nifi_setup_8

  4. Right click on the QueryDatabaseTable processor and choose to Configure. Go to the tab Scheduling and choose the what kind of Scheduling strategy you would like to have and set the schedule when this flow should run.
  5. Go to Properties tab and under it configure it as follows

  6. Database Connection Pooling Service
    Choose the controller service where you configured Salesforce Connection in previous steps. In my case, I chose the controller SalesforceConnect where I configured the connection to Salesforce using the Progress DataDirect JDBC driver.


    Table Name
    Choose the table that you would like to ingest incrementally. I choose to sync the table opportunity



    Below is a screenshot of final settings for your reference
    Nifi_setup_9


  7. Click on Apply to save the processor configuration.
  8. Drag another processor from the menu and choose SplitAvro as your processor from the list. This will split the avro binary output that comes out of the QueryDatabaseTable processor, if it’s too big.
  9. Connect the processor QueryDatabaseTable to SplitAvro. As soon as you connect both the processors you will see a configuration pop up for that connection show up. There is no configuration needed here, just click on Add.
  10. You should now have a flow as shown below. Notice that QueryDatabaseTable processor no longer has the warning, which means it is properly configured. There are still warning signs on SplitAvro because we didn’t yet configure it.

  11. Nifi_setup_10


  12. Right click on the SplitAvro processor and choose Configure. On the settings tab, choose to automatically terminate the relationships for failure in processor and for the original as we don’t need the original avro binary output as shown below. We will be using the only split relationship to go ahead.
  13. Nifi_setup_11

  14. These are the only settings that you need to take care of here. You can control how many records each split data file can contain from the properties tab, but I wouldn’t be going in to those today as I will be using default values for this tutorial. You can click on Apply and it will save the configuration for SplitAvro.
  15. Drag another processor from menu and choose ConvertAvrotoJSON to be your processor. This processor will convert all the avro records to JSON format.
  16. Connect SplitAvro and ConvertAvrotoJSON processors and you should now see configuration for connection between these two processors. Under for relationships, as we only need the split, choose it and click on Add as shown below.
  17. Nifi_setup_12


  18. Notice that all the warnings for the processor are cleared. You should now see warnings only for the ConvertAvrotoJSON processor
  19. Right click ConvertAvrotoJSON processor and choose configure.
  20. Under settings tab, choose to automatically terminate relationships for failure as shown below. Click on Apply to save configuration.
  21. Nifi_setup_13


  22. Drag another processor from the menu and choose ConvertJSONtoSQL processor. This processor will help in creating Insert statements for the destination table.
  23. Connect ConvertAvrotoJSON and ConvertJSONtoSQL processor and you should see a popup for connection configuration. Enable the connection for the relationship success and click on Add as shown below.
  24. Nifi_setup_14


  25. Notice that all the warnings for the processor ConvertAvrotoJSON are cleared. You should now see warnings only for the ConvertJSONtoSQL processor.

Configure the ConvertJSONtoSQL Processor

  1. Before going ahead, if you don’t have an opportunity table with the same schema as Salesforce, you would have to create it first. I have tried to find if there was an automated way of achieving this, but I couldn’t find any. If you find a way to do this let me know in comments.
  2. Right click on ConvertJSONtoSQL and choose to configure. On the Settings tab, choose to automatically terminate relationships on failure and original as shown below.
  3. Nifi_setup_15

     

  4. Go to properties tab and fill in the details as following.

  5. JDBC Connection Pool
    Choose the controller service where you configured Hive Connection in previous steps. In my case, I chose the controller HiveConnect where I configured the connection to Hive using the Progress DataDirect JDBC driver.

    Statement Type
    Insert

    Table name
    The table where you want to insert the data in Hive.

    Nifi_setup_16

     

  6. The last processor that we need is the PutSQL processor that puts the Insert statements created in the processor ConvertJSONtoSQL. Connect the ConvertJSONtoSQL processor to PutSQL processor.
  7. You now see the pop up for the connection configuration and configure it as shown below and click on Add.

  8. Nifi_setup_17

  9. Right click on PutSQL processor and click on configure. Under the settings, automatically terminate relationships for failure, retry and success.
  10. Nifi_setup_18

     

  11. Under properties tab, configure the connection to Hive as follows. Here I am using the controller service that I have created for Hive in previous steps.

  12. Nifi_setup_19

  13. Click on Apply to save the configuration. Your flow should be looking like as below and you should see no warnings for any of the processor.

  14. Nifi_setup_20

Run the Flow

  1. To start the flow, starting with the QueryDatabasetable, right click every processor and start them. Once the processors are started you can see the data flow from Salesforce to Hive. Once the PutSQL processor has completed the process, you should now be able to find the data in your Hive instance.
  2. If you have scheduled the QueryDatabasetable to run after X seconds, after X seconds, the flow will fetch incremental data pull from Salesforce and ingest it in to Hive automatically.

We hope this tutorial has helped you to get started with Apache Nifi. Note that you can use similar flows to ingest your Eloqua, Google Analytics, Sugar CRM, SQL Server, Oracle data to Hive instance using Progress DataDirect JDBC drivers. Feel free to try the JDBC drivers for your use cases and you can evaluate the drivers for 15 days.

JDBC TUTORIAL

Ingest Salesforce Data Incrementally into Hive Using Apache Nifi

DataDirect
ODBC connectors

Real-Time Access to XML Data

DataDirect
ODBC Tutorials

Discussions, tips and tricks for
DataDirect Connect drivers