Use parâmetros em um notebook

Concluído

Você pode usar parâmetros para passar valores variáveis para um notebook no pipeline. A parametrização permite maior flexibilidade do que usar valores embutidos no código do notebook.

Como usar parâmetros em um notebook

Para definir e usar parâmetros em um notebook, use a biblioteca dbutils.widgets no código do notebook.

Por exemplo, o seguinte código Python define uma variável chamada folder e atribui o valor padrão de data:

dbutils.widgets.text("folder", "data")

Para recuperar o valor de um parâmetro, use a função get da seguinte forma:

folder = dbutils.widgets.get("folder")

A função get recuperará o valor do parâmetro específico passado para o notebook. Se nenhum parâmetro desse tipo for passado, ela obterá o valor padrão da variável que você declarou anteriormente.

Como passar valores de saída

Além de usar parâmetros que podem ser passados para um notebook, você pode passar valores para fora do aplicativo que realiza a chamada usando a função notebook.exit, conforme mostrado aqui:

path = "dbfs:/{0}/products.csv".format(folder)
dbutils.notebook.exit(path)

Como definir valores de parâmetro em um pipeline

Para passar valores de parâmetro para uma atividade do Notebook, adicione cada parâmetro aos Parâmetros base da atividade, conforme mostrado aqui:

Screenshot of a Notebook activity with a folder parameter.

Neste exemplo, o valor do parâmetro é especificado explicitamente como uma propriedade da atividade do Notebook. Você também pode definir um parâmetro de pipeline e atribuir o valor dinamicamente ao parâmetro base da atividade do Notebook, o que adiciona um nível adicional de abstração.

Dica

Para obter mais informações sobre como usar parâmetros no Azure Data Factory, confira Como usar parâmetros, expressões e funções no Azure Data Factory na documentação do Azure Data Factory.