Использование параметров в записной книжке

Завершено

Параметры можно использовать для передачи значений переменных в ноутбук из конвейера. Параметризация обеспечивает большую гибкость, чем использование жестко закодированных значений в коде записной книжки.

Использование параметров в записной книжке

Чтобы определить и использовать параметры в записной книжке, используйте библиотеку dbutils.widgets в коде записной книжки.

Например, следующий код Python определяет переменную с именем папку и назначает значение по умолчанию данных:

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

Чтобы получить значение параметра, используйте функцию получения следующим образом:

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

Функция получения извлекает значение для определенного параметра, переданного в записную книжку. Если такой параметр не был передан, он получит значение по умолчанию переменной, объявленной ранее.

Передача выходных значений

Помимо использования параметров, которые можно передать в записной книжке, можно передать значения в вызывающее приложение с помощью функции notebook.exit, как показано ниже:

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

Задание значений параметров в конвейере

Чтобы передать значения параметров в действие Notebook, добавьте каждый параметр в базовые параметры действия, как показано ниже:

Снимок экрана активности в записной книжке с параметром папки.

В этом примере значение параметра явно указывается как свойство действия Notebook. Вы можете также определить параметр конвейера и динамически назначить его значение базовому параметру Notebook, добавляя тем самым дополнительный уровень абстракции.

Подсказка

Дополнительные сведения об использовании параметров в фабрике данных Azure см. в статье Использование параметров, выражений и функций в фабрике данных Azure в документации по фабрике данных Azure.