Usar parâmetros em um bloco de anotações

Concluído

Você pode usar parâmetros para passar valores de variáveis para um bloco de anotações a partir do pipeline. A parametrização permite maior flexibilidade do que o uso de valores codificados no código do notebook.

Usando parâmetros em um bloco de anotações

Para definir e usar parâmetros em um bloco de anotações, use a biblioteca dbutils.widgets no código do seu bloco de anotações.

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 a função get , da seguinte forma:

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

A função get recuperará o valor do parâmetro específico que foi passado para o bloco de anotações. Se nenhum parâmetro foi passado, ele obterá o valor padrão da variável declarada anteriormente.

Passando valores de saída

Além de usar parâmetros que podem ser passados para um bloco de anotações, você pode passar valores para o aplicativo de 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âmetros em um pipeline

Para passar valores de parâmetro para uma atividade do Bloco de Anotações, 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 é explicitamente especificado como uma propriedade da atividade Notebook . Você também pode definir um parâmetro de pipeline e atribuir seu valor dinamicamente ao parâmetro base da atividade do Notebook , adicionando um nível adicional de abstração.

Gorjeta

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.