使用 Databricks 互動式調試程式

重要

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

此頁面描述如何使用 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。

使用變數總管

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

終止調試程式會話

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

限制

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