在資料流程 Gen2 中使用公用參數

數據流 Gen2 中的參數可讓您動態控制及自定義數據流，藉由啟用不同的輸入和案例，使其更具彈性且可重複使用，而不需要修改數據流本身。 它可藉由減少多個數據流的需求，並在單一參數化數據流內集中控制，來協助保持組織性。

資料流程 Gen2 中的公用參數是一種新模式，您可以透過 Fabric REST API 或原生 Fabric 體驗，在 Power Query 編輯器外部傳遞參數值，以允許執行資料流程。 它可讓您在資料流程中獲得更動態的體驗，其中每次執行都可以使用影響資料流程執行方式的不同引數來叫用。

先決條件

• 支援 CI/CD 的 Gen2 數據流
• 引數必須在資料流程中設定。進一步瞭解如何在資料流程中設定查詢參數。

啟用公用參數模式

身為資料流程的擁有者，開啟資料流程。 在功能區的 [首頁] 索引標籤內，選取 [ 選項] 按鈕。

選取按鈕會開啟新的 [ 選項 ] 對話框。 在垂直選單中，選取在資料流程群組內帶有卷標參數的選項。 在 [參數] 區段中，您可以啟用顯示為 "啟用允許參數被探索並可被覆寫以供執行" 的選項，以啟用公用參數模式。

選取 [ 確定] 按鈕以認可這些變更。

啟用此模式時，您會在對話框頂端的 [ 管理參數 ] 對話框中收到通知，該對話框中會讀取「已啟用公用參數模式」。

啟用公用參數模式之後，您就可以儲存數據流。

傳遞 Dataflow 執行的自訂參數值

公用參數模式遵循數據流內參數的定義，其中必要與非必要參數之間有區別。

• 必要引數：如果參數是視需要設定，若要執行資料流，必須將值傳遞至執行工作。 如果未針對設定為必要的參數傳遞任何值，則執行會失敗。
• 非必要參數：這些參數也稱為 選擇性 參數，且不需要傳遞值即可觸發執行。 如果未傳遞任何值，則會使用參數內定義的 「目前」值 來執行。

在管道中使用 Dataflow 活動

備註

建議您深入瞭解 Fabric 管線的資料流程活動 ，以瞭解其所有功能。

當您在 Fabric 中建立管線時，您可以使用資料流程活動來觸發資料流程 Gen2 的運行，該資料流程具有 CI/CD 支援並已啟用公用參數模式。

您可以選取要使用的數據流，並設定您想要在 [數據流參數 ] 區段中使用的參數。

在「 資料流程參數 」區段中，您可以查看資料流程中可用的所有參數，以及值區段中每個參數的預設值。

必要參數的名稱旁邊有星號，而選擇性參數則沒有。 同時，可以從方格中移除選擇性參數，而必要參數無法刪除，而且必須傳遞值才能執行資料流程。

您可以選取重新整理按鈕，從資料流請求最新的引數資訊。

支援的參數類型

小提示

讀取並使用 發現資料流參數的 REST API。 檔案提供所有可用的引數型別及其預期值，而REST API提供從資料流取得引數資訊的方法。

下表顯示目前支援的參數類型，以及 REST API 定義的連結，以瞭解 REST API 預期的值。

資料流程參數類型	REST API 定義
文字	DataflowString參數
整數 （int64）	DataflowInteger參數
十進位數	DataflowNumber參數
Date	DataflowDate參數
DateTime	DataflowDateTime參數
Time	DataflowTime參數
日期時間區域	DataflowDateTimeZone參數
持續時間	DataflowDuration參數
正確/錯誤	DataflowBoolean 參數

考慮事項與限制條件

以下是在資料流程Gen2中搭配CI/CD使用公用引數模式時的所有考量和限制清單：

• 排程和手動觸發：除非未設定必要的參數，否則無法透過 Fabric 排程或手動觸發具有公用參數的資料流程。
• 不支援的參數化：不支援變更來源或目的地資源路徑的參數。 連線會固定至已編寫的路徑。
• 增量重新整理：與公共參數模式不相容。
• 邏輯修改：公用參數允許使用者有權覆寫值，從而可能變更資料流輸出。
• 監視中樞：監視中樞不會顯示執行期間使用的參數值。
• 暫存行為：只有最新的執行會儲存在暫存 Lakehouse 中。 使用已定義的目的地來保留資料。
• 重複請求：如果多次提交相同的參數值，則僅接受第一個請求，直到完成為止。
• 結構描述對應：參數無法修改目的地結構描述對應。 所有映射都遵循已編寫的配置。 如需 數據流 Gen2 中數據目的地和受控設定的詳細資訊，請參閱這篇文章。