使用動態表達式編輯器來設定 Dataflow Gen2 的資料目的地(預覽)

Note

資料目的地的動態表達式編輯器目前處於預覽階段。

動態表達式編輯器幫助你在支援的資料目的地欄位建立值,方法是將文字與資料流執行時會解析的值結合。 例如,你可以在檔案名稱中包含 UTC 更新日期、使用資料表名稱的參數,或是加入工作區專屬的值。

編輯器預設是啟用的。 當你第一次使用它時,教學說明會說明如何開啟動態值選單。

可用值

編輯器中可用的數值取決於資料流與工作區設定。

類別 Description
動態值 資料流執行的 UTC 日期與時間值。 日期使用 yyyyMMdd,時間使用 HHmmss,而 日期/時間則使用 yyyyMMddHHmmss。 例如,日期/時間值可以解析為 20201230232459 2020 年 12 月 30 日 23:24:59 UTC。
參數 你在資料流程中定義的參數。 在選單中選擇 「管理參數 」以建立或編輯參數。
工作區變數 資料流可使用內建的工作區值(例如 currentWorkspaceId)以及來自 Fabric 變數庫項目中的值。

建立動態資料表或檔案名稱

  1. 在 Power Query 編輯器中,為查詢新增資料目的地。

  2. 將游標置於支援動態表達式(如 資料表名稱 或 檔案名稱)的目標欄位。

  3. 輸入任何每次資料流執行時應該保持不變的文字。

  4. 按下 / 鍵開啟動態值選單。

    動態值選單的截圖,顯示在檔案名稱欄位開啟。選單包含日期、時間、日期/時間、參數及工作區變數。

  5. 選擇動態值、參數或工作空間變數。 你也可以在 / 之後開始輸入,以篩選選單。

  6. 持續輸入文字和數值直到表達式完成。 若目的地為檔案,請以文字形式包含副檔名。

    一個動態檔案名稱的截圖,結合了文字與日期、時間及日期/時間標記。

  7. 完成資料目的地的設定,然後發布資料流程。

執行時,Dataflow Gen2 解析每個標記,並將這些值與表達式中的文字結合。 目的地的正常行為仍然適用於產生出的名稱。 例如,當解析的檔案名稱與現有檔案相符時,檔案目的地可以覆蓋該檔案。

編輯表達式

你可以編輯文字,並在表達式的任何位置插入更多值。

  • 若要在不使用滑鼠的情況下開啟選單,請按 /. 使用方向鍵在選單中移動,然後按 Enter 插入選中的數值。
  • 若要關閉選單而不選擇任何值,請按 Esc。 / 你輸入的文字以及之後輸入的任何文字都會以文字形式存在欄位。
  • 要移除已插入的值,將游標放在該標記旁邊,按下 退格 鍵或 刪除鍵。

示例表達式

Scenario Expression
在檔名中加入運行日期和時間 Orders-<Date>-<Time>.csv
使用資料流參數作為資料表名稱前綴 <Environment>_Sales
將目前的工作區包含在名稱中 Sales_<currentWorkspaceId>

在編輯器中,這些例子中括號內的數值會以標記形式呈現。 你不用輸入角括號。

Important

解析中的表格或檔案名稱必須遵循所選目的地的命名規則。 若動態值引入不支援字元或產生無效名稱,目的驗證或資料流執行可能會失敗。

請關閉或開啟動態表達式編輯器

動態表達式編輯器預設啟用。 你的偏好設定會儲存在瀏覽器的 cookie 裡,不會儲存在 Fabric 服務中。 因此,這個設定不會跨瀏覽器或裝置通用,只要清除瀏覽器 Cookie,設定就會回復預設。 若要變更:

  1. 在 Power Query 編輯器中,從「主頁」分頁選擇「選項」。
  2. 在 選項 對話框中,選擇 全域>通用。
  3. 捲動至 資料目的地 區塊。
  4. 在 編輯器中,清除 啟用動態表達式編輯器 以關閉編輯器。 勾選勾選方塊即可重新開啟。
  5. 請選擇 [確定]。

選項對話對話截圖,在資料目的地中選擇啟用動態表達式編輯器設定。

關閉編輯器並不會移除已經設定好的動態表達式。

考慮事項與限制條件

  • 可用性取決於所選資料目的地與欄位。
  • 編輯器結合文字與可用值。 它不是通用的 Power Query M 表達式編輯器。
  • 資料流執行時必須有參考的參數或工作空間變數可用。
  • 更改參數、工作區變數、日期或時間值,可能會導致已解析的目的地名稱在執行間改變。
  • 若要參數化本編輯器不支援的目的地設定,請參閱 資料目的地查詢的進階編輯。