# 使用行魔术
<a name="notebooks-spark-magics-line-magics"></a>

单行书写的魔术命令前有百分号（`%`），称为行魔术命令函数或行魔术命令。

## %help
<a name="notebooks-spark-magics-help"></a>

显示可用魔术命令的描述。

![\[使用%help。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/notebooks-spark-magics-2.png)


## %list\$1session
<a name="notebooks-spark-magics-list_sessions"></a>

列出与笔记本相关的会话。每个会话的信息包含会话 ID、会话状态以及会话的开始和结束日期和时间。

![\[使用%list_sessions。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/notebooks-spark-magics-3.png)


## %session\$1id
<a name="notebooks-spark-magics-session_id"></a>

检索当前会话 ID。

![\[使用session_id。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/notebooks-spark-magics-4.png)


## %set\$1log\$1level
<a name="notebooks-spark-magics-set_log_level"></a>

设置或重置记录器以使用指定的日志级别。可能的值为 `DEBUG`、`ERROR`、`FATAL`、`INFO` 和 `WARN` 或 `WARNING`。值必须为大写且不得包含在单引号或双引号中。

![\[使用%set_log_level。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/notebooks-spark-magics-5.png)


## %status
<a name="notebooks-spark-magics-status"></a>

描述当前会话。输出包含会话 ID、会话状态、工作组名称、PySpark 引擎版本和会话开始时间。此魔术命令需要活动会话才能检索会话详细信息。

状态的可能值如下所示：

**CREATING** - 会话正在启动，包括获取资源。

**CREATED** - 会话已启动。

**IDLE** - 会话能够接受计算。

**BUSY** - 会话正在处理其他任务，无法接受计算。

**TERMINATING** - 会话正在关闭。

**TERMINATED** - 会话及其资源不再运行。

**DEGRADED** - 会话没有运行正常的协调器。

**FAILED** - 由于故障，会话及其资源不再运行。

![\[使用%status。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/notebooks-spark-magics-6.png)