Tutorial | Flow zones¶
Let’s organize a Flow and make it more navigable. Using Flow zones to break up the Flow allows you to view it at a higher level of abstraction and quickly grasp its overall purpose.
In this tutorial, you will:
Move Flow items into new Flow zones.
Manage the display of Flow zones.
Delete Flow zones and undo that change.
To reproduce the steps in this tutorial, you’ll need:
Access to an instance of Dataiku 12+.
Basic knowledge of Dataiku (Core Designer level or equivalent).
Create the project¶
From the Dataiku Design homepage, click + New Project > DSS tutorials > Advanced Designer > Flow zones.
From the project homepage, click Go to Flow.
You can also download the starter project from this website and import it as a zip file.
You’ll next want to build the Flow.
Click Flow Actions at the bottom right of the Flow.
Click Build all.
Keep the default settings and click Build.
Looking at the Flow, you can abstract its purpose to two steps: data ingestion and data preparation. We can use this grouping to build our Flow zones.
Select these datasets:
In the Actions tab, under Flow Zones, select Move (or right-click on the selection and select Move to a flow zone).
Name the zone
Data preparationand review which recipes will be moved as well.
Here, we moved items to a new Flow zone. You also have the option in this step to move items to existing Flow zones if present.
Select the Default Flow zone and click Edit in the right panel.
Rename the Flow zone
Data ingestionand Confirm.
Let’s look at the Flow zone view.
From the View menu in the lower left, select Flow Zones. In this view, Flow items are colored according to their Flow zone.
Click on Hide Zones. Items are still color-coded according to their Flow zone, but the zone boundaries no longer appear.
Exit the Flow zone view to prepare for next steps.
Let’s hide the content of the Data ingestion Flow zone. This could be useful if you were only focused on making changes to the Data preparation items.
If collapsing a zone isn’t enough, you can:
Double-click on the Data preparation Flow zone to only see this zone on the screen.
Implement Flow Folding as described in the reference documentation.
What happens to Flow items when you delete a Flow zone? We’ll delete our Data preparation zone and see.
Select the Data preparation Flow zone.
In the right panel, click Delete and Confirm.
You’ll see that both Flow zones disappear. This is because items in the deleted Flow zone move to the Default Flow zone (which we have renamed to Data ingestion). However, you cannot only have one Flow zone in the Flow. Thus, both zones were removed.
If we had tried to delete the Data ingestion Flow zone, we would have seen that it was not possible. This is because the “Default” Flow zone cannot be deleted.
Imagine you had deleted the Flow zones by accident. Do you know how to undo this change? Let’s practice.
From the More options menu in the top navigation bar, click Version Control.
Click on the change you made before deleting the Flow zone. (Assuming you made no other changes, this will be the second item in the list from the top.)
Select Revert To This Revision and Confirm to undo any changes you made after this commit.
To learn more about version control in Dataiku, visit our page on project version control.