使用筆記本電腦

鍵盤快捷鍵

要顯示鍵盤快捷鍵，請選擇幫助>鍵盤快捷鍵．可用的鍵盤快捷鍵取決於光標是否在代碼單元格(編輯模式)中(命令模式)。

處理細胞

當您刪除單元格時，默認情況下會出現一個刪除確認對話框。若要禁用將來的確認對話框，請選擇不要再放一遍複選框,然後單擊確認．控件切換確認對話框設置打開命令刪除確認選項用戶設置．

創建、剪切、複製和粘貼單元格

若要創建新單元格，請將鼠標懸停在頂部或底部的單元格上並單擊圖標。您也可以使用筆記本單元格菜單:單擊並選擇添加細胞上麵或添加下麵的細胞．

有幾個選項可以剪切和複製單元格:

• 使用單元格操作菜單在單元格的右邊。點擊並選擇減少細胞或複製單元格．

• 使用鍵盤快捷鍵:Command-X或Ctrl-X削減和Command-C或ctrl - c複製。

• 使用編輯筆記本頂部的菜單。選擇減少或複製．

在您剪切或複製單元格之後，您可以將這些單元格粘貼到筆記本中的其他地方，粘貼到另一個筆記本中，或者粘貼到另一個瀏覽器選項卡或窗口中的筆記本中。要粘貼單元格，請使用鍵盤快捷鍵command (ctrl)加v鍵或ctrl - v．單元格被粘貼在當前單元格的下方。

你可以使用鍵盤快捷鍵Command-Z或ctrl - z撤銷剪切或粘貼操作。

• 單擊，剪切並粘貼單元格從單元格操作菜單中選擇減少細胞．然後,選擇粘貼上麵或粘貼下麵從另一個單元格的單元格操作菜單中。

  您可以使用恢複被切割的單元格編輯>撤銷剪切單元格．

• 要選擇相鄰的單元格，請單擊Markdown單元格，然後使用轉變+向上或下來以選擇其上方或下方的單元格。使用編輯菜單複製、剪切、粘貼或刪除所選單元格作為一個組。要選擇所有單元格，請選擇編輯>選擇所有單元格或者使用命令模式快捷方式Cmd +一個．

設置默認語言

筆記本的默認語言出現在筆記本名稱旁邊。

要更改默認語言，請單擊語言按鈕並從下拉菜單中選擇新語言。為了確保現有的命令能夠繼續工作，之前默認語言的命令會自動以語言魔法命令作為前綴。

混合語言

默認情況下，單元格使用筆記本的默認語言。您可以通過單擊語言按鈕並從下拉菜單中選擇一種語言來覆蓋單元格中的默認語言。

您也可以使用language magic命令% > <語言在細胞的開始。支持的magic命令有:% python，r %，% scala,%的sql．

筆記本還支持一些輔助魔法命令:

• % sh:允許您在筆記本中運行shell代碼。若要在shell命令有非零退出狀態時使單元失敗，請添加- e選擇。該命令隻在Apache Spark驅動程序上運行，而不是在worker上運行。若要在所有節點上運行shell命令，請使用init腳本．

• % fs:允許使用dbutils文件係統命令。例如，要運行dbutils.fs.ls命令列出可以指定的文件% fsls代替。有關更多信息，請參見如何處理數據庫上的文件．

• %醫學博士:允許您包含各種類型的文檔，包括文本、圖像、數學公式和方程。請參閱下一節。

使用Python本機探索Python筆記本中的SQL單元格結果

您可能希望使用SQL加載數據，並使用Python研究它。在Databricks Python筆記本中，SQL語言單元格的表結果會自動作為Python數據幀提供。Python數據幀的名稱是_sqldf．

請注意

• 在Python筆記本中，DataFrame_sqldf不會自動保存，而是替換為最近SQL單元格運行的結果。要保存DataFrame，請在Python單元格中運行以下代碼:

  new_dataframe_name＝_sqldf

• 如果查詢使用小部件對於參數化，結果不能作為Python DataFrame提供。

• 如果查詢使用關鍵字緩存表格或UNCACHE表格，結果不能作為Python DataFrame。

截圖顯示了一個例子:

文檔代碼

您可以通過選擇創建標記單元格來記錄代碼減價單元格的語言按鈕或使用%醫學博士神奇的命令。單元格的內容被渲染成HTML。例如，這個代碼片段包含一級標題的標記:

