藉由執行筆記本來轉換資料

利用筆記本活動執行你在 Microsoft Fabric 中建立的 notebooks，作為資料工廠管線的一部分。 筆記本 可讓您執行 Apache Spark 作業，以在數據工作流程中帶入、清除或轉換您的數據。 在 Fabric 中，輕鬆將 Notebook 活動加入你的管線，本指南會逐步引導你完成每個步驟。

必要條件

若要開始使用，您必須滿足下列必要條件：

• 你必須能存取一個 Microsoft Fabric 租戶，並且有已設定的 capacity。 你可以免費試用Fabric。
• 分配給該運算能力的 Fabric 工作區。

• 在您的工作區中建立筆記本。 要建立新筆記本，請參考 如何建立Microsoft Fabric筆記本。

建立筆記本活動

1. 在工作區中建立新的管線。

2. 在活動窗格中搜尋 Notebook，然後選取它將其新增至管線畫布。

   

3. 如果尚未選取，請在畫布上選取新的 Notebook 活動項目。

   

   請參閱一般設定指引，以設定一般設定索引標籤。

設定筆記本設定

選取 [設定] 索引標籤。

在 「連線」中，選擇筆記本執行的認證方式，並提供所需的憑證。

從 筆記本 下拉選單中選擇現有筆記本，並可選擇指定任何要傳遞給筆記本的參數。

在筆記本功能中使用 Fabric 工作區身份（WI）

1. 建立工作區身份

   你必須在工作區啟用 WI（這可能需要一點時間才能載入）。 在您的 Fabric 工作區中建立工作區識別。 請注意，WI 應該建立在與你的管線相同的工作區。

   可以參考 Workspace Identity 的文件。

2. 啟用租戶層級設定

   啟用以下租戶設定（預設是停用的）：服務主體可以呼叫Fabric公開 API。

   你可以在 Fabric 管理入口啟用此設定。 欲了解更多關於此設定的資訊，請參閱 「啟用服務主體認證以供管理員 API 使用」條目。

3. 授予工作區身份權限

   打開工作區，選擇管理存取權，並為工作區身份分配權限。 貢獻者存取權對大多數情況來說就足夠了。 如果你的筆記本不在與你的管線相同的工作區內，你需要將你在管線工作區中建立的 WI 分配給筆記本所在工作區，並至少賦予 Contributor 權限。

   可以參考「 讓使用者存取工作區」的文件。

自動填入 Notebook 活動的基礎參數

自動填充基礎參數 會自動發現筆記本中定義的參數，並在管線編寫時將其填入筆記本活動。 此功能減少手動設定，防止錯誤，並保持管線與筆記本邏輯一致。

必要條件

• 你的筆記本必須包含 參數儲存格。
• 只有在這個儲存格中定義的變數會被偵測為參數。

運作原理

當你在「筆記本」活動中選取筆記本時：

• 當你在設定中切換到基礎參數時，系統會自動從筆記本取得參數。
• 基礎參數區塊包含：
  • Names
  • 型別
  • 預設值

你可以檢視自動填充的參數，並（可選地）覆蓋參數值。

關鍵行為

• 參數會在你選擇筆記本時自動填入。
• 更換筆記本會刷新參數清單。
• 沒有參數儲存格→也沒有填入任何參數。

設定會話標籤

若要將執行筆記本作業所需的時間降到最低，您可以選擇性地設定會話標記。 設定工作階段標籤會指示 Spark 重複使用任何現有的 Spark 工作階段，將啟動時間降至最低。 任何任意字串值都可用於會話標記。 如果沒有會話存在，則會使用標記值建立新的會話。

儲存管道並執行或排程

切換到管線編輯器頂端的 主頁 ，選擇儲存按鈕來儲存管線。 選擇「 跑步 」直接執行，或選擇 排程 以安排特定時間或間隔的行程。 欲了解更多管線運行資訊，請參見： 排程管線運行。

執行後，你可以監控管線執行，並從畫布下方的 輸出 標籤查看執行歷史。

已知問題

• 使用 Service Principal 執行包含語意連結程式碼的筆記本存在功能限制，且僅支援部分語意連結功能。 詳情請參閱 支援的語意連結函數 。 若要使用其他功能，建議您使用 服務主體手動驗證語意連結。
• Notebook 活動不支援跨區域呼叫筆記本。

相關內容

• 如何監視管道執行