All Products
Search
Document Center

Dataphin:Configure DataHub output widgets

Last Updated:Jun 23, 2026

You can configure DataHub output widgets to write data from external databases to DataHub, or copy and push data from connected storage systems for integration and reprocessing.

Prerequisites

Procedure

  1. On the Dataphin home page, select Development > Data Integration from the top menu bar.

  2. On the integration page, select Project from the top menu bar (Dev-Prod pattern requires selecting an environment).

  3. In the navigation pane on the left, click Batch Pipeline. Then, in the Batch Pipeline list, click the Offline Pipeline you want to develop to open its configuration page.

  4. Click Component Library in the upper right corner of the page to open the Component Library panel.

  5. In the Component Library panel's left-side navigation pane, select Output. Find the DataHub widget in the output widget list on the right and drag it to the canvas.

  6. Click and drag the image icon of the target upstream widget to connect it to the DataHub output widget.

  7. On the DataHub output widget, click the image icon to open the DataHub Output Configuration dialog box.image

  8. In the DataHub Output Configuration dialog box, configure the following parameters.

    Parameter

    Description

    Basic settings

    Step Name

    The name of the DataHub output widget. Dataphin automatically generates the step name. You can modify it as needed. The name must meet the following requirements:

    • Can only contain Chinese characters, letters, underscores (_), and numbers.

    • Cannot exceed 64 characters.

    Datasource

    Lists all DataHub-type data sources, including those you have write-through permission for and those you do not. Click the image icon to copy the current data source name.

    Subject

    Select the topic based on your scenario.

    Data Volume Per Submission

    Data Integration accumulates data in a buffer to improve write efficiency. When the buffered data reaches the specified volume per submission (in MB), it is submitted in batches to the destination. Default value: 1 MB.

    Advanced Configuration

    Configure as needed. The following parameters are supported:

    • maxRetryCount: Maximum number of retries for a failed node. The retry count cannot exceed 3.

    • batchSize: Data Integration accumulates data in a buffer to improve write efficiency. When the number of buffered records reaches the batchSize value, the records are submitted in batches to the destination.

    • maxCommitInterval: Maximum buffering time. Unit: milliseconds. Default value: 30,000 (30 seconds). If the data source does not produce data for an extended period, set this parameter to ensure timely data delivery. Data is force-delivered when this interval is exceeded.

    Note

    Data is delivered when any one of the three parameters (data volume per submission, batchSize, or maxCommitInterval) is met. DataHub limits each write request to 10,000 records. Exceeding this limit causes the node to fail. We recommend that you set batchSize to 10,000 or fewer.

    Field mapping

    Input Fields

    The input fields are displayed based on the output of the upstream widget.

    Output Fields

    Displays all fields of the selected table. To exclude fields from the downstream widget, delete them:

    • To delete a small number of fields, click the Actions column's sgaga icon to delete the extra fields.

    • To delete many fields, click Field Management, select multiple fields on the Field Management page, and click the sfsga icon to move the Selected Input Fields to Unselected Input Fields. gagag

    Mapping

    Maps input fields from the source table to output fields of the target table. Two mapping modes are available:

    • Same-name mapping: Maps fields with the same field name.

    • Same-row mapping: Maps fields in the same row position when field names differ between the source and target tables.

  9. Click OK.