這是一個標題

它被渲染成一個HTML標題:

可折疊的標題

包含Markdown標題的單元格之後出現的單元格可以折疊成標題單元格。下麵的圖像顯示了一級標題稱為標題1隨著下麵兩個細胞的塌陷。

要展開和折疊標題，請單擊+而且-．

也看到隱藏和顯示單元格內容．

要在整個筆記本中展開或折疊包含減價標題的單元格之後的單元格，請選擇崩潰所有標題從視圖菜單。

% md < a href = " $。/myNotebook">Link to notebook in same folder as current notebook Link to folder in parent folder of current notebook Link to nested notebook

顯示圖像

來顯示存儲在FileStore，使用語法:

% md ! (測驗) (文件/ image.png）

例如，假設您在FileStore中有Databricks標誌圖像文件:

dbfs ls dbfs: / FileStore /

databricks-logo-mobile.png

當你在Markdown單元格中包含以下代碼時:

圖像在單元格中呈現:

顯示數學公式

筆記本電腦支持KaTeX用於顯示數學公式和方程。例如,

% md \ \ c = \ \ \ \下午√{b ^ ^ 2 + 2} \ \) \ \ b (a {_i} {_j} = {_i} {_j} \ \) $ $ c = \ \ \ \下午sqrt {b ^ ^ 2 + 2} $ $ \ \ [{_i} {_j} = b {_i} {_j} \ \]

顯示為:

而且

%md \\(f(\beta)= -Y_t^T X_t \beta + \sum log(1+{e}^{X_t \子彈\β})+ \壓裂{1}{2}\δt S_t ^ ^{1} \三角洲\ \)\ \(\δ=(β\ \ mu_ {t - 1}) \ \)

顯示為:

命令的評論

您可以使用命令注釋與協作者進行討論。

若要切換Comments側欄，請單擊評論在筆記本右上方的圖標。

向命令中添加注釋。

1. 突出顯示命令文本並單擊注釋氣泡:

   

2. 添加您的評論並單擊評論．

   

要編輯、刪除或回複評論，請單擊評論並選擇操作。

改變細胞顯示

筆記本電腦有三種顯示方式:

• 標準視圖:在代碼單元格之後立即顯示結果。

• 隻顯示結果:隻顯示結果。

• 並排:代碼和結果單元格並排顯示。

使用View菜單選擇一個顯示選項。

顯示行號和命令號

若要顯示或隱藏行號或命令號，請選擇行號或命令數量從視圖菜單。對於行號，也可以使用鍵盤快捷鍵控製+ L．

如果啟用行號或命令號，Databricks將保存您的首選項，並在該瀏覽器的所有其他筆記本中顯示它們。

單元格上方的命令編號鏈接到特定的命令。如果您單擊單元格的命令號，它將更新您的URL以錨定到該命令。如果要鏈接到筆記本中的特定命令，請右鍵單擊命令號並選擇複製鏈接地址．

查找並替換文本

要查找和替換筆記本中的文本，請選擇編輯>查找和替換．當前比賽用橙色突出顯示，所有其他比賽用黃色突出顯示。

單擊，替換當前匹配項取代．若要替換筆記本中的所有匹配項，請單擊替換所有．

要在匹配之間移動，請單擊上一頁而且下一個按鈕。你也可以按shift + enter而且輸入分別進入上一場和下一場比賽。

單擊，關閉查找並替換工具或按esc．

自動完成

您可以使用Databricks自動完成在您鍵入代碼段時自動完成它們。Databricks支持兩種類型的自動完成:本地和服務器。

本地自動補全將完成筆記本中定義的單詞。服務器自動完成訪問集群以獲得已定義的類型、類和對象，以及SQL數據庫和表名。要激活服務器自動完成，將你的筆記本連接到集群上而且運行所有細胞定義了可完成對象。

要觸發自動完成，按選項卡在輸入一個可完成的對象之後。的定義和運行單元格之後，例如MyClass而且實例的方法。實例是可完成的，並且當您按下時顯示有效的完成列表選項卡．

SQL數據庫和表名稱補全、類型補全、語法高亮顯示和SQL自動補全可在SQL單元格中使用，也可在Python命令中使用SQLspark.sql命令。

- - - - - - - - - - - -

在Databricks Runtime 7.4及以上版本中，您可以通過按一下鍵來顯示Python文檔字符串提示Shift + Tab在輸入一個完整的Python對象之後。文檔字符串包含與幫助()函數。

