Databricks 筆記本介面和控件

筆記本工具列包含可用來管理和編輯筆記本的功能表和圖示。

筆記本名稱旁邊是可讓您變更筆記本默認語言的按鈕，如果筆記本包含在 Databricks Git 資料夾中，請開啟 [Git] 對話方塊。

若要檢視 舊版 的筆記本，請按兩下 [上次編輯...] 功能單右側的訊息。

更新的儲存格設計

重要

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

有更新的儲存格設計可供使用。 此頁面包含如何使用這兩個數據格設計版本的相關信息。 如需新UI的方向和常見問題的解答，請參閱 新儲存格 UI 的方向。

若要啟用或停用新的數據格設計，請在工作區中開啟 編輯器設定 頁面。 在提要欄位中，按兩下 [ 開發人員]。 在 [實驗性功能] 下，切換 [新增數據格 UI]。

筆記本單元格

筆記本包含兩種儲存格類型的集合：程式代碼儲存格和 Markdown 儲存格。 程式代碼儲存格包含可執行的程式代碼。 Markdown 儲存格包含 Markdown 程式代碼，可在執行儲存格時轉譯成文字和圖形，並可用來記載或說明您的程式代碼。 您可以將儲存格新增或移除至筆記本，以建構您的工作。

您可以執行單一儲存格、一組儲存格，或一次執行整個筆記本。 筆記本數據格最多可以包含 10MB。 筆記本數據格輸出限制為 20 MB。

筆記本工具列圖示和按鈕

下表說明工具列右側的圖示和按鈕：

Icon	描述
	執行所有儲存格或停止執行。 此按鈕的名稱會根據筆記本的狀態而變更。
	開啟 計算選取器。 當筆記本連線到叢集或 SQL 倉儲時，此按鈕會顯示計算資源的名稱。
	開啟 作業排程器。
	開啟 Delta Live Tables。 只有當筆記本是 Delta Live Tables 管線的一部分時，才會顯示此按鈕。
	開啟 許可權對話框。

右側提要欄位動作

您可以從筆記本的右側提要字段取得數個動作，如下表所述：

Icon	描述
	開啟 筆記本批注。
	開啟 MLflow Notebook 實驗。
	開啟 筆記本版本歷程記錄。
	開啟 變數總管。 （適用於具有 Databricks Runtime 12.2 LTS 和更新版本之 Python 變數。
	開啟 [Python 環境] 面板。 此面板會顯示筆記本可用的所有 Python 連結庫，包括 Databricks Runtime 中包含的筆記本範圍連結庫、叢集連結庫和連結庫。 只有在筆記本連結至叢集時才能使用。

瀏覽數據

重要

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

若要探索筆記本中可用的數據表和磁碟區，請按下 筆記本左側以開啟架構瀏覽器。 如需詳細資訊，請參閱 瀏覽數據 。

單元格動作功能表

單元格動作功能表可讓您剪下和複製儲存格、在筆記本中移動儲存格，以及隱藏程式代碼或結果。 功能表在原始UI和新的UI中有不同的外觀。 本節包含這兩個版本的指示。

如果您的工作區中已啟用 Databricks Assistant，您可以在程式代碼數據格中使用它來取得程式碼的說明或建議。 若要在單元格中開啟 Databricks Assistant 文本框，請按兩下單元格右上角的 Databricks 小幫手圖示 。

您可以使用儲存格右上角附近的儲存格語言按鈕，輕鬆地變更程式碼儲存格與 Markdown 之間的儲存格，或變更程式碼單元格的語言。

儲存格動作選單 （原始 UI）

您也可以從此選單中執行程式碼資料格：

單元格動作功能表也包含可讓您隱藏儲存格或刪除儲存格 的按鈕。

針對 Markdown 儲存格，也有一個選項可將儲存格新增至儀錶板。 如需詳細資訊，請參閱 筆記本中的儀錶板。

使用新UI中的儲存格

下列螢幕快照說明筆記本數據格右上角顯示的圖示：

語言選取器： 選取儲存格的語言。

Databricks 小幫手： 針對數據格中的程式代碼建議啟用或停用 Databricks Assistant。

單元格焦點： 放大儲存格以方便編輯。

