使用 Athena 笔记本编辑器 - Amazon Athena
了解笔记本会话和计算在命令模式和编辑模式之间切换使用笔记本编辑器菜单中的操作使用命令模式键盘快捷键提高工作效率自定义命令模式快捷键

使用 Athena 笔记本编辑器

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

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

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

了解笔记本会话和计算

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

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

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

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

在命令模式和编辑模式之间切换

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

要使用编辑模式和命令模式，您可以执行以下任务：

  • 要进入编辑模式，请按 ENTER 或选择一个单元格。当单元格处于编辑模式时，单元格的左边距为绿色。

  • 要进入命令模式，请按 ESC，或在单元格以外的位置单击。请注意，命令通常仅适用于当前选定的单元格，而不适用于所有单元格。当编辑器处于命令模式时，单元格的左边距为蓝色。

  • 在命令模式下，您可以使用键盘快捷键和编辑器上方的菜单，但不能在单个单元格中输入文本。

  • 要选择单元格，请选择该单元格。

  • 要选择所有单元格，请按 Ctrl+A（Windows）或 Cmd+A（Mac）。

使用笔记本编辑器菜单中的操作

笔记本编辑器顶部菜单中的图标提供以下选项：

  • 保存 – 保存笔记本的当前状态。

  • 在下方插入单元格 – 在当前选定的单元格下方添加一个新的（空）单元格。

  • 剪切所选单元格 – 将选定单元格从其当前位置移除并将其复制到内存。

  • 复制所选单元格 – 将所选单元格复制到内存。

  • 在下方粘贴单元格 – 将复制的单元格粘贴到当前单元格下方。

  • 向上移动所选单元格 – 将当前单元格移至上方单元格上方。

  • 向下移动所选单元格 – 将当前单元格移至下方单元格下方。

  • 运行 – 运行当前（选定的）单元格。输出将立即在当前单元格下方显示。

  • 全部运行 – 运行笔记本中的所有单元格。每个单元格的输出将立即在单元格下方显示。

  • 停止（中断内核） – 通过中断内核来停止当前笔记本。

  • 格式选项 – 选择单元格格式，可以是以下格式之一：

    • 代码 – 用于 Python 代码（默认）。

    • Markdown – 用于以 GitHub 风格的 markdown 格式输入文本。运行单元格以渲染 markdown。

    • Raw NBConvert – 用于以未修改的格式输入文本。标记为 Raw NBConvert 的单元格可通过 Jupyter nbconvert 命令行工具转换为其他格式，例如 HTML。

  • 标题 – 用于更改单元格的标题级别。

  • 命令面板 – 包含 Jupyter notebook 命令及其键盘快捷键。有关键盘快捷键的更多信息，请参阅本文档后续章节。

  • 会话 – 使用此菜单中的选项查看会话的详细信息、编辑会话参数或终止会话。

使用命令模式键盘快捷键提高工作效率

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

键 操作
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 切换单元格中行号的可见性

自定义命令模式快捷键

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

编辑命令模式快捷键

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

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

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

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

有关在 Athena for Apache Spark 中使用魔术命令的信息，请参阅 使用魔术命令。

主题