Pipeline Optimization Best Practices

Programmers will be familiar with the process of code refactoring, where the goals include improving readability, reducing complexity, and increasing efficiency—all while maintaining the same functionality of the original code.

A similar logic can be applied to refactoring a Dataiku project, and before moving it to production is an excellent opportunity to think about optimization techniques.

Here we’ll highlight a number of strategies to optimize the Flow of a project, in particular with regards to computational efficiency.

Basic Cleanup

Let’s start simple. Perform a basic cleanup of the project. Delete any unnecessary objects created during the project’s development, such as discarded Flow branches, draft notebooks, or unused scenarios.

Should you want to retain certain artifacts not required for production, Dataiku has features that enable you to safely copy objects into other projects and delete them from the original.

Dataiku screenshot of the copy objects dialog in the Flow.

To migrate Flow objects to other projects before moving to production, select them and click “Copy” in the Actions sidebar.


You might also review the project’s readability, particularly as new contributors may join the project as it moves to production. For large Flows, add Flow Zones to help communicate the main phases of a project from a high level.

Dataiku screenshot of a project with several Flow zones.

Flow Zones can improve the high-level readability of a project before moving it to production.


Related to a project’s readability is how well documented it is. Learn more in best practices for workflow documentation.


Consider the project’s maintainability. If you’ve hard-coded values in recipes, try replacing them with variables.

Slide depicting variable syntax in Dataiku.

You can define project variables as JSON objects.


You can learn more about variables in courses such as Variables 101 and Variables for Coders.

Computational Efficiency

A key optimization consideration is the project’s computational efficiency. Is the Flow running in the most optimized way possible?

Recall that Dataiku is meant to be an orchestrator of workflows. With this in mind, verify that the project satisfies two general requirements:

  • It leverages any external computing power at its disposal.

  • It minimizes resource consumption on the DSS host.

Recipe Engine Checks

To ensure your project’s Flow is optimized, you might start with the recipe engine Flow view to evaluate the current engine selections, and in particular, identify where the DSS engine is being used.

Recall that Dataiku selects the engine based on the storage location of the input and output datasets, as well as on the operation being performed. However, you should confirm that each engine is truly the “best” for your particular use case.

Dataiku screenshot of the recipe engine Flow view.

The recipe engine Flow view provides a visual way to assess which engines are being used for each recipe in the Flow.

Keep in mind that certain computation engines can be more appropriate than others depending on several factors, such as the scale of data, the available databases or architecture at your disposal, and the operations being performed.

Start with these guiding principles when reviewing recipe engines:

  • If you have datasets stored in SQL databases, make sure that the corresponding recipes run in-database.

  • If you have a large amount of data stored as files in cloud object storage, use Spark, which allows you to scale the computation by distributing it across multiple machines in a cluster. In less frequent scenarios, you can apply the same reasoning with on-premise Hadoop clusters where Spark and Hive can process data stored in HDFS at scale.

  • If you need to offload visual machine learning model training or code recipes, make sure that containerized execution is enabled and configured accordingly.

Dataiku screenshot of the recipe engine dialog.

Beneath the Run button within the Settings tab of every visual recipe is the recipe engine setting. Available engines depend on the instance’s architecture.


For more information on pushdown computation, review the summary table of where computation takes place for each operation performed in Dataiku.

Is Spark Required?

The second guiding principle above suggests using Spark for a “large amount” of data stored as files in cloud object storage. The definition of “large” will obviously vary, but if your dataset fits in the memory of a single machine, other recipe engines might be faster. For very large datasets, Spark can indeed be very fast because it can run distributed computation on clusters.

However, this advantage does not come without consequences. Spark’s overhead is non-negligible. It takes time for DSS to tell Spark what to run, how many clusters to spin up, etc. For smaller datasets, with simpler computation (i.e. not a join or window operation), the DSS engine may actually be faster than Spark.

Other Flow views, such as the file size flow view, may yield further information to help you assess whether Spark is the right-sized solution for a particular job. Ultimately though, testing—first for stability with sample-sized data—and then with more realistic data, is the only way to definitively answer the question of whether Spark is the best choice for a particular situation.


Review the product documentation for more information on DSS and Spark.

Spark and SQL Pipelines

One corollary to the principles above is that you should try to avoid the reading and writing of intermediate datasets.

In certain situations, you can minimize the repeated cycle of reading and writing intermediate datasets within a Flow by setting up either Spark or SQL pipelines.

For example, when several consecutive recipes in a Flow use the Spark engine (or alternatively the SQL engine), DSS can automatically merge these recipes, and you can run them as a single Spark (or SQL) job. These kinds of pipelines can strongly boost performance by avoiding needless reads and writes of intermediate datasets.

Dataiku screenshot of where to enable SQL pipelines in the Flow.


See this knowledge base article for an introduction on how to enable SQL pipelines in the Flow.

Back-to-Back Prepare Recipes

Having back-to-back Prepare recipes in the Flow requires some justification for doing so. One longer Prepare recipe—with one input and one output—may be more efficient than two shorter Prepare recipes. This strategy reduces the number of intermediate reads and writes.

An exception to this rule could be back-to-back Prepare recipes that enable one recipe to run in-database. If a Prepare recipe contains only SQL-compatible processors, it can take advantage of in-database computation.

Dataiku screenshot of back to back Prepare recipes in the Flow.

The first Prepare recipe contains only SQL-compatible processors, and so can use the SQL engine, whereas the second Prepare recipe has non SQL-compatible processors, and so defaults to the DSS engine.


Finally, for specific use cases, partitioning can be a very valuable optimization tool. For example, consider the common scenario where you need reports and dashboards updated on a periodic basis, such as daily. Without partitioning, the datasets in the Flow would continue to grow larger, consuming greater computational resources.

Instead of redundantly recomputing this historical data, you could instead partition the Flow so that only the latest segment of interest is rebuilt and the historical partitions are kept aside. If you do have a clear key on which to partition your Flow, partitioning is definitely an option worth considering before moving to production.

Slide depicting a partitioned Flow.

Stacked dataset icons in the Flow signal that it is a partitioned dataset.

Testing Runtime

Offloading computation using the strategies described in this article can potentially add complexity. With this in mind, you will have to weigh the pros and cons with respect to the infrastructure, the type, and the volume of data you will be using in production.

Testing the runtime of your Flow with scenarios can provide the basic information needed to think through these tradeoffs as you identify potential bottlenecks. A quick visual comparison can be found in the “Last Runs” tab of a scenario, which reports the runtime of each step. Many Flow Views, such as last build duration, count of records, or file size, can also help identify bottlenecks.

Dataiku screenshot of the last runs tab of a scenario.

What’s Next?

Alongside optimization concerns, you should also devote sufficient attention to documenting a project before putting it into production. Learn more about how to do so in an article on workflow documentation.