使用 Athena 筆記本編輯器 - Amazon Athena

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 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 筆記本命令及其鍵盤快速鍵。如需有關鍵盤快速鍵的詳細資訊,請參閱本文件稍後的章節。

  • Session (工作階段) – 使用此選單中的選項來檢視工作階段的詳細資訊、編輯工作階段參數終止工作階段。

使用命令模式鍵盤快速鍵來提高生產力

以下是筆記本編輯器命令模式鍵盤快速鍵。按下 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+EnterAlt+Enter 執行目前儲存格並在輸出下方建立新的儲存格,然後在編輯模式下輸入新的儲存格
Space 向下翻頁
Shift+Space 向上翻頁
Shift + L 切換儲存格中行號的可見度

自訂命令模式捷徑

筆記本編輯器提供自訂命令模式鍵盤快速鍵的選項。

若要編輯命令模式快速鍵
  1. 從筆記本編輯器選單中,選擇 Command palette (命令面板)。

  2. 從命令面板中,選擇 Edit command mode keyboard shortcuts (編輯命令模式鍵盤快速鍵) 命令。

  3. 使用 Edit command mode shortcuts (編輯命令模式快速鍵) 介面可將您想要的命令映射或重新映射至鍵盤。

    若要查看編輯命令模式快速鍵的指示,請捲動到 Edit command mode shortcuts (編輯命令模式快速鍵) 畫面的底部。

如需有關在 Athena for Apache Spark 中使用魔術命令的資訊,請參閱 使用魔術命令