使用 Athena 笔记本编辑器 - Amazon Athena
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

使用 Athena 笔记本编辑器

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

命令模式与编辑模式

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

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

  • 要进入编辑模式,请按 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+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 中使用魔术命令的信息,请参阅 使用魔术命令