在笔记本中使用参数

已完成

可以使用参数将变量值从管道传递到笔记本。 参数化比在笔记本代码中使用硬编码值更灵活。

在笔记本中使用参数

若要在笔记本中定义和使用参数,请在笔记本代码中使用 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)

在管道中设置参数值

若要将参数值传递给笔记本活动,请将每个参数添加到活动的基参数,如下所示:

Screenshot of a Notebook activity with a folder parameter.

在此示例中,参数值显式指定为笔记本活动的属性。 还可以定义 pipeline 参数并将其值动态分配给笔记本活动的基参数;添加进一步的抽象级别。

提示

有关在 Azure 数据工厂中使用参数的详细信息,请参阅 Azure 数据工厂文档中的如何在 Azure 数据工厂中使用参数、表达式和函数