顯示儲存格動作選單： 開啟儲存格動作功能表。 此功能表中的選項對於程式碼和 Markdown 單元格稍有不同。

若要在新 UI 中執行程式代碼資料格，請按下程式代碼資料格左上角的向下箭號。

執行單元格之後，單元格執行功能表右側會出現一個通知，其中顯示上次執行單元格的時間和執行持續時間。 將游標暫留在通知上方以取得詳細數據。

若要將 Markdown 單元格或具有表格式結果的儲存格新增至儀錶板，請從數據格動作選取 [新增至儀錶板 ]。 如需詳細資訊，請參閱 筆記本中的儀錶板。

若要刪除儲存格，請按兩下單元格右邊的垃圾桶圖示。 只有當您將游標暫留在儲存格上方時，才會顯示此圖示。

若要將批註新增至儲存格中的程式碼，請反白顯示程式代碼。 單元格右側會出現批註圖示。 按兩下圖示以開啟批註方塊。

若要向上或向下移動儲存格，請按單下儲存格左上角並按住 ，並將儲存格拖曳至新位置。 您也可以從儲存格動作選單選取 [上 移] 或 [下 移]。

建立儲存格

筆記本有兩種類型的單元格：程序代碼和 Markdown。 Markdown 單元格的內容會轉譯成 HTML。 例如，此代碼段包含層級一標題的標記：

%md ### Libraries
Import the necessary libraries.

呈現方式如下：

建立儲存格 （原始 UI）

若要在原始 UI 中建立新的儲存格，請將滑鼠停留在頂端或底部的儲存格上，然後按下 圖示。 您也可以使用筆記本儲存格選單：單擊並選取 [在上方新增儲存格] 或 [在下方新增儲存格]。

針對程式代碼數據格，只要在數據格中輸入程式代碼即可。 若要建立 Markdown 單元格，請從單元格的語言按鈕選取 Markdown，或輸入%md儲存格頂端的 Markdown。

建立儲存格 （新 UI）

若要在新UI中建立新的儲存格，請將滑鼠停留在頂端或底部的儲存格上。 按兩下 [程序代碼] 或 [文字]，分別建立程式代碼或 Markdown 單元格。

剪下、複製和貼上儲存格

有數個選項可以剪下和複製儲存格。 如果您使用Safari瀏覽器，則只有鍵盤快捷方式可供使用。

• 從原始 UI 或新 UI 的儲存格動作選單中，選取 [剪下儲存格] 或 [複製儲存格]。
• 使用鍵盤快捷方式： Command-X 或 Ctrl-X 剪下 和 或 Command-CCtrl-C 複製。
• 使用筆記本頂端的 [ 編輯 ] 功能表。 選取 [剪下] 或 [複製]。

剪下或複製儲存格之後，您可以將這些儲存格貼到筆記本中的其他地方、不同的筆記本，或貼到不同瀏覽器索引標籤或視窗中的筆記本中。 若要貼上儲存格，請使用鍵盤快捷方式 Command-V 或 Ctrl-V。 單元格會貼在目前儲存格下方。

若要復原剪下或貼上動作，您可以使用鍵盤快捷方式Command-Z或功能表選項 [編輯>復原剪下單元格] 或 [編輯>復原貼上單元格Ctrl-Z]。

若要選取相鄰的數據格，請按下 Markdown 單元格，然後使用 Shift + Up 或 Down 來選取其上方或下方的儲存格。 使用編輯功能表，將選取的儲存格複製、剪下、貼上或刪除為群組。 若要選取所有儲存格，請選取 [ 編輯 > 選取所有儲存格 ]，或使用命令模式快捷方式 Cmd+A。

筆記本目錄

若要顯示自動產生的目錄，請按下筆記本左上方的圖示（在左側提要欄和最上層的單元格之間）。 目錄是從筆記本中使用的 Markdown 標題產生。 如果您使用新的UI，具有標題的儲存格也會出現在目錄中。

單元格顯示選項

筆記本有三個顯示選項。 使用 [ 檢視 ] 功能表來變更顯示選項。

• 標準檢視：結果會在程式碼儲存格之後立即顯示。
• 僅限結果：只會顯示結果。
• 並存：程式代碼和結果數據格會並排顯示。

