# 使用 Athena 笔记本编辑器
<a name="notebooks-spark-editor"></a>

**注意**  
Pyspark 引擎版本 3 支持 Athena 笔记本编辑器。要将笔记本与 Apache Spark 版本 3.5 搭配使用，请参阅 [SageMaker Notebooks](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/what-is-sagemaker-unified-studio.html)。

您可以在 Athena 笔记本资源管理器中管理笔记本，并使用 Athena 笔记本编辑器在会话中对其进行编辑和运行。您可以根据要求为笔记本会话配置 DPU 使用情况。

当您停止笔记本时，即会终止关联会话。将保存所有文件，但声明的变量、函数和类中正在进行的更改会丢失。重新启动笔记本后，Athena 会重新加载笔记本文件，您可以再次运行代码。

Athena 笔记本编辑器是一个用于编写和运行代码的交互式环境。以下各节介绍该环境的各项功能。

## 了解笔记本会话和计算
<a name="notebooks-spark-sessions-and-calculations"></a>

每个笔记本都与一个 Python 内核相关联并运行 Python 代码。笔记本可以有一个或多个包含命令的单元格。要运行笔记本中的单元格，首先要为笔记本创建会话。会话会跟踪笔记本的变量和状态。

运行笔记本中的单元格意味着运行当前会话中的计算。计算会推进笔记本的状态，并且可能执行诸如从 Amazon S3 读取或写入其他数据存储等任务。只要会话在运行，计算就会使用和修改为笔记本维护的状态。

如果不再需要状态，可以结束会话。结束会话后，笔记本会保留，但变量和其他状态信息会销毁。如果您需要同时处理多个项目，可以为每个项目创建一个会话，这些会话相互独立。

会话具有专用的计算容量，以 DPU 为单位。创建会话时，可以为会话分配多个 DPU。不同的会话可能具有不同的功能，具体取决于任务的要求。

## 在命令模式和编辑模式之间切换
<a name="notebooks-spark-command-mode-vs-edit-mode"></a>

笔记本编辑器具有模态用户界面：一种用于在单元格中输入文本的编辑模式，以及一种用于向编辑器本身发出命令（例如复制、粘贴或运行）的命令模式。

要使用编辑模式和命令模式，您可以执行以下任务：
+ 要进入编辑模式，请按 **ENTER** 或选择一个单元格。当单元格处于编辑模式时，单元格的左边距为绿色。
+ 要进入命令模式，请按 **ESC**，或在单元格以外的位置单击。请注意，命令通常仅适用于当前选定的单元格，而不适用于所有单元格。当编辑器处于命令模式时，单元格的左边距为蓝色。
+ 在命令模式下，您可以使用键盘快捷键和编辑器上方的菜单，但不能在单个单元格中输入文本。
+ 要选择单元格，请选择该单元格。
+ 要选择所有单元格，请按 **Ctrl\+A**（Windows）或 **Cmd\+A**（Mac）。

## 使用笔记本编辑器菜单中的操作
<a name="notebooks-spark-notebook-editor-menu"></a>

