在 Notebook 中使用參數

已完成

您可以使用參數，將變數值從管線傳遞到筆記本。 參數化可提供比在筆記本程式碼中使用硬式編碼值更大的彈性。

在筆記本中使用參數

若要在筆記本中定義並使用參數，在筆記本程式碼中使用 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 活動的屬性。 您也可以定義 pipeline 參數，並將其值動態指派給 Notebook 活動的基底參數；新增進一步的抽象概念層級。

提示

如需在 Azure Data Factory 中使用參數的詳細資訊，請參閱 Azure Data Factory 文件中的如何在 Azure Data Factory 中使用參數、運算式和函數。