在新的UI中，動作可從儲存格溝中的圖示取得（儲存格右側和左方的區域）。 例如，若要向上或向下移動儲存格，請使用左排水溝中的夾點 。 若要刪除儲存格，請使用右排水溝中的垃圾桶圖示。

若要更容易編輯，請按兩下焦點模式圖示 ，以全角顯示儲存格。 若要結束焦點模式，請按下 。 您也可以關閉 [檢視 > 中心版面配置] 來放大儲存格的顯示寬度。

若要將筆記本中的所有儲存格自動格式化為業界標準行長度和間距，請選取[ 編輯 > 格式筆記本]。

行號和命令行號碼

若要顯示或隱藏行號或命令行號碼，請從 [檢視] 功能選取 [行號] 或 [命令編號]。 對於行號，您也可以使用鍵盤快捷方式 Control+L。

如果您啟用行或命令行號碼，Databricks 會儲存您的喜好設定，並在該瀏覽器的其他所有筆記本中顯示它們。

列和命令列號碼（原始 UI）

單元格上方的命令編號會連結到該特定命令。 如果您按下儲存格的命令編號，它會更新 URL 以錨定至該命令。 若要取得筆記本中特定命令的 URL 連結，請以滑鼠右鍵按下命令編號，然後選擇 [ 複製連結位址]。

行號和命令列號碼（新 UI）

新UI中預設會關閉行號。 若要開啟它們，請選取 [ 檢視 > 行號]。 當儲存格處於錯誤狀態時，不論選取項目為何，都會顯示行號。

若要切換命令編號，請選取 [ 檢視 > 命令編號]。

新的UI不包含儲存格命令編號連結。 若要取得筆記本中特定命令的 URL 連結，請按下 以開啟焦點模式，然後從瀏覽器網址列複製 URL。 若要結束焦點模式，請按下 。

新增儲存格標題

若要使用原始 UI 將標題新增至儲存格，請從儲存格動作選取 [顯示標題]。

若要使用新的 UI 將標題新增至儲存格，請執行下列其中一項動作：

• 按兩下儲存格頂端中央顯示的儲存格編號，然後輸入標題。
• 從儲存格動作選取 [新增標題]。

有了新的UI，具有標題的單元格會出現在 筆記本的目錄中。

以深色模式檢視筆記本

您可以選擇以深色模式顯示筆記本。 若要開啟或關閉深色模式，請選取 [檢視>主題]，然後選取 [淺色主題] 或 [深色主題]。

隱藏和顯示儲存格內容

單元格內容包含數據格程序代碼，以及執行數據格所產生的結果。 您可以使用儲存格右上角的儲存格動作選單來隱藏和顯示儲存格程式代碼和結果。

如需相關功能，請參閱 可折迭標題。

隱藏與顯示儲存格內容 （原始 UI）

若要隱藏儲存格程式代碼或結果，請按下並選取 [隱藏程式碼] 或 [隱藏結果]。 您也可以選取 只顯示儲存格的第一行。

若要顯示隱藏的儲存格程式代碼或結果，請按下 [ 顯示 連結]：

隱藏與顯示儲存格內容 （新 UI）

若要隱藏儲存格程式代碼或結果，請單擊單元格右上角的Kebab功能表，然後選取 [隱藏程式碼] 或 [隱藏結果]。 您也可以選取 [折迭] 儲存格 ，只顯示儲存格的第一行。 若要展開折疊的儲存格，請選取 [展開儲存格]。

若要顯示隱藏的儲存格程式代碼或結果，請按下顯示圖示： 。

可折迭標題

在包含 Markdown 標題的儲存格之後出現的儲存格可以折疊成標題儲存格。 若要在筆記本中包含 Markdown 標題的儲存格之後展開或折疊儲存格，請從 [檢視] 選單選取 [折疊所有標題]。 本節的其餘部分說明如何展開或折疊單元格的子集。

如需相關功能，請參閱 隱藏和顯示儲存格內容。

展開與折疊標題 （原始 UI）

此影像顯示具有下列兩個儲存格的層級 2 標題 MLflow 設定 ，並折疊到其中。

若要展開和折疊標題，請按下 + 和 -。

