Forum Discussion

Ostrzak's avatar
Ostrzak
Helper II
2 years ago
Solved

Referencing notebook exit value as a variable in a data pipeline

Hi everyone,

 

In general: I am trying to build a pipeline around multiple PySpark notebooks, with some additional pipeline features. To achieve it I need to pass values from a notebook to a pipeline.

I checked several pages concerning the topic and consensus was to use Exit Value in the notebook:

 

mssparkutils.notebook.exit(variable)

 

And then create a pipeline variable, and then in Set variable pipeline activity use a dynamic expression:

 

@activity('Notebook_name').output.status.Output.result.exitValue

 

 

For some reason I get such error in Set Variable activity:

 

The expression 'activity('Notebook1').output.status.Output.result.exitValue' cannot be evaluated because property 'Output' cannot be selected. Property selection is not supported on values of type 'String'.

 

I can't find anything on it's origin and what I should change. I tried formatting exit value as an number or string and it doesn't help.

 

I would appreciate the help. If there is another way to "pass" values from the notebook to the pipeline, please let me know; I need it to work further.

  • For my own implementation the delimited string just wasnt flexible enough - so here's a version using a JSON object as the notebook return value: 

     

    Notebook pyspark:

     

    lResult={"numUpdated":10,"message":"success","fruit":["apple","orange","grapes"]}
    mssparkutils.notebook.exit(str(lResult))

     

    Expression for varMessageStr:

     

    Anonymous(activity('Test Notebook').output.result.exitValue).message

     

    Expression for varNumUpdatedInt:

     

    INT(json(activity('Test Notebook').output.result.exitValue).numUpdated)

     

    Expression for varFruitArray:

     

    Anonymous(activity('Test Notebook').output.result.exitValue).fruit

     

16 Replies

  • Nero's avatar
    Nero
    Advocate II

    I also struggled, until I tried ignoring the expression builder syntax errors and just ran my pipeline. I was able to get the following to work by using a delimited string as the notebook return value.

    Notebook pyspark:

     

    lResult="returnValueOne=25|returnValueTwo=abc|returnValueThree=19"
    mssparkutils.notebook.exit(str(lResult))

     

    Expression for varAllReturnValuesArray

     

    @split(activity('Test Notebook').output.result.exitValue,'|')

     

    Expression for varReturnValueOneString

     

    @last(split(first(split(activity('Test Notebook').output.result.exitValue,'|')),'='))

     

    Expression for varReturnValueTwoString

     

    @last(split(split(activity('Test Notebook').output.result.exitValue,'|')[1],'='))

     


     

    • Nero's avatar
      Nero
      Advocate II

      For my own implementation the delimited string just wasnt flexible enough - so here's a version using a JSON object as the notebook return value: 

       

      Notebook pyspark:

       

      lResult={"numUpdated":10,"message":"success","fruit":["apple","orange","grapes"]}
      mssparkutils.notebook.exit(str(lResult))

       

      Expression for varMessageStr:

       

      Anonymous(activity('Test Notebook').output.result.exitValue).message

       

      Expression for varNumUpdatedInt:

       

      INT(json(activity('Test Notebook').output.result.exitValue).numUpdated)

       

      Expression for varFruitArray:

       

      Anonymous(activity('Test Notebook').output.result.exitValue).fruit

       

      • AdamFry's avatar
        AdamFry
        Advocate I

        Just want to say that this post was EXTREMELY helpful to me and I want to say thank you for sharing this really nice approach.  

  • An update: I found out that changing Set variable activity to:

    @activity('Notebook_name').output.result.exitValue

    ... solves the main problem.

     

    I still haven't figured out how to pass multiple notebook values to pipeline variables, so if anyone could help me I will be grateful.

    • v-cboorla-msft's avatar
      v-cboorla-msft
      Microsoft Employee

      Hi Ostrzak 

       

      We can pass multiple parameters from Notebook to a pipeline using list of parameters. I have attached the screenshots along with the steps for your reference.

      1) Create a list of parameters inside a notebook.

      2) Using notebook and set variable activites we can pass the parameters to a pipeline.

       

      I hope this information is helpful. Please do let us know if you have any questions.

       

      • Ostrzak's avatar
        Ostrzak
        Helper II

        Hi @v-cboorla-msft 

         

        Thank you for your answer. I got to that point independently but I can't parse the exit value so that I get several independent variables out of it. It would be great to know how to tackle that problem.

         

        Additionally, is there a more advanced documentation for expression builder? I found this page and it's pretty fine, but it doesn't go beyond the functions listed in the builder. Even the expression I used in Set Variable (see my second post) was found through trial and error, after an extensive web search; it was not efficient.

         

        Thank you in advance for any help.

    • v-cboorla-msft's avatar
      v-cboorla-msft
      Microsoft Employee

      Hi Ostrzak 

       

      Thanks for using Fabric Community.

      We are reaching out to the internal team to get more information related to your query and will get back to you as soon as we have an update.