使用 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+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 中使用魔术命令的信息,请参阅 使用魔术命令。