本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

單行上的魔術前面有一個百分比符號 (`%`)，被稱為行魔術函數或行魔術。

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

顯示可用魔術命令的描述。

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


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

列出與筆記本相關聯的工作階段。每個工作階段的資訊包括工作階段 ID、工作階段狀態，以及工作階段開始和結束的日期和時間。

![\[使用%list_sessions。\]](http://docs.aws.amazon.com/zh_tw/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_tw/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_tw/athena/latest/ug/images/notebooks-spark-magics-5.png)


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

描述目前的工作階段。輸出包括工作階段 ID、工作階段狀態、工作群組名稱、PySpark 引擎版本和工作階段開始時間。此魔術命令需要作用中的工作階段，以擷取工作階段詳細資訊。

以下是狀態的可能值：

**正在建立** – 工作階段正在啟動中，包括取得資源。

**已建立** – 工作階段已開始。

**閒置** – 工作階段能夠接受計算。

**忙碌** – 工作階段正在處理另一項作業，且無法接受計算。

**正在終止** – 工作階段正在關閉。

**已終止** – 工作階段及其資源不再執行。

**降級** – 工作階段沒有健康的協調者。

**失敗** – 由於失敗，工作階段及其資源不再執行。

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