Snowflake Python Demos API

Snowflake Python 데모 라이브러리(snowflake.demos)는 데이터베이스, 스키마, 역할, 권한, 데이터 세트 액세스 구성과 같은 환경 설정 작업을 자동화하여 Snowflake Notebooks 에 대한 데모를 빠르게 스캐폴딩하여 Snowflake Notebooks 를 간편하게 시작할 수 있도록 도와줍니다.

이 라이브러리를 사용하면 다음과 같은 작업을 수행할 수 있습니다.

  • Snowflake 환경에서 Snowflake Notebooks 데모를 로딩하고 설정합니다.

  • 대화형 노트북을 단계별로 살펴보며 직접 체험해 보십시오.

  • 작업이 끝나면 리소스를 쉽게 분리하십시오.

전제 조건

Snowflake Demos API 를 시작하기 전에 다음 단계를 완료하십시오.

  1. 지원되는 Python 버전 중 하나를 설치했는지 확인합니다.

  2. Snowflake Demos 라이브러리 설치하기.

  3. 기본 Snowflake 연결 설정하기.

  4. snowflake.demos 가져오기.

지원되는 Python 버전

지원되는 Python 버전은 다음과 같습니다.

  • 3.9

  • 3.10

  • 3.11

  • 3.12

Snowflake Demos 라이브러리 설치하기

Snowflake Demos 라이브러리를 설치하여 conda 또는 가상 환경에서 사용할 수 있습니다. 라이브러리를 설정하려면 다음과 같이 하십시오.

  1. Python 환경을 활성화합니다.

  2. 다음 pip install 명령을 실행하여 라이브러리를 설치합니다.

    pip install snowflake.demos
    Copy

기본 Snowflake 연결 설정하기

Snowflake Demos API 는 Snowflake Python Connector 에 대한 기본 연결을 사용합니다. 이 연결을 구성하려면 기본 연결 설정하기 의 지침을 따르십시오.

예를 들어 명명된 연결을 Snowflake config.toml 파일에서 기본 연결로 지정하려면 다음과 같이 config.toml 파일에 기본 연결 이름을 추가합니다.

default_connection_name = '<connection_name>'
Copy

TOML 구성 파일에서 연결 정의를 지정하는 방법에 대한 자세한 내용은 connections.toml 파일을 사용하여 연결하기 섹션을 참조하십시오.

snowflake.demos 가져오기

터미널에서 라이브러리를 사용하려면 다음 명령을 실행하여 표준 Python REPL 같은 대화형 셸을 열면 됩니다(Python 환경에 따라 다를 수 있음).

python3
Copy

REPL 세션에서 다음 코드를 실행하여 라이브러리와 관련 함수를 가져옵니다.

from snowflake.demos import help, load_demo, teardown
Copy

사용 가능한 데모 목록 표시

라이브러리를 가져온 후 help() 함수를 사용하여 로딩할 수 있는 사용 가능한 데모 목록을 확인하고 탐색을 시작할 수 있습니다. 이 함수는 다음 열이 포함된 테이블을 반환합니다.

  • demo_name - 데모 이름을 나타내는 대시로 구분된 문자열입니다.

  • title - 사람이 읽을 수 있는 데모 이름 제목입니다.

  • num_steps - 데모의 단계 수입니다.

현재 사용 가능한 데모 목록

Snowflake Demos API 는 현재 다음 데모 목록을 지원합니다.

demo_name

title

num_steps

get-started-snowpark-ws-nb

Snowflake Notebooks와 Python Worksheets에서 Snowpark 시작하기

1

get-started-snowflake-ml

Snowflake ML 시작하기

4

analysis-churn-notebooks

Snowflake Notebooks를 사용한 데이터 분석 및 이탈 예측

2

get-started-container-runtime

Snowflake Container Runtime 시작하기

1

intro-to-feature-store-nb

Snowflake Notebooks를 사용하는 Feature Store 소개

1

get-started-partitioned-models

분할 모델 및 Snowflake Model Registry 시작하기

1

데모로 작업하기

사전 요구 사항 을 완료한 후 다음과 같이 Snowflake Demos API 를 사용하여 데모 작업을 시작할 수 있습니다.

