Usar 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 em código no código do notebook.

Usando 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 código Python a seguir define uma variável chamada pasta e atribui um valor padrão de dados:

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

Para recuperar um valor de parâmetro, use o obter função, desta forma:

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

A função obter recuperará o valor do parâmetro específico que foi passado para o notebook. Se nenhum parâmetro desse tipo tiver sido passado, ele 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)

Definindo valores de parâmetro em um pipeline

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

Captura de tela de uma atividade do Notebook com um parâmetro de pasta.

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

Dica

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