在筆記本中開發和偵錯 Delta Live Tables 管線

重要

Delta Live Tables 開發的筆記本體驗處於 公開預覽狀態。

本文說明 Azure Databricks 筆記本中的功能，可協助開發及偵錯 Delta Live Tables 程式代碼。

功能概觀

當您使用 Python 或 SQL 筆記本，這是現有 Delta Live Tables 管線的原始程式碼時，您可以將筆記本直接連線到管線。 當筆記本連線到管線時，可以使用下列功能：

• 從筆記本啟動並驗證管線。
• 檢視管線的數據流圖表和事件記錄檔，以取得筆記本中的最新更新。
• 在筆記本編輯器中檢視管線診斷。
• 在筆記本中檢視管線叢集的狀態。
• 從筆記本存取 Delta Live Tables UI。

必要條件

• 您必須有現有的 Delta Live Tables 管線，且具有 Python 或 SQL 筆記本作為原始程式碼。
• 您必須是管線的擁有者或具有 CAN_MANAGE 許可權。

限制

• 本文所涵蓋的功能僅適用於 Azure Databricks 筆記本。 不支援工作區檔案。
• 連結至管線時，無法使用 Web 終端機。 因此，它不會顯示為底部面板中的索引標籤。

將筆記本連線到 Delta Live Tables 管線

在筆記本內，按兩下選取計算的下拉功能表。 下拉功能表會顯示您的所有 Delta Live Tables 管線，並以此筆記本作為原始程式碼。 若要將筆記本連線到管線，請從清單中選取它。

檢視管線的叢集狀態

若要輕鬆瞭解管線叢集的狀態，其狀態會顯示在計算下拉功能表中，其綠色表示叢集正在執行。

驗證管線程序代碼

您可以 驗證管線 來檢查原始程式碼中的語法錯誤，而不需要處理任何數據。

若要驗證管線，請執行下列其中一項：

• 在筆記本右上角，按兩下 [ 驗證]。
• 在任何筆記本數據格中按下 Shift+Enter 。
• 在儲存格的下拉功能表中，按一下 [ 驗證管線]。

注意

如果您嘗試在現有更新正在執行時驗證管線，則會顯示對話框，詢問您是否要終止現有的更新。 如果您按兩下 [是]，現有的更新就會停止，且 驗證 更新會自動啟動。

啟動管道

管線更新會執行下列動作：啟動叢集、探索及驗證定義的所有數據表和檢視，以及建立或更新具有可用最新數據的數據表和檢視表。

若要開始更新管線，請按下 筆記本右上角的 [開始 ] 按鈕。

檢視更新的狀態

筆記本中的頂端面板會顯示管線更新是否為：

• 啟動中
• Validating
• 正在停止

檢視錯誤和診斷

在管線啟動或驗證之後，任何錯誤會以紅色底線內嵌顯示。 將滑鼠停留在錯誤上方以查看詳細資訊。

檢視管線事件

附加至管線時，筆記本底部有 [差異實時數據表] 事件記錄索引標籤。

檢視管線數據流圖形

若要檢視管線的數據流圖表，請使用筆記本底部的 [Delta Live Tables] 圖表索引卷標。 選取圖形中的節點會在右側面板中顯示其架構。

如何從筆記本存取 Delta Live Tables UI

若要輕鬆地跳到 Delta Live Tables UI，請使用筆記本右上角的功能表。

從筆記本存取驅動程序記錄和 Spark UI

您可以從筆記本的 [檢視 ] 功能表輕鬆存取與開發管線相關聯的驅動程序記錄和 Spark UI。