在 Notebook 中使用參數

已完成

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

在筆記本中使用參數

若要在筆記本中定義和使用參數，請在筆記本程序代碼中使用 dbutils.widgets 連結庫。

例如，下列 Python 程式代碼會定義名為 資料夾 的變數，並指派 數據的預設值：

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 活動的基底參數;新增更進一步的抽象概念層級。

小提示

如需在 Azure Data Factory 中使用參數的詳細資訊，請參閱 Azure Data Factory 檔中如何使用 Azure Data Factory 中的參數、表達式和函 式。