Streamlit in Snowflake 시작하기¶

이 항목에서는 Container Runtime을 사용하여 5분 이내에 첫 번째 Streamlit in Snowflake 앱을 배포하는 방법을 안내합니다. 그런 다음 두 가지 실습 예제를 통해 데이터를 쿼리하는 실제 앱을 빌드하고, 각 뷰어에 대한 경험을 개인 설정하며, Snowflake에 다시 쓰는 방법을 보여줍니다.

전제 조건¶

Streamlit 앱을 만들려면 먼저 관리자가 Streamlit 앱에 대한 :ref:`필수 보안 설정<label-streamlit_essential_security_setup>`을 완료했는지 확인합니다.

해당 역할에는 다음 권한이 있어야 합니다.


권한	오브젝트	참고
USAGE	Streamlit 앱을 생성하는 데이터베이스
CREATE STREAMLIT, USAGE	Streamlit 앱을 생성하는 스키마
USAGE	Streamlit 앱을 실행하는 컴퓨팅 풀	모든 계정에 대해 Snowflake는 일반 사용자가 액세스할 수 있는 범용 컴퓨팅 풀을 구성합니다. 자세한 내용은 Streamlit 앱에 대해 선호하는 컴퓨팅 풀 구성하기 섹션을 참조하십시오.
USAGE	Streamlit 앱에서 쿼리를 실행하는 웨어하우스

자세한 내용은 Streamlit 앱 생성 및 사용에 필요한 권한 섹션을 참조하십시오.

첫 번째 Streamlit in Snowflake 앱 배포¶

시작하는 가장 빠른 방법은 기본 스타터 코드를 사용하여 Streamlit 앱을 생성하는 것입니다. 소스 파일을 지정하지 않고 앱을 생성하면 Snowflake가 자동으로 예제 코드를 제공합니다.

Snowsight 에 로그인합니다.
탐색 메뉴에서 Projects » Streamlit 를 선택합니다.
+ Streamlit App 를 선택합니다.
앱 이름을 입력합니다.
앱을 만들 데이터베이스와 스키마를 선택합니다.
Run on container 을 선택합니다.
컴퓨팅 풀과 쿼리 웨어하우스를 선택합니다.
Create 를 선택합니다.

Snowsight 는 앱 편집기로 리디렉션합니다. 몇 분 내에 앱이 준비됩니다. 그러면 즉시 보고 편집할 수 있습니다.

SQL 세션에서 다음 SQL 명령을 실행합니다.

CREATE STREAMLIT my_first_app
   RUNTIME_NAME = 'SYSTEM$ST_CONTAINER_RUNTIME_PY3_11'
   COMPUTE_POOL = my_compute_pool
   QUERY_WAREHOUSE = my_warehouse;

ALTER STREAMLIT my_first_app ADD LIVE VERSION FROM LAST;

앱을 보려면 Snowsight 에 로그인한 다음, 탐색 메뉴에서 Projects » :ui:`Streamlit`을 선택하고 앱을 선택합니다.

참고

Snowflake CLI 버전 3.14.0 이상이 필요합니다. 버전 3.14 이상에서는 기본적으로 최신 CREATE STREAMLIT 구문을 사용합니다.

새 Streamlit 프로젝트를 초기화합니다.
```
snow init my_first_app --template example_streamlit
```
프로젝트 디렉터리로 이동합니다.
```
cd my_first_app
```

Container Runtime을 사용하도록 snowflake.yml 파일을 편집합니다.

definition_version: 2
entities:
   my_streamlit:
      type: streamlit
      identifier: my_first_app
      query_warehouse: my_warehouse
      compute_pool: my_compute_pool
      runtime_name: SYSTEM$ST_CONTAINER_RUNTIME_PY3_11
      main_file: streamlit_app.py
      artifacts:
      - streamlit_app.py

앱을 배포하고 브라우저에서 엽니다.
```
snow streamlit deploy --open
```

앱 편집하기¶

배포한 후 앱 코드를 편집하여 사용자 지정할 수 있습니다. 빠른 테스트를 위해 다음을 수행합니다.

Snowsight 에 로그인합니다.
탐색 메뉴에서 Projects » :ui:`Streamlit`을 선택한 후 앱을 선택합니다.
Edit 을 선택합니다.
:file:`streamlit_app.py`에서 코드를 수정합니다.
:ui:`Run`을 선택하여 변경 사항을 확인합니다.

앱의 소스 위치를 확인합니다.
```
DESCRIBE STREAMLIT my_first_app;
```

업데이트된 파일을 해당 위치에 복사합니다.

COPY FILES INTO '<live_version_location_uri>' FROM @my_stage FILES = ('streamlit_app.py');

로컬 프로젝트 디렉터리에서 :file:`streamlit_app.py`를 편집합니다.
재배포:
```
snow streamlit deploy --replace
```

자세한 내용은 Streamlit 앱 편집 섹션을 참조하십시오.

다음에는 무엇을 해야 합니까?¶

이제 앱이 실행 중이므로 다음 실습 예제 중 하나를 시도해 보세요.

예: 개인 설정 데이터 대시보드 빌드: st.connection 및 :code:`st.user`를 사용하여 Snowflake 데이터를 쿼리하고 각 뷰어에 맞게 디스플레이를 개인 설정하는 대시보드를 구축합니다.
예: Snowflake에 쓰는 양식 빌드: 사용자 입력을 Snowflake 테이블에 다시 쓰는 양식을 구축하여 st.form, 종속성 관리 및 :code:`st.user`를 시연합니다.

특정 항목에 대해 자세히 알아보려면 다음을 참조하세요.

Streamlit 앱 생성: Snowsight, SQL 또는 CLI에서 앱을 생성하기 위한 자세한 지침입니다.
Streamlit 앱의 종속성 관리하기: 앱에 Python 패키지를 추가합니다.
Streamlit 앱을 위한 런타임 환경: Container Runtime 및 Warehouse Runtime을 이해합니다.
Streamlit in Snowflake 의 외부 네트워크 액세스: 앱을 외부 서비스에 연결합니다.