SQL格式

Databricks提供工具，允許您快速、輕鬆地格式化筆記本單元格中的SQL代碼。這些工具減少了保持代碼格式的工作，並有助於在筆記本電腦中強製執行相同的編碼標準。

可以通過以下方式觸發格式化程序:

• 單個細胞

  • 鍵盤快捷鍵:按下Cmd + Shift + F．

  • 命令上下文菜單:選擇SQL格式在SQL單元的命令上下文下拉菜單中。此項僅在SQL筆記本單元格和帶有%的sql語言的魔力．

    

• 多個單元

  選擇多個SQL細胞然後選擇編輯>格式化SQL單元格．如果選擇超過一種語言的單元格，則隻格式化SQL單元格。這包括那些使用%的sql．

  

這是前麵例子中格式化後的第一個單元格:

查看目錄

要顯示自動生成的目錄，單擊筆記本左上角的箭頭(在側邊欄和最上麵的單元格之間)。目錄是由筆記本中使用的減價標題生成的。

要關閉目錄，請單擊朝左的箭頭。

在暗模式查看筆記本

您可以選擇在暗模式下顯示筆記本。要打開或關閉暗模式，請選擇視圖>主題並選擇光的主題或黑暗的主題．

把一個筆記本附在集群上

要將筆記本附加到集群，您需要是否可以附加到集群級別的權限．

把筆記本附在…上集群，單擊記事本工具欄中的集群選擇器，並從下拉菜單中選擇一個集群。該菜單顯示了您最近使用過或當前正在運行的集群的選擇。

單擊可從所有可用的集群中進行選擇更多…並從對話框中的下拉菜單中選擇一個現有的集群。

你也可以創建一個新的集群通過選擇創建新的資源……從下拉菜單。

從集群中分離一個筆記本

要將筆記本與集群分離，請單擊筆記本工具欄中的集群選擇器，並將鼠標懸停在列表中附加的集群上以顯示側邊菜單。從側邊菜單中選擇分離．

方法還可以將筆記本從集群中分離筆記本電腦頁簽。

將筆記本從集群中分離時，會出現執行上下文移除，所有計算的變量值將從筆記本中清除。

查看每個單元格的多個輸出

Python筆記本和% python非python筆記本中的單元格支持每個單元格的多個輸出。例如，以下代碼的輸出包括圖表和表格:

進口熊貓作為pd從sklearn.datasets進口load_iris數據＝load_iris（）虹膜＝pd．DataFrame（數據＝數據．數據，列＝數據．feature_names）斧頭＝虹膜．情節（）打印（“陰謀”）顯示（斧頭）打印（“數據”）顯示（虹膜）

在Databricks Runtime 7.3 LTS中，必須通過設置啟用此特性spark.databricks.workspace.multipleResults.enabled真正的．

Python和Scala錯誤突出顯示

Python和Scala筆記本支持錯誤高亮顯示。拋出錯誤的代碼行在單元格中突出顯示。此外，如果錯誤輸出是堆棧跟蹤，拋出錯誤的單元格將作為到該單元格的鏈接顯示在堆棧跟蹤中。您可以單擊此鏈接跳到有問題的代碼。

通知

通知向您提醒某些事件，例如當前正在運行哪個命令筆記本電腦運行以及哪些命令處於錯誤狀態。當你的筆記本顯示多個錯誤通知時，第一個通知將有一個鏈接，允許你清除所有通知。

筆記本通知默認是啟用的。您可以禁用它們用戶設置．

磚顧問

Databricks Advisor在每次運行命令時自動分析命令，並在筆記本中顯示適當的建議。通知通知提供的信息可以幫助您改進工作負載的性能、降低成本和避免常見錯誤。

視圖的建議

帶有燈泡圖標的藍色方框表示可以為命令提供通知。該框顯示了不同建議的數量。

單擊燈泡以展開方框並查看通知。一個或多個建議將變得可見。

單擊了解更多鏈接到查看提供與通知相關的更多信息的文檔。

單擊別再給我看這個了鏈接隱藏這條建議。此類型的通知將不再顯示。此操作可以是筆記本設置反轉．

再次單擊燈泡以折疊通知框。

建議設置

要啟用或禁用Databricks Advisor，請轉到用戶設置或者單擊展開的建議框中的齒輪圖標。

