偵錯筆記本

重要

這項功能處於公開預覽狀態。

此頁面描述如何使用 Databricks 筆記本中的內建互動式調試程式。 調試程式僅適用於 Python。

互動式調試程式提供斷點、逐步執行、變數檢查和更多工具，以協助您更有效率地在筆記本中開發程序代碼。

需求

您的筆記本必須附加至符合下列需求的叢集：

• Databricks Runtime 13.3 LTS 版或更新版本。
• 存取模式必須是 [單一使用者 ][已指派] 或 [無隔離共用]。

啟用調試程式

使用下列步驟來啟用調試程式，：

1. 按兩下工作區右上角的使用者名稱，然後從下拉式清單中選取 [設定 ]。
2. 在 [設定] 提要字段中，選取 [開發人員]。
3. 在 [實驗性功能] 區段中，切換 [Python Notebook 互動式調試程式]。

開始偵錯

若要啟動調試程式，請遵循下列步驟：

1. 按兩下儲存格的排水溝，以新增一或多個斷點。 若要移除斷點，請再次按兩下它。

   

2. 使用下列其中一個選項啟動偵錯工作階段：

   • 按兩下 [ 執行 > 偵錯] 資料格。
   • 使用鍵盤快捷方式 選項 + Shift + D。
   • 從數據格執行功能表中，選取 [ 偵錯] 數據格。

   

偵錯會話會自動啟動，並執行選取的儲存格。

如果儲存格觸發錯誤，您也可以啟動調試程式。 在儲存格輸出底部， 按下 。

當偵錯會話處於使用中狀態時，偵錯工具列 會出現在單元格頂端。

偵錯動作

在偵錯工作階段中，您可以執行下列動作：

• 設定或移除斷點。
• 在斷點檢視變數的值。
• 逐步執行程式碼。
• 逐步執行或退出函式。

當程式代碼到達斷點時，它會在行執行之前停止，而不是之後。

使用調試程式工具列中的按鈕來逐步執行程序代碼。 當您逐步執行程式代碼時，數據格中會反白顯示目前的行。 您可以在右側提要欄位的 [變數總管] 窗格中檢視變數值。

當您逐步執行函式時，局部函數變數會出現在變數窗格中，標示為 [local]。

偵錯主控台

當您啟動偵錯會話時，偵錯控制台會自動出現在底部面板中。 此主控台可讓您執行 Python 程式代碼，以在斷點暫停時檢查或操作變數。 在主筆記本中執行的程式代碼不會在偵錯會話期間執行。 若要在控制台中執行程序代碼，請按 Enter 鍵。 針對多行表達式，請使用 Shift + Enter 移至新行。

注意

• 偵錯主控台是針對快速評估而設計，如果程式代碼執行超過15秒，就會逾時。
• 偵 display 錯主控台不支援命令。 若要檢視 DataFrame 中的範例數據，請使用 df.show() PySpark DataFrame 或 df.head() Pandas DataFrame。

變數總管

您可以使用右側的變數總管面板 來檢視變數的值。 按兩下 [ 檢查 ] 會自動在偵錯控制台中執行程式碼，以輸出變數的值。

若要篩選顯示，請在搜尋方塊中輸入文字。 當您輸入時，會自動篩選清單。

針對 Databricks Runtime 12.2 LTS 和更新版本上的 Python，變數會在數據格執行時更新。 針對 Databricks Runtime 11.3 LTS 和以下的 Scala、R 和 Python，變數會在數據格完成執行之後更新。

終止調試程式會話

若要結束偵錯會話，請按兩下 數據格左上角，或按下 筆記本頂端。 如果使用者不使用偵錯工具列或偵錯控制台，偵錯會話也會在 30 分鐘後自動終止。

使用 Databricks Assistant 進行偵錯

Databricks Assistant 是一個內容感知 AI 助理，可協助您對程式代碼進行偵錯。 如需詳細資訊，請參閱 在筆記本數據格 中使用 Databricks Assistant。

限制

如需詳細資訊，請參閱已知限制 Databricks 筆記本。