展開與折疊標題 （新 UI）

此影像顯示具有下列兩個儲存格的層級 2 標題 MLflow 設定 ，並折疊到其中。

若要展開和折迭標題，請將游標暫留在 Markdown 單元格上方。 按兩下顯示在儲存格左邊的箭號。

筆記本的計算資源

本節涵蓋筆記本計算資源的選項。 您可以在 Databricks 叢集上執行筆記本，或針對 SQL 命令，您也可以選擇使用 SQL 倉儲，這是針對 SQL 分析優化的計算類型。

將筆記本附加至叢集

若要將筆記本附加至叢集，您需要 CAN ATTACH TO 叢集層級許可權。

重要

只要筆記本附加至叢集，任何具有 Notebook 上 CAN RUN 許可權的使用者都有存取叢集的隱含許可權。

若要將筆記本附加至 叢集，請單擊 筆記本工具列 中的計算選取器，然後從下拉功能表中選取叢集。

功能表會顯示您最近使用或目前正在執行的叢集選取專案。

若要從所有可用的叢集選取，請按兩下 [ 更多...]。 單擊叢集名稱以顯示下拉功能表，然後選取現有的叢集。

您也可以從下拉功能表中選取 [建立新資源...]，以建立新的叢集。

重要

附加的筆記本已定義下列 Apache Spark 變數。

類別	變數名稱
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession （Spark 2.x）	spark

請勿建立 SparkSession、 SparkContext或 SQLContext。 這樣做會導致行為不一致。

搭配 SQL 倉儲使用筆記本

當筆記本附加至 SQL 倉儲時，您可以執行 SQL 和 Markdown 數據格。 如果您以任何其他語言執行單元格（例如 Python 或 R），則會擲回錯誤。 在 SQL 倉儲上執行的 SQL 數據格會出現在 SQL 倉儲的查詢歷程記錄中。 執行查詢的使用者可以 按下輸出底部的經過時間，從筆記本檢視查詢配置檔 。

執行筆記本需要 Pro 或無伺服器 SQL 倉儲。 您必須能夠存取工作區和 SQL 倉儲。

若要將筆記本附加至 SQL 倉儲 ，請執行下列動作：

1. 按下筆記本工具列中的計算選取器。 下拉功能表會顯示目前正在執行的計算資源，或您最近使用的資源。 SQL 倉儲會標示為 。

2. 從功能表中，選取 SQL 倉儲。

   若要查看所有可用的 SQL 倉儲，請從下拉功能表中選取 [更多... ]。 隨即出現一個對話框，其中顯示筆記本可用的計算資源。 選取 [SQL 倉儲]，選擇您想要使用的倉儲，然後按兩下 [ 附加]。

   

您也可以在建立工作流程或排程作業時，選取 SQL 倉儲作為 SQL 筆記本的計算資源。

SQL 倉儲限制

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

中斷鏈接筆記本

若要將筆記本與計算資源中斷連結，請按下筆記本工具列中的計算選取器，並將滑鼠停留在清單中的附加叢集或 SQL 倉儲上，以顯示側邊功能表。 從側邊功能表中，選取 [ 中斷連結]。

您也可以使用叢集詳細數據頁面上的 [Notebook] 索引卷標，從叢集中斷鏈接筆記本。

當您中斷鏈接筆記本時，會 移除執行內容 ，並從筆記本清除所有計算變數值。

提示

Azure Databricks 建議您將未使用的筆記本與叢集中斷連結。 這會釋放驅動程式上的記憶體空間。

使用 Web 終端機和 Databricks CLI

若要在筆記本中開啟 Web 終端機，請按下 右側提要欄位底部的 。

在 Web 終端機中使用 Databricks CLI

從 Databricks Runtime 15.0 開始，您可以從筆記本中的 Web 終端機使用 Databricks CLI。

需求

• 筆記本必須附加至單一使用者或無隔離共用存取模式的叢集。
• 在啟用 Private Link 的工作區中無法使用 CLI。

已安裝的 CLI 一律為最新版本。 驗證是以目前的用戶為基礎。

您無法從筆記本數據格使用 CLI。 筆記本中的命令 %sh databricks ... 不適用於 Databricks Runtime 15.0 或更新版本。