Note
資料目的地的動態表達式編輯器目前處於預覽階段。
動態表達式編輯器幫助你在支援的資料目的地欄位建立值,方法是將文字與資料流執行時會解析的值結合。 例如,你可以在檔案名稱中包含 UTC 更新日期、使用資料表名稱的參數,或是加入工作區專屬的值。
編輯器預設是啟用的。 當你第一次使用它時,教學說明會說明如何開啟動態值選單。
可用值
編輯器中可用的數值取決於資料流與工作區設定。
| 類別 | Description |
|---|---|
| 動態值 | 資料流執行的 UTC 日期與時間值。
日期使用 yyyyMMdd,時間使用 HHmmss,而 日期/時間則使用 yyyyMMddHHmmss。 例如,日期/時間值可以解析為 20201230232459 2020 年 12 月 30 日 23:24:59 UTC。 |
| 參數 | 你在資料流程中定義的參數。 在選單中選擇 「管理參數 」以建立或編輯參數。 |
| 工作區變數 | 資料流可使用內建的工作區值(例如 currentWorkspaceId)以及來自 Fabric 變數庫項目中的值。 |
建立動態資料表或檔案名稱
在 Power Query 編輯器中,為查詢新增資料目的地。
將游標置於支援動態表達式(如 資料表名稱 或 檔案名稱)的目標欄位。
輸入任何每次資料流執行時應該保持不變的文字。
按下
/鍵開啟動態值選單。選擇動態值、參數或工作空間變數。 你也可以在
/之後開始輸入,以篩選選單。持續輸入文字和數值直到表達式完成。 若目的地為檔案,請以文字形式包含副檔名。
完成資料目的地的設定,然後發布資料流程。
執行時,Dataflow Gen2 解析每個標記,並將這些值與表達式中的文字結合。 目的地的正常行為仍然適用於產生出的名稱。 例如,當解析的檔案名稱與現有檔案相符時,檔案目的地可以覆蓋該檔案。
編輯表達式
你可以編輯文字,並在表達式的任何位置插入更多值。
- 若要在不使用滑鼠的情況下開啟選單,請按
/. 使用方向鍵在選單中移動,然後按 Enter 插入選中的數值。 - 若要關閉選單而不選擇任何值,請按 Esc。
/你輸入的文字以及之後輸入的任何文字都會以文字形式存在欄位。 - 要移除已插入的值,將游標放在該標記旁邊,按下 退格 鍵或 刪除鍵。
示例表達式
| Scenario | Expression |
|---|---|
| 在檔名中加入運行日期和時間 | Orders-<Date>-<Time>.csv |
| 使用資料流參數作為資料表名稱前綴 | <Environment>_Sales |
| 將目前的工作區包含在名稱中 | Sales_<currentWorkspaceId> |
在編輯器中,這些例子中括號內的數值會以標記形式呈現。 你不用輸入角括號。
Important
解析中的表格或檔案名稱必須遵循所選目的地的命名規則。 若動態值引入不支援字元或產生無效名稱,目的驗證或資料流執行可能會失敗。
請關閉或開啟動態表達式編輯器
動態表達式編輯器預設啟用。 你的偏好設定會儲存在瀏覽器的 cookie 裡,不會儲存在 Fabric 服務中。 因此,這個設定不會跨瀏覽器或裝置通用,只要清除瀏覽器 Cookie,設定就會回復預設。 若要變更:
- 在 Power Query 編輯器中,從「主頁」分頁選擇「選項」。
- 在 選項 對話框中,選擇 全域>通用。
- 捲動至 資料目的地 區塊。
- 在 編輯器中,清除 啟用動態表達式編輯器 以關閉編輯器。 勾選勾選方塊即可重新開啟。
- 請選擇 [確定]。
關閉編輯器並不會移除已經設定好的動態表達式。
考慮事項與限制條件
- 可用性取決於所選資料目的地與欄位。
- 編輯器結合文字與可用值。 它不是通用的 Power Query M 表達式編輯器。
- 資料流執行時必須有參考的參數或工作空間變數可用。
- 更改參數、工作區變數、日期或時間值,可能會導致已解析的目的地名稱在執行間改變。
- 若要參數化本編輯器不支援的目的地設定,請參閱 資料目的地查詢的進階編輯。