切換的打開Databricks Advisor選項啟用或禁用通知。

的重置隱藏的建議如果當前隱藏了一個或多個通知類型，則顯示Link。單擊該鏈接可使通知類型再次可見。

使用運行%導入筆記本電腦

的運行%Magic執行來自另一個筆記本的所有命令。一個典型的用法是在一個筆記本中定義輔助函數，供其他筆記本使用。

在下麵的例子中，第一個notebook定義了一個helper函數，反向，它可在使用運行%神奇的執行shared-code-notebook．

因為這兩個筆記本都在工作區中的同一個目錄中，所以使用前綴．/在。/ shared-code-notebook指示路徑應相對於當前運行的筆記本進行解析。您可以將筆記本組織到目錄中，例如運行%/ dir /筆記本，或者使用絕對路徑，如運行%/用戶/ username@organization.com/directory/notebook．

使用git引用源代碼文件

用於存儲在數據庫中的筆記本回購，您可以在存儲庫中引用源代碼文件。下麵的示例使用Python文件而不是筆記本。

創建一個新的repo示例來顯示文件布局:

要配置現有的Git存儲庫，請參見克隆遠程Git存儲庫．

在repo中創建兩個文件:

1. 帶有共享代碼的Python文件。

2. 使用共享Python代碼的筆記本。

Python文件shared.py包含了助手。

現在，當您打開筆記本時，您可以在存儲庫中使用常用的命令引用源代碼文件，例如進口．

有關在Git存儲庫中使用文件的更多信息，請參見處理UI中的文件．

清除筆記本狀態和輸出

要清除筆記本狀態和輸出，請選擇清晰的選項的底部運行菜單。

顯示結果

當一個單元格運行時，Databricks返回1000行數據幀。在Databricks Runtime 8.4及以上版本中，如果有超過1000行，您可以重新執行查詢，以顯示最多10,000行。

下載結果

默認情況下，下載結果是啟用的。要切換此設置，請參見管理從筆記本上下載結果的能力．

可以將包含表格輸出的單元格結果下載到本地計算機。單擊選項卡標題旁邊的三個按鈕菜單。菜單選項取決於結果中的行數和Databricks Runtime版本。下載的結果以CSV文件的形式保存在本地計算機上export.csv．

隱藏和顯示單元格內容

單元格內容由單元格代碼和運行單元格的結果組成。您可以使用單元格操作菜單隱藏和顯示單元格代碼和結果在單元格的右上角。

隱藏單元格代碼:

• 點擊並選擇隱藏代碼

要隱藏並顯示單元格結果，請執行以下任一操作:

• 點擊並選擇隱藏的結果

• 選擇

• 類型Esc > Shift + o

要顯示隱藏的單元格代碼或結果，請單擊顯示鏈接:

另請參閱可折疊的標題．

筆記本隔離

筆記本隔離指的是筆記本之間變量和類的可見性。Databricks支持兩種類型的隔離:

• 變量和類的隔離

• 火花會話隔離

添加一個評論

向最新版本添加注釋。

1. 單擊版本。

2. 點擊保存現在．

   

3. 在Save Notebook Revision對話框中，輸入注釋。

4. 點擊保存．筆記本版本與輸入的注釋一起保存。

恢複一個版本

恢複一個版本。

1. 單擊版本。

2. 點擊恢複這個修改．

   

3. 點擊確認．所選版本將成為筆記本的最新版本。

刪除一個版本

刪除筆記本的版本條目。

1. 單擊版本。

2. 點擊垃圾圖標．

   

3. 點擊是的,抹去．所選版本將從曆史記錄中刪除。

明確的版本曆史

清除筆記本電腦的版本曆史記錄。

1. 選擇文件>清除版本曆史記錄．

2. 點擊是的,清楚．清除筆記本版本曆史記錄。

   警告

   版本曆史記錄被清除後將無法恢複。

將測試代碼從筆記本中分離出來

要將測試代碼與被測試代碼分離，請參見在筆記本上分享代碼．

使用一個例子運行%：

對象中存儲的代碼磚回購，您可以使用web終端在源代碼文件中運行測試，就像在本地計算機上運行測試一樣。

您也可以在筆記本上運行這個測試。

對於筆記本電腦磚回購，您可以通過配置為每次提交運行筆記本測試來設置CI/ cd風格的工作流。看到磚GitHub的行動．