笔记本编辑器顶部菜单中的图标提供以下选项：
+ **保存** – 保存笔记本的当前状态。
+ **在下方插入单元格** – 在当前选定的单元格下方添加一个新的（空）单元格。
+ **剪切所选单元格** – 将选定单元格从其当前位置移除并将其复制到内存。
+ **复制所选单元格** – 将所选单元格复制到内存。
+ **在下方粘贴单元格** – 将复制的单元格粘贴到当前单元格下方。
+ **向上移动所选单元格** – 将当前单元格移至上方单元格上方。
+ **向下移动所选单元格** – 将当前单元格移至下方单元格下方。
+ **运行** – 运行当前（选定的）单元格。输出将立即在当前单元格下方显示。
+ **全部运行** – 运行笔记本中的所有单元格。每个单元格的输出将立即在单元格下方显示。
+ **停止（中断内核）** – 通过中断内核来停止当前笔记本。
+ **格式选项** – 选择单元格格式，可以是以下格式之一：
  + **代码** – 用于 Python 代码（默认）。
  + **Markdown** – 用于以 [GitHub 风格的 markdown](https://docs.github.com/en/get-started/writing-on-github) 格式输入文本。运行单元格以渲染 markdown。
  + **Raw NBConvert** – 用于以未修改的格式输入文本。标记为 **Raw NBConvert** 的单元格可通过 Jupyter [nbconvert](https://nbconvert.readthedocs.io/en/latest/usage.html) 命令行工具转换为其他格式，例如 HTML。
+ **标题** – 用于更改单元格的标题级别。
+ **命令面板** – 包含 Jupyter notebook 命令及其键盘快捷键。有关键盘快捷键的更多信息，请参阅本文档后续章节。
+ **会话** – 使用此菜单中的选项[查看](notebooks-spark-getting-started.md#notebooks-spark-getting-started-viewing-session-and-calculation-details)会话的详细信息、[编辑会话参数](notebooks-spark-getting-started.md#notebooks-spark-getting-started-editing-session-details)或[终止](notebooks-spark-getting-started.md#notebooks-spark-getting-started-terminating-a-session)会话。

## 使用命令模式键盘快捷键提高工作效率
<a name="notebooks-spark-command-mode-keyboard-shortcuts"></a>

以下是笔记本编辑器命令模式的一些常见键盘快捷键。按 **ESC** 进入命令模式后，可以使用这些快捷键。要查看编辑器中可用命令的完整列表，请按 **ESC \+ H**。


****  

| Key | Action | 
| --- | --- | 
| 1 - 6 | 将单元格类型更改为 markdown 并将标题级别设置为键入的数字 | 
| a | 在当前单元格上方创建一个单元格 | 
| b | 在当前单元格下方创建一个单元格 | 
| c | 将当前单元格复制到内存 | 
| d d | 删除当前单元格 | 
| h | 显示键盘快捷键帮助屏幕 | 
| j | 向下移动一个单元格 | 
| k | 向上移动一个单元格 | 
| m | 将当前单元格格式更改为 markdown | 
| r | 将当前单元格格式更改为 raw | 
| s | 保存笔记本 | 
| v | 将内存内容粘贴到当前单元格下 | 
| x | 剪切选定的一个或多个单元格 | 
| y | 将单元格格式更改为代码 | 
| z | 撤消 | 
| Ctrl\+Enter  | 运行当前单元格并进入命令模式 | 
| Shift\+Enter 或 Alt\+Enter | 运行当前单元格并在输出下方创建一个新单元格，然后在编辑模式下输入新单元格 | 
| Space | 向下翻页 | 
| Shift\+Space | 向上翻页 | 
| Shift \+ L | 切换单元格中行号的可见性 | 

## 自定义命令模式快捷键
<a name="notebooks-spark-editing-command-mode-shortcuts"></a>

笔记本编辑器可以选择自定义命令模式键盘快捷键。

**编辑命令模式快捷键**

1. 在笔记本编辑器菜单中选择 **Command palette**（命令面板）。

1. 在命令面板中选择 **Edit command mode keyboard shortcuts**（编辑命令模式键盘快捷键）命令。

1. 使用 **Edit command mode shortcuts**（编辑命令模式快捷键）界面，将所需的命令映射或重新映射到键盘。

   要查看编辑命令模式快捷键的说明，请滚动至 **Edit command mode shortcuts**（编辑命令模式快捷键）屏幕底部。

有关在 Athena for Apache Spark 中使用魔术命令的信息，请参阅 [使用魔术命令](notebooks-spark-magics.md)。

**Topics**
+ [了解笔记本会话和计算](#notebooks-spark-sessions-and-calculations)
+ [在命令模式和编辑模式之间切换](#notebooks-spark-command-mode-vs-edit-mode)
+ [使用笔记本编辑器菜单中的操作](#notebooks-spark-notebook-editor-menu)
+ [使用命令模式键盘快捷键提高工作效率](#notebooks-spark-command-mode-keyboard-shortcuts)
+ [自定义命令模式快捷键](#notebooks-spark-editing-command-mode-shortcuts)
+ [使用魔术命令](notebooks-spark-magics.md)