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

• 3 мин

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

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

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

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

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

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

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

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

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

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

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

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

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

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