¶ Description
Distribute evenly the rows between all output pins.
¶ Parameters
¶ Parameters tab
Parameters:
- columns to forward
¶ Description tab
Parameters:
- Script name
- Short description
- Revision
- Description
¶ Configuration tab
See dedicated page for more information.
¶ About
The distribute action evenly distributes input rows between multiple output pins in a round-robin fashion. It is useful in scenarios where you want to balance processing across parallel workflows or load-balance data for subsequent operations.
This action ensures that the specified columns from each incoming row are forwarded appropriately and consistently across the defined number of output branches. This is particularly valuable when splitting data to apply different transformation logic in parallel pipelines or to optimize performance by distributing workload.
Note: Only the selected columns in
columns to forwardwill be forwarded to each output pin.
¶ Configuration
| Field | Description | Example Setting |
|---|---|---|
| Outputs number | The number of output pins to distribute rows to | 4 |
| Convert float to key | Behavior when the float used as a key is invalid | abort / lower integer |
| Convert string to float | Behavior if a string cannot be converted to a float | abort / set default |
| Convert 'String/?' to key | Error-handling when converting a string to a key index | see individual options |
¶ Input Example
InlineTable:
The columns to forward parameter is set to: ID, Name, Value.
¶ Output Example
¶ Use Cases
- Load balancing: Spread data equally across several downstream nodes to optimize resource usage.
- Parallel processing: Apply different operations in parallel on portions of a dataset.
- Stress testing: Use the distribute operator to simulate real-world load distribution in test scenarios.
¶ Tips and Notes
- Make sure the number of outputs matches your intended pipeline design.
- You can dynamically increase or decrease the number of outputs using the configuration panel.
- If input data is not evenly divisible by the number of outputs, some outputs may contain one more or one fewer row.
- If no columns are selected in
columns to forward, the action will not forward any data.
