Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.
# Amazon Redshift의 노트북
노트북을 사용하여 단일 문서에서 여러 SQL 쿼리를 구성하고 주석을 달고 공유할 수 있습니다. 여러 SQL 쿼리 및 마크다운 셀을 노트북에 추가할 수 있습니다. 노트북은 여러 쿼리 및 마크다운 셀을 사용하여 단일 문서에서 데이터 분석과 관련된 쿼리 및 설명을 그룹화하는 방법을 제공합니다. 마크다운 구문으로 텍스트를 추가하고 모양의 서식을 지정하여 데이터 분석 태스크에 대한 컨텍스트 및 추가 정보를 제공할 수 있습니다. 노트북을 팀원과 공유할 수 있습니다.
노트북을 사용하려면 IAM 보안 주체(IAM 사용자 또는 IAM 역할)에 노트북에 대한 권한을 추가해야 합니다. 가장 좋은 방법은 권한 정책을 IAM 역할에 연결한 다음 필요에 따라 사용자 및 그룹에 할당하는 것입니다. 자세한 내용은 [Amazon Redshift의 Identity and Access Management](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html)를 참조하세요. 쿼리 편집기 v2 관리형 정책 중 하나에 권한을 추가할 수 있습니다. 자세한 내용은 [쿼리 편집기 v2에 액세스](query-editor-v2-getting-started.md#query-editor-v2-configure) 단원을 참조하십시오.
순차적으로 노트북의 셀을 모두 실행할 수 있습니다. 노트북의 SQL 쿼리 셀에는 쿼리 에디터 탭과 거의 동일한 기능이 있습니다. 자세한 내용은 [Amazon Redshift 쿼리 작성](query-editor-v2-query-run.md) 단원을 참조하십시오. 다음은 노트북의 쿼리 에디터 탭과 SQL 셀 간의 차이점입니다.
+ 노트북에는 SQL 문에 `Explain`을 실행할 수 있는 컨트롤이 없습니다.
+ 노트북 SQL 셀당 하나의 차트만 생성할 수 있습니다.
쿼리 에디터 v2를 사용하여 만든 파일로 노트북을 가져오고 내보낼 수 있습니다. 파일 확장자는 `.ipynb`이며 파일 크기는 최대 5MB일 수 있습니다. SQL 및 마크다운 셀은 파일에 저장되어 있습니다. 클러스터 또는 작업 그룹 및 데이터베이스는 내보낸 노트북에 저장되지 않습니다. 가져온 노트북을 열 때 실행할 클러스터 또는 작업 그룹과 데이터베이스를 선택합니다. SQL 셀을 실행한 후에는 결과 탭에서 현재 결과 페이지를 차트로 표시할지 여부를 선택할 수 있습니다. 쿼리 결과 집합은 노트북에 저장되지 않습니다.
# 노트북 생성
노트북을 생성하여 단일 문서에서 여러 SQL 쿼리를 구성하고 주석을 달고 공유할 수 있습니다.
**노트북을 생성하려면**
1. 탐색 메뉴에서 에디터 아이콘(![\[Horizontal lines representing redacted or censored text.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-align-left.png))을 선택합니다.
1. 더하기 아이콘(![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/add-plus.png))을 선택한 다음 **노트북**을 선택합니다.
기본적으로 SQL 쿼리 셀은 선택한 노트북에 나타납니다.
1. SQL 쿼리 셀에서 다음 중 하나를 수행합니다.
+ 쿼리를 입력합니다.
+ 복사한 쿼리를 붙여넣습니다.
1. (선택 사항) 더하기 아이콘(![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/add-plus.png))을 선택한 다음 **마크다운**을 선택하여 표준 마크다운 구문을 사용하여 설명 또는 설명 텍스트를 제공할 수 있는 마크다운 셀을 추가합니다.
1. (선택 사항) 더하기 아이콘(![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/add-plus.png))을 선택한 다음 **SQL**을 선택하여 SQL 셀을 삽입합니다.
연필 아이콘(![\[Pencil icon representing an editing or writing function.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-edit.png))을 사용하여 노트북의 이름을 바꿀 수 있습니다.
노트북 메뉴 아이콘(![\[Three dots arranged horizontally, representing an ellipsis or "more" menu icon.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-more.png))에서 다음 작업을 수행할 수도 있습니다.
+ ![\[Share\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-share.png) **Share with my team**(내 팀과 공유) - 태그로 정의된 대로 팀과 노트북을 공유합니다. 팀과 노트북을 공유하려면 기본 태그 `sqlworkbench-team`이 계정의 나머지 팀원과 동일한 값으로 설정되어 있는지 확인합니다. 예를 들어, 관리자는 회계 부서의 모든 사람에 대해 값을 `accounting-team`으로 설정할 수 있습니다. 예시는 [쿼리 편집기 v2를 사용하는 데 필요한 권한](redshift-iam-access-control-identity-based.md#redshift-policy-resources.required-permissions.query-editor-v2)을 확인하세요.
+ ![\[Export\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-export.png) **Export**(내보내기) - 노트북을 `.ipynb` 확장자를 가진 로컬 파일로 내보냅니다.
+ ![\[Import query\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-import.png) **쿼리 가져오기** - 로컬 파일에서 노트북의 셀로 쿼리를 가져옵니다. 확장자가 `.sql` 및 `.txt`인 파일을 가져올 수 있습니다.
+ ![\[Save\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-floppy-disk.png) **Save version**(버전 저장) - 노트북 버전을 만듭니다. 노트북 버전을 확인하려면 저장된 노트북으로 이동하여 **Version history**(버전 기록)를 엽니다.
+ ![\[Duplicate\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-duplicate.png) **Duplicate**(복제) – 노트북 사본을 만들고 새 노트북 탭에서 엽니다.
+ ![\[Shortcuts\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-key-command.png) **Shortcuts**(바로 가기) – 노트북을 작성할 때 사용할 수 있는 바로 가기를 표시합니다.
# 노트북으로 가져오기
전체 노트북 또는 개별 SQL 셀을 쿼리 에디터 v2 노트북으로 가져올 수 있습니다.
로컬 파일에서 전체 노트북을 **내 노트북**으로 가져오려면 ![\[Import\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-import.png) **가져오기**를 선택한 다음, **노트북 가져오기**를 선택합니다. 노트북이 들어 있는 .`.ipynb` 파일로 이동합니다. 노트북을 현재 열려 있는 노트북 폴더로 가져옵니다. 그런 다음 노트북 편집기를 사용하여 노트북을 열 수 있습니다.
로컬 파일에서 노트북의 SQL 셀로 쿼리를 가져오려면 ![\[Import\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/qev2-import.png) **가져오기**를 선택한 다음, **쿼리 가져오기**를 선택합니다. **쿼리 가져오기** 창에서 화면의 지시에 따라 새 노트북 또는 기존 노트북으로 쿼리로 가져올 수 있는 파일과 폴더를 선택합니다. 파일의 확장자는 `.sql` 또는 `.txt`여야 합니다. 각 쿼리는 최대 10,000자까지 가능합니다. 기존 노트북에 추가할 때는 **저장된 노트북** 목록의 모든 노트북 중에서 원하는 노트북을 선택합니다. 가져온 쿼리는 노트북 끝에 SQL 셀로 추가됩니다. 새 노트북을 선택하는 경우, 노트북 이름을 선택하면 현재 열려 있는 저장된 노트북 폴더에 노트북이 만들어집니다.
**참고**
macOS에서 TextEdit 애플리케이션을 사용하여 `.sql` 파일을 만들 때 파일에 숨겨진 확장자가 추가되는 문제가 발생할 수 있습니다. 예를 들어 TextEdit에서 만든 `Test.sql`이라는 이름의 파일은 `Test.sql.rtf`로 저장될 수 있습니다. 쿼리 에디터 v2는 확장자가 `.rtf`인 파일을 지원하지 않습니다. 그러나 TextEdit을 사용하여 `.sql` 파일을 만든 후 일반 텍스트 파일로 저장하면 파일에 숨겨진 `.txt` 확장자가 추가로 붙습니다. 예를 들어 `Text.sql`이라는 파일은 `Text.sql.txt`로 저장될 수 있습니다. `.rtf` 확장자와 달리, 쿼리 에디터 v2는 `.txt` 확장자를 가진 파일을 지원하므로, 노트북으로 쿼리를 가져올 때 `Text.sql.txt`가 지원됩니다.
노트북 데모를 보려면 다음 동영상을 시청하세요.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/GNahyu7j98M)