使用 Databricks 筆記本和檔案編輯器

此頁面描述 Databricks 筆記本和檔案編輯器提供的一些函式，包括程式代碼建議和自動完成、變數檢查、程式代碼折疊，以及並存差異。 當您使用筆記本或檔案編輯器時，可以使用 Databricks Assistant 來協助您產生、說明和偵錯程式代碼。 如需詳細資訊，請參閱 使用 Databricks Assistant 。

您可以從選取的編輯器主題中選擇。 選取 [ 檢視 > 編輯器] 主題 ，然後從功能表進行選取。

自動完成

自動完成會在您鍵入程式代碼區段時自動完成。 可完成的物件包括類型、類別和物件，以及 SQL 資料庫和數據表名稱。

• 針對 Python 數據格，筆記本必須 附加至叢集 ，才能自動完成才能運作，而且您必須 執行定義可完成物件的所有單元格 。
• 針對 SQL 數據格，自動完成會建議關鍵詞和基本語法，即使筆記本未附加至任何計算資源也一樣。
  • 如果已啟用 Unity 目錄的工作區，自動完成也會建議 Unity 目錄中資料表的目錄、架構、資料表和數據行名稱。
  • 如果未啟用 Unity 目錄的工作區，筆記本必須附加至叢集或 SQL 倉儲 ，以建議數據表或數據行名稱。

自動完成建議會自動出現在儲存格中。 使用向上鍵和向下鍵或滑鼠來選取建議，然後按 Tab 或 Enter 鍵將選取範圍插入單元格中。

注意

R 筆記本中的伺服器自動完成會在命令執行期間遭到封鎖。

有兩 個使用者設定 需要注意：

• 若要關閉自動完成建議，請在輸入時切換 [自動完成]。 當自動完成關閉時，您可以按 Ctrl + 空格鍵來顯示自動完成建議。
• 若要防止 Enter 插入自動完成建議，請切換 Enter 鍵接受自動完成建議。

變數檢查

若要顯示 SQL 或 Python 筆記本中定義之變數的相關信息，請將游標停留在變數名稱上。 Python 變數檢查需要 Databricks Runtime 12.2 LTS 或更新版本。

移至定義

在 Databricks Runtime 12.2 LTS 和更新版本中，當 Python 筆記本附加至叢集時，您可以自動流覽至該筆記本中定義的變數或函式定義。 若要這樣做，請按住 macOS 上的 Cmd 鍵或 Windows 上的 Ctrl 鍵，並將游標暫留在變數或函式的名稱上。 如果找到定義，名稱會變成超連結，並變更為底線藍色文字。 當您按下連結時，游標會移至定義變數或函式的程式代碼。

您也可以在 macOS 上使用鍵盤快捷方式 Cmd+F12 或 Windows 上的 Ctrl+F12 。

程式碼摺疊功能

程式代碼折疊可讓您暫時隱藏程式代碼區段。 這在處理長程式代碼區塊時很有用，因為它可讓您專注於您正在處理的特定程式代碼區段。

若要隱藏程式代碼，請將游標放在儲存格最左邊。 向下指向箭號會出現在邏輯點，您可以在其中隱藏程式代碼區段。 按兩下箭號以隱藏程式代碼區段。 再次按下箭號（現在指向右側）以顯示程序代碼。

如需更多詳細數據，包括鍵盤快捷方式，請參閱 VS Code 檔。

Multicursor 支援

您可以建立多個資料指標，讓同時編輯變得更容易，如影片所示：

若要在儲存格中建立多個資料指標：

• 在macOS上 Option 按住索引鍵，然後按下每個位置以新增游標。
• 在 Windows 上 Alt 按住索引鍵，然後按下每個位置以新增游標。
• 您也可以選擇變更快捷方式。 請參閱 變更多重cursor 和數據行選取範圍的快捷方式。

在macOS上，您可以使用鍵盤快捷方式 Option+Command+ 向上鍵或向下鍵來建立垂直對齊的多個游標。

欄 （方塊） 選取

若要選取數據行中的多個專案，請按下您想要擷取的區域左上方。 接下來：

• 在macOS上，按 Shift + Option 並拖曳到右下角以擷取一或多個數據行。
• 在 Windows 上，按 Shift + Alt 並拖曳到右下角以擷取一或多個數據行。
• 您也可以選擇變更快捷方式。 請參閱 變更多重cursor 和數據行選取範圍的快捷方式。

變更多重cursor 和數據行選取的快捷方式

替代的快捷方式可用於多重cursor 和 column （box） 選取。 使用替代選取專案時，快捷方式會變更，如下所示：

• 若要在儲存格中建立多個資料指標：
  • 在macOS上 Cmd 按住索引鍵，然後按下每個位置以新增游標。
  • 在 Windows 上 Ctrl 按住索引鍵，然後按下每個位置以新增游標。
• 若要選取數據行中的多個專案，請按下您想要擷取的區域左上方。 然後：
  • 在macOS上，按 Option 並拖曳到右下角以擷取一或多個數據行。
  • 在 Windows 上，按 Alt 並拖曳到右下角以擷取一或多個數據行。

若要啟用替代快捷方式，請執行下列動作：

1. 按兩下一下角的使用者名稱，然後按下拉式清單中的 [設定]。
2. 在 設定 提要字段中，選取 [開發人員]。
3. 在 [程序代碼編輯器] 區段中，將多游標按兩下的密鑰修飾詞設定變更為MacOS的 Cmd 或適用於 Windows 的 Ctrl。

當您啟用替代快捷方式時，用來建立垂直對齊之多個游標的鍵盤快捷方式不會變更。

括弧比對

當您按兩下括弧、方括弧或大括弧附近時，編輯器會醒目提示該字元及其相符的括號。

版本歷程記錄中的並存差異

當您 顯示舊版筆記本時，編輯器會以色彩醒目提示顯示並排差異。

語法錯誤醒目提示

當筆記本 連線到叢集時，語法錯誤會以波浪線醒目提示。 針對 Python，叢集必須執行 Databricks Runtime 12.2 LTS 或更新版本。

若要啟用或停用語法錯誤醒目提示，請執行下列動作：

1. 按兩下一下角的使用者名稱，然後按下拉式清單中的 [設定]。
2. 在 設定 提要字段中，選取 [開發人員]。
3. 在 [程序代碼編輯器] 區段中，切換 SQL 語法錯誤醒目提示或 Python 語法錯誤醒目提示的設定。

語法錯誤和警告的可能動作

當您看到語法錯誤時，您可以將滑鼠停留在它上方，然後選取 [快速修正 ] 以取得可能的動作。

注意

此功能使用 Databricks Assistant。 如果您沒有看到任何動作，這表示您的系統管理員必須先啟用 Databricks Assistant。