데모 로딩 및 살펴보기

Snowflake에서 특정 데모를 로드하고 연관된 리소스를 설정하려면 help() 출력에서 찾은 지원되는 데모의 demo_name 을 인자로 지정하여 load_demo() 를 호출합니다. 예:

load_demo('get-started-snowflake-ml')
Copy

팁

데모에 대한 참조를 오브젝트로 저장하려면 load_demo() 의 결과를 변수에 할당하면 됩니다.

demo = load_demo('get-started-snowflake-ml')
Copy

다단계 데모(num_steps > 1)로 작업하는 경우 결과를 변수에 할당해야 합니다. 데모의 다음 노트북으로 이동하려면 show_next() 또는 show(step=<number>) 을(를) 호출할 때 이 참조가 필요합니다.

이 참조를 사용하여 나중에 데모를 빠르게 해체할 수도 있습니다.

이 함수는 다음을 수행합니다.

  • 데모를 처음 로딩하는 경우 Snowflake에 대한 연결을 생성합니다.

  • 필요한 노트북을 만듭니다.

  • load_demo() 를 변수에 할당하지 않은 경우 데모의 첫 번째 단계(1단계)에 대해 노트북 URL 을 표시합니다.

    • 변수에 load_demo() 를 할당한 경우 demo.show() 를 호출하여 첫 번째 노트북 URL 을 가져와야 합니다.

출력은 다음과 비슷한 형태여야 합니다.

Connecting to Snowflake...✅
Using ACCOUNTADMIN role...✅
Creating Database SNOWFLAKE_DEMO_DB...✅
Creating Schema SNOWFLAKE_DEMO_SCHEMA...✅
Creating Warehouse SNOWFLAKE_DEMO_WH...✅
Creating Stage SNOWFLAKE_DEMO_STAGE...✅
Uploading files to stage SNOWFLAKE_DEMO_STAGE/get-started-snowflake-ml and creating notebooks...
Creating notebook get_started_snowflake_ml_start_here...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_feature_transformations...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_model_training_inference...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowpark_ml_adv_mlops...✅
Running setup for this demo...✅

참고

인쇄된 노트북 URL에 알려진 문제가 있습니다. URL 이 바로 열리지 않는다면 복사본을 새 브라우저 탭에 붙여넣거나 Notebooks 탭의 Snowsight 에서 노트북에 수동으로 액세스할 수 있습니다.

데모 URL 보기

show() 함수를 사용하여 URL 을 현재 또는 데모의 특정 단계로 가져올 수 있습니다.

데모의 현재 단계에 대한 노트북의 URL 을 가져오려면 먼저 load_demo() 의 결과를 demo 와 같은 변수에 할당하고 인자 없이 show() 를 호출합니다.

demo.show()
Copy

출력은 다음과 비슷한 형태여야 합니다.

Showing step 1.
Please copy and paste this url in your web browser to open the notebook:
https://app.snowflake.com/myorg/myaccount/#/notebooks/SNOWFLAKE_DEMO_DB.SNOWFLAKE_DEMO_SCHEMA.GET_STARTED_SNOWFLAKE_ML_START_HERE

데모의 특정 단계에 대한 노트북 URL 을 가져오려면 지정된 단계 번호와 함께 step 인자를 show() 에 전달합니다.

demo.show(step=1)
Copy

다단계 데모의 다음 단계를 위해 노트북 URL 을 가져오려면 show_next() 함수를 사용하십시오.

demo.show_next()
Copy

데모 및 해당 리소스 삭제하기

설정한 데모 탐색이 끝나면 생성된 모든 리소스, 데이터 세트 및 노트북을 정리하는 것이 좋습니다.

단일 데모 및 관련 리소스를 삭제하려면 먼저 load_demo() 의 결과를 demo 와 같은 변수에 할당하고 teardown() 을 호출합니다.

demo.teardown()
Copy

설정된 모든 데모 및 관련 리소스를 삭제하려면 teardown() 을 최상위 함수로 호출하십시오.

teardown()
Copy
언어: 한국어