共用方式為

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

  • 發行項

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

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

個人化自動完成

在您鍵入程式碼片段時，[自動完成] 會自動完成程式碼片段。 可完成的物件包括類型、類別和物件，以及 SQL 資料庫和資料表名稱。 Databricks 會使用您的 Unity Catalog 中繼資料和使用方式來個人化建議。

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

當您在儲存格中輸入時，會自動顯示自動完成建議。 使用向上鍵和向下鍵或滑鼠來選取建議，然後按 [Tab] 或 [Enter] 鍵將選取範圍插入儲存格中。

注意

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

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

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

變數檢查

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

如何檢查變數

請參閱變數總管

移至定義

當 Python 筆記本附加至叢集時，可以快速移至 %run 陳述式背後的變數、函式或程式碼定義。 若要這樣做，以滑鼠右鍵按一下變數或函式名稱，然後按下 [移至定義] 或 [瞄核定義]。

按住 [macOS上的 Cmd] 鍵或 Windows 上的 [Ctrl] 鍵，並將滑鼠停留在變數或函式名稱上。 如果找到定義，該名稱就會變成超連結。

如何取得函式定義

Databricks Runtime 12.2 LTS 與更新版本提供「移至定義」功能。

程式碼摺疊功能

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

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

如何折疊程式碼

如需更多詳細資料，包括鍵盤快速鍵，請參閱 VS Code 文件。

多重資料指標支援

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

如何使用多個資料指標

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

在 macOS 上，您可以使用鍵盤快速鍵 Option+Command+ 向上鍵或向下鍵來建立多個垂直對齊的資料指標。

欄位 (方塊) 選取

若要選取資料行中的多個項目，請按下想要擷取的區域左上方。 接下來：

  • 在 macOS 上，按 Shift + Option 並拖曳到右下角，以擷取一個或多個資料行。
  • 在 Windows 上，按 Shift + Alt 並拖曳到右下角，以擷取一個或多個資料行。
  • 您也可以選擇變更捷徑。 請參閱變更多重資料指標和資料行選取範圍的捷徑。

如何選取資料行

變更多重資料指標和資料行選取範圍的捷徑

替代的捷徑可用於多重資料指標和資料行 (方塊) 選取。 使用替代選取項目時，捷徑會變更，如下所示：

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

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

  1. 按下工作區右上方的使用者名稱，然後按下下拉式清單中的 [設定]。
  2. 在 [設定] 側邊欄中，選取 [開發人員]。
  3. 在 [程式碼編輯器] 區段中，將 [多重資料指標的密鑰修飾詞] 設定變更為適用於 MacOS 的 [Cmd] 或適用於 Windows 的 [Ctrl]。

當您啟用替代捷徑時，建立多個垂直對齊資料指標的鍵盤快速鍵不會變更。

括弧比對

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

顯示對應的括弧

版本歷程記錄中的並排 Diff

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

顯示程式碼 Diff

Python 錯誤醒目提示

當筆記本連線到叢集時，語法錯誤會以紅色底線標示。 對於 Python，叢集必須執行 Databricks Runtime 12.2 LTS 或更新版本。

將語法警告暫留，然後選取 [快速修正] 以取得可能的動作。

語法錯誤醒目提示的程式碼動作範例

已啟用 Databricks Assistant 的工作區也可選取 [使用助理修正]，以取得 AI 協助的建議。

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

  1. 按下工作區右上方的使用者名稱，然後按下下拉式清單中的 [設定]。
  2. 在 [設定] 側邊欄中，選取 [開發人員]。
  3. 在 [程式碼編輯器] 區段中，切換 [SQL 語法錯誤醒目提示] 或 [Python 語法錯誤醒目提示] 的設定。

Python 格式化醒目提示

Python 程式碼格式化錯誤和警告會以黃色底線標示。 將滑鼠停留在語法警告上方，查看詳細資訊。 叢集必須執行 Databricks Runtime 12.1 LTS 或更新版本。

要開啟格式化錯誤和警告：

  1. 按下工作區右上方的使用者名稱，然後按下下拉式清單中的 [設定]。
  2. 在 [設定] 側邊欄中，選取 [開發人員]。
  3. 在 [實驗性功能] 區段中，切換 [Python 格式錯誤醒目提示] 的設定