在笔记本中使用参数

已完成

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

在笔记本中使用参数

若要在笔记本中定义和使用参数,请在笔记本代码中使用 dbutils.widgets 库。

例如,以下 Python 代码定义一个名为 文件夹 的变量,并分配 数据的默认值:

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

若要检索参数值,请使用 获取 函数,如下所示:

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

get 函数将检索传递给笔记本的特定参数的值。 如果未传递此类参数,它将获取前面声明的变量的默认值。

传递输出值

除了使用可在 中传递给笔记本 的参数外,还可以使用 notebook.exit 函数将值 传出 到调用应用程序,如下所示:

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

在管道中设置参数值

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

包含文件夹参数的 Notebook 活动的屏幕截图。

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

小提示

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