Snowflake Python Demos API¶

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>'

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

snowflake.demos 가져오기¶

터미널에서 라이브러리를 사용하려면 표준 Python REPL 과 같은 대화형 셸을 열면 됩니다.

1. 다음 명령을 실행합니다(Python 환경에 따라 다를 수 있음).

   python3
   

   Copy

2. REPL 세션에서 라이브러리와 관련 함수를 가져오려면 다음 코드를 실행합니다.

   from snowflake.demos import help, load_demo, teardown
   

   Copy

현재 사용 가능한 데모 목록¶

Snowflake Demos API 는 현재 다음 데모 목록과 함께 작동합니다.

데모 로딩 및 살펴보기¶

• Snowflake에서 특정 데모를 로드하고 연관된 리소스를 설정하려면 help() 출력에서 찾은 사용 가능한 데모의 demo_name 을 인자로 지정하여 load_demo() 를 호출합니다.

  예:

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

  Copy

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

• 데모를 처음 로딩하는 경우 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 보기¶

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