Orchestrate and operationalize Synapse Notebooks and Spark Job Definitions from Azure Data Factory
Published Jan 25 2023 11:18 AM 10.1K Views

Today, we are introducing support for orchestrating Synapse notebooks and Synapse spark job definitions (SJD) natively from Azure Data Factory pipelines. It immensely helps customers who have invested in ADF and Synapse Spark without requiring to switch to Synapse Pipelines for orchestrating Synapse Notebooks and SJD. 


NOTESynapse notebook and SJD activities were only available in Synapse Pipelines previously. 


One of the critical benefits of Synapse notebooks is the ability to use Spark SQL and PySpark to perform data transformations. It allows you to use the best tool for the job, whether it be SQL for simple data cleaning tasks or PySpark for more complex data processing tasks.


How to get started with Synapse Notebooks in ADF?


1. Add Synapse Notebook activity into a Data Factory pipelines




2. Create a connection to Synapse workspace through a new compute Linked Service (Azure Synapse Analytics Artifact)




3. Choose an existing notebook to operationalize



Note: If you do not specify 'Spark pool', 'Executor size', etc., it will use the one specified in the notebook. These properties are optional and only provides you additional spark configurations to override these during the operational run.

4. Grant the ADF Managed Identity the "Synapse Compute Operator" permissions to execute a Notebook / SJD in the Synapse Workspace 
Step 2 (Creation of Azure Synapse Analytics artifact linked service) highlights the Managed Identity Name of the Data Factory that needs to be granted permission to run a notebook / SJD. 

5. Monitor the notebook run details by accessing the activity output, which contains "sparkApplicationStudioUrl" that takes you to Synapse Workspace for detailed run monitoring. Notebook "exitValue" is also accessible in the output and can be referenced in the down stream activities.






We are always open for feedback so please let us know your thoughts in the comments below or add to our Ideas forum.


Version history
Last update:
‎Jan 27 2023 04:33 PM
Updated by: