# Athena 노트북 편집기 사용
<a name="notebooks-spark-editor"></a>

**참고**  
Athena 노트북 편집기는 Pyspark 엔진 버전 3에서 지원됩니다. Apache Spark 버전 3.5에서 노트북을 사용하려면 [SageMaker 노트북](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/what-is-sagemaker-unified-studio.html)을 참조하세요.

Athena 노트북 탐색기에서 노트북을 관리하고 Athena 노트북 편집기를 사용하여 세션에서 노트북을 편집하고 실행할 수 있습니다. 요구 사항에 따라 노트북 세션에 대한 DPU 사용을 구성할 수 있습니다.

노트북을 중지하면 연결된 세션이 종료됩니다. 모든 파일이 저장되지만 선언된 변수, 함수 및 클래스에서 진행 중인 변경 사항은 손실됩니다. 노트북을 다시 시작하면 노트북 파일이 다시 로드되고 코드를 다시 실행할 수 있습니다.

Athena 노트북 편집기는 코드를 작성하고 실행하기 위한 대화형 환경입니다. 다음 단원에서는 환경의 기능에 대해 설명합니다.

## 노트북 세션 및 계산 이해
<a name="notebooks-spark-sessions-and-calculations"></a>

각 노트북은 단일 Python 커널과 연결되고 Python 코드를 실행합니다. 노트북에는 명령을 포함하는 셀이 하나 이상 존재할 수 있습니다. 노트북에서 셀을 실행하려면 먼저 노트북에 대한 세션을 생성합니다. 세션에서는 노트북의 변수 및 상태를 추적합니다.

노트북에서 셀을 실행한다는 것은 현재 세션에서 계산을 실행하는 것을 의미합니다. 계산은 노트북의 상태를 진행하며 Amazon S3에서 읽기, 다른 데이터 스토어에 쓰기와 같은 작업을 수행할 수 있습니다. 세션이 실행 중인 동안 계산을 통해 노트북에 대해 유지되는 상태를 사용 및 수정합니다.

상태가 더 이상 필요 없는 경우 세션을 종료할 수 있습니다. 세션을 종료하면 노트북은 그대로 유지되지만 변수 및 기타 상태 정보는 삭제됩니다. 여러 프로젝트를 동시에 진행해야 하는 경우 프로젝트별로 하나의 세션을 생성할 수 있으며, 세션은 서로 독립적입니다.

세션에는 DPU로 측정되는 전용 컴퓨팅 용량이 있습니다. 세션을 생성할 때 세션에 여러 DPU를 할당할 수 있습니다. 작업 요구 사항에 따라 세션마다 용량이 다를 수 있습니다.

## 명령 모드와 편집 모드 간 전환
<a name="notebooks-spark-command-mode-vs-edit-mode"></a>

노트북 편집기에는 셀에 텍스트를 입력하는 편집 모드와 복사, 붙여넣기 또는 실행과 같은 명령을 편집기 자체에 실행하는 명령 모드라는 모달 사용자 인터페이스가 있습니다.

편집 모드와 명령 모드를 사용하려면 다음 작업을 수행할 수 있습니다.
+ 편집 모드로 전환하려면 **ENTER** 키를 누르거나 셀을 선택합니다. 셀이 편집 모드에 있는 경우 셀의 왼쪽 여백이 녹색으로 표시됩니다.
+ 명령 모드로 전환하려면 **ESC** 키를 누르거나 셀 외부를 클릭합니다. 일반적으로 명령은 모든 셀이 아닌 현재 선택한 셀에만 적용됩니다. 편집기가 명령 모드에 있는 경우 셀의 왼쪽 여백이 파란색으로 표시됩니다.
+ 명령 모드에서는 키보드 바로 가기와 편집기 위의 메뉴를 사용할 수 있지만 개별 셀에 텍스트를 입력할 수는 없습니다.
+ 셀을 선택하려면 해당 셀을 선택합니다.
+ 모든 셀을 선택하려면 **Ctrl\+A**(Windows) 또는 **Cmd\+A**(Mac) 키를 누릅니다.

## 노트북 편집기 메뉴에서 작업 사용
<a name="notebooks-spark-notebook-editor-menu"></a>

노트북 편집기 상단의 메뉴에 있는 아이콘은 다음 옵션을 제공합니다.
+ **저장** - 노트북의 현재 상태를 저장합니다.
+ **아래에 셀 삽입** - 현재 선택한 셀 아래에 새 (빈) 셀을 추가합니다.
+ **선택한 셀 잘라내기** - 선택한 셀을 현재 위치에서 제거하고 셀을 메모리에 복사합니다.
+ **선택한 셀 복사** - 선택한 셀을 메모리에 복사합니다.
+ **아래에 셀 붙여넣기** - 복사한 셀을 현재 셀 아래에 붙여넣습니다.
+ **선택한 셀을 위로 이동** - 현재 셀을 위 셀 위로 이동합니다.
+ **선택한 셀을 아래로 이동** - 현재 셀을 아래 셀 아래로 이동합니다.
+ **실행** - 현재 (선택한) 셀을 실행합니다. 출력은 현재 셀 바로 아래에 표시됩니다.
+ **모두 실행** - 노트북의 모든 셀을 실행합니다. 각 셀에 대한 출력은 셀 바로 아래에 표시됩니다.
+ **중지(커널 중단)** - 커널을 중단하여 현재 노트북을 중지합니다.
+ **서식 옵션** - 다음 중에서 셀 서식을 선택합니다.
  + **코드** - Python 코드에 사용합니다(기본값).
  + **마크다운** - [GitHub 스타일 마크다운](https://docs.github.com/en/get-started/writing-on-github) 형식으로 텍스트를 입력하는 데 사용합니다. 마크다운을 렌더링하려면 셀을 실행합니다.
  + **원시 NBConvert** - 수정되지 않은 형식으로 텍스트를 입력하는 데 사용합니다. **Raw NBConvert**(원시 NBConvert)로 표시된 셀은 Jupyter [nbconvert](https://nbconvert.readthedocs.io/en/latest/usage.html) 명령줄 도구를 사용하여 HTML과 같은 다른 형식으로 변환할 수 있습니다.
+ **머리글** - 셀의 머리글 수준을 변경하는 데 사용합니다.
+ **명령 팔레트** - Jupyter Notebook 명령과 키보드 바로 가기를 포함합니다. 키보드 바로 가기에 대한 자세한 내용은 이 문서의 뒷부분에 나오는 단원을 참조하세요.
+ **세션** - 이 메뉴의 옵션을 사용하여 세션에 대한 세부 정보를 [보거나](notebooks-spark-getting-started.md#notebooks-spark-getting-started-viewing-session-and-calculation-details), [세션 파라미터를 편집하거나](notebooks-spark-getting-started.md#notebooks-spark-getting-started-editing-session-details), 세션을 [종료](notebooks-spark-getting-started.md#notebooks-spark-getting-started-terminating-a-session)할 수 있습니다.

## 명령 모드 키보드 단축키를 사용하여 생산성 향상
<a name="notebooks-spark-command-mode-keyboard-shortcuts"></a>

다음은 몇 가지 일반적인 노트북 편집기 명령 모드 키보드 바로 가기입니다. 이 바로 가기는 **ESC** 키를 눌러 명령 모드로 전환한 이후에 사용할 수 있습니다. 편집기에서 사용할 수 있는 전체 명령 목록을 보려면 **ESC \+ H**를 누르세요.


****  

| 키 | 작업 | 
| --- | --- | 
| 1 - 6 | 셀 유형을 마크다운으로 변경하고 머리글 수준을 입력한 숫자로 설정합니다. | 
| a | 현재 셀 위에 셀 생성 | 
| b | 현재 셀 아래에 셀 생성 | 
| c | 현재 셀을 메모리에 복사 | 
| d d | 현재 셀 삭제 | 
| h | 키보드 바로 가기 도움말 화면 표시 | 
| j | 한 셀 아래로 이동 | 
| k | 한 셀 위로 이동 | 
| m | 현재 셀 형식을 마크다운으로 변경 | 
| r | 현재 셀 형식을 원시로 변경 | 
| s | 노트북 저장 | 
| v | 현재 셀 아래에 메모리 내용 붙여넣기 | 
| x | 선택한 셀 잘라내기 | 
| y | 셀 형식을 코드로 변경 | 
| z | 실행 취소 | 
| Ctrl\+Enter  | 현재 셀을 실행하고 명령 모드로 전환 | 
| Shift\+Enter 또는 Alt\+Enter | 현재 셀을 실행하고 출력 아래에 새 셀을 생성한 다음 편집 모드에서 새 셀 입력 | 
| Space | 한 페이지 아래로 이동 | 
| Shift\+Space | 한 페이지 위로 이동 | 
| Shift \+ L | 셀에서 행 번호 표시 여부 전환 | 

## 명령 모드 단축키 사용자 지정
<a name="notebooks-spark-editing-command-mode-shortcuts"></a>

노트북 편집기에는 명령 모드 키보드 바로 가기를 사용자 지정하는 옵션이 있습니다.

**명령 모드 바로 가기를 편집하려면**

1. 노트북 편집기 메뉴에서 **Command palette**(명령 팔레트)를 선택합니다.

1. 명령 팔레트에서 **Edit command mode keyboard shortcuts**(명령 모드 키보드 바로 가기 편집) 명령을 선택합니다.

1. **Edit command mode shortcuts**(명령 모드 바로 가기 편집) 인터페이스를 사용하여 원하는 명령을 키보드에 매핑하거나 다시 매핑합니다.

   명령 모드 바로 가기 편집 지침을 보려면 **Edit command mode shortcuts**(명령 모드 바로 가기 편집) 화면의 아래쪽으로 스크롤하세요.

Athena for Apache Spark에서 매직 명령을 사용하는 방법에 대한 자세한 내용은 [매직 명령 사용](notebooks-spark-magics.md) 섹션을 참조하세요.

**Topics**
+ [노트북 세션 및 계산 이해](#notebooks-spark-sessions-and-calculations)
+ [명령 모드와 편집 모드 간 전환](#notebooks-spark-command-mode-vs-edit-mode)
+ [노트북 편집기 메뉴에서 작업 사용](#notebooks-spark-notebook-editor-menu)
+ [명령 모드 키보드 단축키를 사용하여 생산성 향상](#notebooks-spark-command-mode-keyboard-shortcuts)
+ [명령 모드 단축키 사용자 지정](#notebooks-spark-editing-command-mode-shortcuts)
+ [매직 명령 사용](notebooks-spark-magics.md)