本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 Athena 筆記本編輯器
您可以在 Athena 筆記本瀏覽器中管理筆記本,並使用 Athena 筆記本編輯器在工作階段中進行編輯和執行。您可以根據您的需求,設定筆記本工作階段的 DPU 使用情況。
當您停止筆記本時,您會終止相關的工作階段。所有檔案均已儲存,但宣告的變數、函數和類別中正在進行的變更會遺失。當您重新啟動筆記本時,Athena 會重新載入筆記本檔案,並且您可以再次執行程式碼。
Athena 筆記本編輯器是一種用於編寫和執行程式碼的互動式環境。以下章節描述環境的功能。
了解筆記本工作階段和計算
每個筆記本都與單一 Python 核心相關聯,並會執行 Python 程式碼。筆記本可具有一或多個包含命令的儲存格。若要執行筆記本中的儲存格,您必須先為筆記本建立工作階段。工作階段會追蹤變數和筆記本的狀態。
在筆記本中執行儲存格表示在目前工作階段中執行計算。計算會追蹤筆記本的進度狀態,並且可能執行從 Amazon S3 讀取或寫入其他資料存放區等任務。只要工作階段在執行中,計算就會使用並修改為筆記本維護的狀態。
當您不再需要狀態時,可以結束工作階段。當您結束工作階段時,筆記本會保留,但變數和其他狀態資訊會被銷毀。如果您需要同時處理多個專案,則可以為每個專案建立一個工作階段,並且工作階段將彼此獨立。
工作階段具有專屬運算容量,以 DPU 為單位。建立工作階段時,您可以指派工作階段數個 DPU。根據任務的需求,不同的工作階段可以具有不同的容量。
在命令模式和編輯模式之間切換
筆記本編輯器具有一個模式使用者介面:用於將文字輸入到儲存格的編輯模式,以及用於向編輯器本身發出命令的命令模式,例如複製、粘貼或執行。
若要使用編輯模式和命令模式,您可以執行下列任務:
-
若要進入編輯模式,請按下
ENTER
,或選擇儲存格。當儲存格處於編輯模式時,儲存格會有一個綠色的左邊界。 -
若要進入命令模式,請按下
ESC
,或按一下儲存格外側。請注意,命令通常僅適用於當前選定的儲存格,而不適用於所有儲存格。當編輯器處於命令模式時,儲存格會有一個藍色的左邊界。 -
在命令模式中,您可以使用鍵盤快速鍵和編輯器上方的選單,但不能在個別儲存格中輸入文字。
-
若要選取儲存格,請選擇儲存格。
-
若要選取所有儲存格,請按下
Ctrl+A
(Windows) 或Cmd+A
(Mac)
在筆記本編輯器選單中使用動作
筆記本編輯器頂端選單中的圖示提供以下選項:
-
Save (儲存) – 儲存筆記本的目前狀態。
-
Insert cell below (在下方插入儲存格) – 在目前選取的儲存格下方新增新的 (空的) 儲存格。
-
Cut selected cells (剪下選取的儲存格) – 從其目前位置移除選取的儲存格,並將儲存格複製到記憶體。
-
Copy selected cells (複製選取的儲存格) – 將選取的儲存格複製到記憶體。
-
Paste cells below (在下方貼上儲存格) – 在目前儲存格下方貼上複製的儲存格。
-
Move selected cells up (上移選取的儲存格) – 將目前儲存格移至上方儲存格的上方。
-
Move selected cells up (下移選取的儲存格) – 將目前儲存格移至下方儲存格的下方。
-
Run (執行) – 執行目前 (選取的) 儲存格。輸出會立即顯示在目前儲存格的下方。
-
Run all (執行所有) – 執行筆記本中的所有儲存格。每個儲存格的輸出會立即顯示在儲存格的下方。
-
Stop (Interrupt the kernel) (停止 (中斷核心)) – 透過中斷核心來停止目前的筆記本。
-
Format option (格式選項) – 選取儲存格格式,且格式可以是下列其中一種:
-
Code (程式碼) – 用於 Python 程式碼 (預設值)。
-
Markdown – 用於以 GitHub-style markdown
格式輸入文字。若要轉譯 Markdown,請執行儲存格。 -
Raw NBConvert – 用於以未經修改的形式輸入文字。標記為 Raw NBConvert 的儲存格可透過 Jupyter nbconvert
命令列工具轉換成不同的格式,例如 HTML。
-
-
Heading (標題) – 用於變更儲存格的標題層級。
-
Command palette (命令面板) – 包含 Jupyter 筆記本命令及其鍵盤快速鍵。如需有關鍵盤快速鍵的詳細資訊,請參閱本文件稍後的章節。
使用命令模式鍵盤快速鍵來提高生產力
以下是筆記本編輯器命令模式鍵盤快速鍵。按下 ESC
進入命令模式後,即可使用這些快速鍵。若要檢視編輯器中可用命令的完整清單,請按下 ESC +
H
。
金錀 | 動作 |
---|---|
1 - 6 |
將儲存格類型變更為 Markdown 並將標題層級設定為鍵入的數字 |
a |
在目前儲存格上方建立儲存格 |
b |
在目前儲存格下方建立儲存格 |
c |
將目前儲存格複製到記憶體 |
d d |
刪除目前儲存格 |
h |
顯示鍵盤快速鍵協助畫面 |
j |
向下移一個儲存格 |
k |
向上移一個儲存格 |
m |
將目前儲存格格式變更為 Markdown |
r |
將目前儲存格格式變更為 Raw |
s |
儲存筆記本 |
v |
在目前儲存格下方貼上記憶體內容 |
x |
剪下選取的一或多個儲存格 |
y |
將儲存格格式變更為程式碼 |
z |
Undo (復原) |
Ctrl+Enter |
執行目前儲存格並輸入命令模式 |
Shift+Enter 或 Alt+Enter |
執行目前儲存格並在輸出下方建立新的儲存格,然後在編輯模式下輸入新的儲存格 |
Space |
向下翻頁 |
Shift+Space |
向上翻頁 |
Shift + L |
切換儲存格中行號的可見度 |
自訂命令模式捷徑
筆記本編輯器提供自訂命令模式鍵盤快速鍵的選項。
若要編輯命令模式快速鍵
-
從筆記本編輯器選單中,選擇 Command palette (命令面板)。
-
從命令面板中,選擇 Edit command mode keyboard shortcuts (編輯命令模式鍵盤快速鍵) 命令。
-
使用 Edit command mode shortcuts (編輯命令模式快速鍵) 介面可將您想要的命令映射或重新映射至鍵盤。
若要查看編輯命令模式快速鍵的指示,請捲動到 Edit command mode shortcuts (編輯命令模式快速鍵) 畫面的底部。
如需有關在 Athena for Apache Spark 中使用魔術命令的資訊,請參閱 使用魔術命令。