Build the data flow

Learn how you can create an ingest data flow to move data from Kafka to ADLS. This involves opening Apache NiFi in your Flow Management cluster, adding processors and other data flow objects to your canvas, and connecting your data flow elements.

You can use the PutHDFS or PutAzureDataLakeStorage processors to build your ADLS ingest data flows. Regardless of the type of flow you are building, the first steps in building your data flow are generally the same. Open NiFi, add your processors to the canvas, and connect the processors to create the flow.

  1. Open NiFi 
in 
Data Hub.
    1. To access the NiFi service in your Flow Management 
Data Hub cluster, navigate to Management Console service > Data Hub Clusters.
    2. Click the tile representing the Flow Management Data Hub cluster you want to work with.
    3. Click Nifi in the Services section of the cluster overview page to access the NiFi UI.
    You will be logged into NiFi automatically with your CDP credentials.
  2. Add the ConsumeKafkaRecord_2_0 processor for data input in your data flow.
    1. Drag and drop the processor icon into the canvas.
      This displays a dialog that allows you to choose the processor you want to add.
    2. Select the ConsumeKafkaRecord_2_0 processor from the list.
    3. Click Add or double-click the required processor type to add it to the canvas.
  3. Add the MergeRecord processor.

    This processor merges together multiple record-oriented flowfiles into a single flowfile that contains all of the records of the input flowfiles. It works by creating bins and adding flowfiles to these bins until they are full.

    Once a bin is full, all of the flowfiles are combined into a single output flowfile, and that flowfile is routed to the merged relationship.

    When using the ConsumeKafkaRecord_2_0 processor, you are pulling small-sized records, so it is practical to merge them into larger files before writing them to ADLS.

  4. Add a processor for writing data to ADLS.
    OptionDescription
    PutHDFS processor

    The HDFS client writes to ADLS through the Azure Data Lake Storage REST API. This solution leverages centralized CDP security. You can use CDP usernames and passwords for central authentication, and all requests go through IDBroker.

    PutAzureDataLakeStorage processor

    It is an ADLS-specific processor that provides native support for Azure Data Lake Storage Gen 2. This processor is not integrated into CDP’s authentication and authorization frameworks, it uses Azure’s native authentication technology. If you use it for data ingestion, you need to provide the Azure access credentials file / information when configuring the processor. You can do this by providing your storage account name and storage account key.

    1. Drag and drop the processor icon into the canvas.
      This displays a dialog that allows you to choose the processor you want to add.
    2. Select the processor of your choice from the list.
    3. Click Add or double-click the required processor type to add it to the canvas.
  5. Connect the processors to create the data flow by clicking the connection icon in the first processor, and dragging and dropping it on the second processor.

    A Create Connection dialog appears with two tabs: Details and Settings. You can configure the connection's name, flowfile expiration time period, thresholds for back pressure, load balance strategy and prioritization.

    1. Connect ConsumeKafkaRecord_2_0 with MergeRecord.
    2. Add the success flow of the ConsumeKafkaRecord_2_0 processor to the MergeRecord processor.
    3. Click Add to close the dialog box and add the connection to your data flow.
    4. Connect MergeRecord with your target data processor (PutHDFS / PutAzureDataLakeStorage).
    5. Add the merged flow of the MergeRecord processor to the target data processor.
    6. Click Add to close the dialog box and add the connection to your data flow.
  6. Optionally, you can add funnels to your flow.
    1. ConsumeKafkaRecord_2_0: If any of the Kafka messages are pulled but cannot be parsed, the continents of the message will be written to a separate flowfile and that flowfile will be transferred to the parse.failure relationship. You can connect the failure queue coming from the processor to a failure funnel for parse failures.
    2. MergeRecord: For merge failures, you can connect the failure queue coming from the processor to the failure funnel you used for ConsumeKafkaRecord_2_0.
    3. PutHDFS / PutAzureDataLakeStorage: You can add success and failure funnels at the end of the data flow and connect them with your target data processor. These funnels help you see where flow files are being routed when your flow is running.
    If you want to know more about working with funnels, see the Apache NiFi User Guide.
This example data flow has been created using the PutHDFS processor.

If you are using the PutHDFS processor, configure IDBroker mapping authorization.

If you are using the PutAzureDataLakeStorageprocessor, you do not need IDBroker mapping, so proceed to configuring your processors in your data flow.