노트북 만들기¶
이 항목에서는 Warehouse Runtime에서 Snowflake Notebooks 을 만드는 방법에 대해 설명합니다. Container Runtime에서 Snowflake Notebooks 을 생성할 수도 있습니다. 자세한 내용은 Container Runtime for ML의 Notebooks 섹션을 참조하십시오.
노트북은 Snowsight 를 통해 액세스할 수 있습니다.
팁
SQL을 사용하여 노트북을 만들 수도 있습니다. CREATE NOTEBOOK 섹션을 참조하십시오.
전제 조건¶
필요한 권한 이 있는 역할을 사용합니다.
새로운 노트북 만들기¶
+ Notebook 을 선택해 새 노트북을 만들거나 *.ipynb
확장 프로그램을 사용해 파일을 가져올 수 있습니다. 이는 Snowflake 외부의 애플리케이션에서 생성한 노트북 파일일 수 있습니다.
새 노트북을 생성하려면 다음 단계를 따르십시오.
Snowsight 에 로그인합니다.
왼쪽 탐색 메뉴에서 Projects » Notebooks 를 선택합니다.
+ Notebook 을 선택합니다.
노트북의 이름을 입력합니다. Snowflake는 공백이 포함된 이름을 포함해 입력한 노트북 이름의 정확한 대/소문자를 유지합니다. 노트북 이름은 대/소문자를 구분합니다.
참고
AWS 리전을 사용하는 경우, 노트북의 런타임 환경(Warehouse Runtime 또는 Container Runtime)을 지정할 수 있습니다.
Notebook location 을 선택합니다. 이는 노트북을 저장할 데이터베이스와 스키마입니다. 노트북을 만든 후에는 변경할 수 없습니다.
참고
Notebook location 목록에는 Create Notebook 대화 상자를 연 후 생성된 데이터베이스가 표시되지 않을 수 있습니다. 최근에 생성한 데이터베이스, 스키마 또는 웨어하우스를 찾을 수 없는 경우 브라우저 윈도우를 다시 로드해 보십시오.
노트북의 데이터 쿼리는 이 위치에 국한되지 않습니다. 노트북에서는 액세스 권한이 있는 모든 위치의 데이터를 쿼리할 수 있습니다. 위치를 지정하려면 USE WAREHOUSE 및 USE SCHEMA 를 실행합니다.
Python 환경으로 Run on warehouse 또는 Run on container 를 선택합니다.
(선택 사항) Query warehouse 를 선택해 노트북에서 발행한 모든 SQL 및 Snowpark 쿼리를 실행합니다.
노트북별 작업을 실행하려면 Notebook warehouse 를 선택합니다. Snowflake는 노트북을 실행하기 위해 각 계정에 프로비저닝되어 있는 Snowflake 관리 웨어하우스인 SYSTEM$STREAMLIT_NOTEBOOK_WH 를 사용할 것을 권장합니다.
Create 를 선택해 노트북을 만들고 엽니다.
기존 파일에서 새 노트북을 생성할려면 다음 단계를 따르십시오.
+ Notebook 옆의 아래쪽 화살표를 선택한 다음 Import .ipynb file 을 선택합니다.
가져올 파일(예: Snowflake 외부의 애플리케이션에서 생성한 노트북 파일)을 엽니다.
참고
노트북이 Python 패키지를 가져오는 경우, 가져온 노트북을 실행하기 전에 패키지를 노트북에 추가해야 합니다. 노트북에서 사용할 Python 패키지 가져오기 섹션을 참조하십시오. 가져온 노트북에 사용하는 패키지를 사용할 수 없는 경우 코드가 실행되지 않을 수 있습니다. 셀 추가에 대한 정보는 Snowflake Notebooks 에서 코드 개발 및 실행 섹션을 참조하십시오.
셀 추가에 대한 정보는 Snowflake Notebooks 에서 코드 개발 및 실행 섹션을 참조하십시오.
SQL 을 사용해 노트북을 생성합니다¶
CREATE NOTEBOOK 명령을 사용해 노트북을 생성할 수 있습니다. 이 명령으로 노트북의 위치, 메인 파일, 버전 소스를 프로그래밍 방식으로 정의할 수 있습니다. 하지만 SQL 을 사용해 노트북을 생성하면 노트북에 라이브 버전이 자동으로 포함되지 않습니다. EXECUTE NOTEBOOK 명령을 사용해 노트북을 실행하려면 라이브 버전이 필요합니다.
라이브 버전이 없는 노트북을 실행하려고 시도하거나 노트북을 삭제한 후 다시 생성한 경우, 다음 오류가 표시될 수 있습니다.
Live version is not found.
이 문제를 해결하려면 다음 예시와 같이 노트북을 실행하기 전에 라이브 버전을 추가하십시오.
ALTER NOTEBOOK DB_NAME.SCHEMA_NAME.NOTEBOOK_NAME ADD LIVE VERSION FROM LAST;
DB_NAME
은 노트북이 들어 있는 데이터베이스의 이름입니다SCHEMA_NAME
은 노트북이 들어 있는 스키마의 이름입니다NOTEBOOK_NAME
은 노트북의 이름입니다
Git 리포지토리에서 노트북 만들기¶
노트북 개발 작업을 Git 리포지토리와 동기화할 수 있습니다. 그런 다음 해당 Git 리포지토리에 있는 노트북에서 Snowflake Notebooks 를 만들 수 있습니다.
Git의 파일에서 노트북을 만들려면 Git 리포지토리의 파일에서 노트북 만들기 섹션을 참조하십시오.
기존 노트북 복제¶
기존 Snowflake Notebooks 를 복제할 수 있습니다. 예를 들어, 원래 노트북 버전을 변경하지 않고 일부 코드 변경 사항을 테스트할 경우 노트북을 복제하는 것이 유용할 수 있습니다.
노트북을 복제하면 복사된 노트북은 원본 노트북과 동일한 역할 및 웨어하우스로 생성되고, 원본 노트북과 동일한 데이터베이스 및 스키마에 포함됩니다. 이로 인해 노트북을 복제하여 다른 데이터베이스 및 스키마로 이동하거나 소유권을 변경할 수 없습니다.
타일을 복제하려면 다음 단계를 완료합니다.
Snowsight 에 로그인합니다.
Projects » Notebooks 를 선택합니다.
복제할 노트북을 엽니다.
(선택 사항) 복제 노트북의 이름을 입력한 다음 Duplicate 를 선택합니다.
확인 대화 상자에서 Close 를 선택해 원본 노트북으로 돌아가거나 Open notebook 을 선택해 복제 노트북을 엽니다.
기존 노트북 열기¶
기존 노트북을 열려면 다음 단계를 따르십시오.
Snowsight 에 로그인합니다.
Notebooks 를 선택합니다.
참고
최근에 사용한 노트북도 Snowsight 에 표시됩니다. Recently viewed 에서 Notebooks 를 선택합니다.
노트북 목록을 검토합니다.
활성 역할이 소유한 모든 노트북 또는 활성 역할이 상속한 역할이 소유한 모든 노트북을 볼 수 있습니다. 각 노트북에는 다음 정보가 표시됩니다.
Title: 노트북 제목
Viewed: 노트북을 마지막으로 본 시간
Updated: 노트북이 마지막으로 실행된 시간
Environment: 노트북의 런타임 환경(Container Runtime 또는 Warehouse Runtime)
Location: 노트북의 데이터베이스 및 스키마 위치
Owner: 노트북의 소유자
편집하려면 노트북을 선택합니다.
노트북 편집에 대한 자세한 내용은 Snowflake Notebooks 에서 코드 개발 및 실행 섹션을 참조하십시오.
노트북을 열면 노트북에서 셀을 마지막으로 실행한 시점의 캐시된 결과를 볼 수 있습니다. 노트북은 기본적으로 Not connected 상태이지만, 해당 상태를 선택하거나 셀을 실행하면 노트북이 가상 웨어하우스에 연결됩니다.