Streamlit 앱의 종속성 관리하기¶

Warehouse Runtime에서 지원되는 Streamlit 라이브러리 버전¶

Streamlit in Snowflake 는 다음 버전의 Streamlit 오픈 소스 라이브러리를 지원합니다.

• 1.51.0

• 1.50.0

• 1.49.1

• 1.48.0

• 1.47.0

• 1.46.1

• 1.45.1

• 1.45.0

• 1.44.1

• 1.44.0

• 1.42.0

• 1.39.0

• 1.35.0

• 1.31.1

• 1.29.0

• 1.26.0

• 1.22.0

Container Runtime을 위한 외부 액세스 통합¶

외부 액세스 통합(EAIs)의 일반적인 개요는 외부 네트워크 액세스 개요 섹션을 참조하세요.

CREATE OR REPLACE NETWORK RULE pypi_network_rule
  MODE = EGRESS
  TYPE = HOST_PORT
  VALUE_LIST = ('pypi.org', 'pypi.python.org', 'pythonhosted.org', 'files.pythonhosted.org');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION pypi_access_integration
  ALLOWED_NETWORK_RULES = (pypi_network_rule)
  ENABLED = true;

GRANT USAGE ON EXTERNAL ACCESS INTEGRATION pypi_access_integration TO ROLE app_developer_role;

ALTER STREAMLIT my_app SET
  EXTERNAL_ACCESS_INTEGRATIONS = (pypi_access_integration);

종속성 파일¶

Container Runtime은 빠르고 안정적인 종속성 확인을 위해 uv를 사용합니다. uv는 Python 패키지를 설치하기 위한 pip처럼 작동하지만, 더 성능이 뛰어나고 사용자 지정이 가능합니다. uv의 기능에 대한 자세한 내용은 uv 설명서의 `기능<https://docs.astral.sh/uv/getting-started/features/>`_ 개요를 참조하세요.

Container Runtime은 앱의 진입점 파일과 동일한 디렉터리에서 종속성 파일을 검색합니다. 종속성 파일을 찾을 수 없는 경우 앱 소스 위치의 루트에 도달할 때까지 디렉터리 트리를 계속 검색합니다. 발견된 첫 번째 종속성 파일은 앱의 종속성을 설치하는 데 사용됩니다.

동일한 디렉터리에 여러 종속성 파일이 있는 경우 다음 우선 순위에 따라 사용됩니다.

• requirements.txt: Streamlit 자체를 포함하여 Streamlit 앱에 필요한 Python 패키지 및 버전을 나열합니다. :file:`requirements.txt`로 Python 버전을 구성할 수 없습니다.

  :file:`requirements.txt`의 형식에 대한 자세한 내용은 pip 설명서의 `요구 사항 파일 형식<https://pip.pypa.io/en/stable/reference/requirements-file-format/>`_을 참조하세요.

• pyproject.toml`(권장): Python 버전 및 종속성을 관리합니다. 현재, Python 버전 3.11만 지원됩니다. :file:`pyproject.toml 파일을 제공할 때 uv는 uv.lock 파일을 사용하여 종속성 버전을 잠급니다. 이 잠금 파일은 종속성을 업데이트할 때마다 업데이트됩니다. PyPI과 다른 패키지 인덱스를 사용하려는 경우 :file:`pyproject.toml`을 사용해야 합니다.

  :file:`pyproject.toml`의 형식에 대한 자세한 내용은 Python 설명서의 `pyproject.toml 작성하기<https://packaging.python.org/en/latest/guides/writing-pyproject-toml/>`_를 참조하세요.

:file:`requirements.txt`는 앱의 종속성을 선언하는 가장 간단한 방법이며 편리하게 시작할 수 있도록 제공됩니다. 그러나 고급 종속성 관리를 위해 Snowflake는 대신 :file:`pyproject.toml`을 사용할 것을 권장합니다. 예를 들어, 이를 통해 빌드를 재현할 수 있도록 종속성 버전을 잠글 수 있습니다.

일반적으로 진입점 파일과 종속성 파일은 프로젝트 디렉터리의 루트에 있습니다. 그러나 진입점 파일은 하위 디렉터리에 있을 수 있고 종속성 파일은 동일한 디렉터리 또는 프로젝트 루트까지의 상위 디렉터리에 있을 수 있습니다.

예를 들어, 프로젝트 디렉터리의 구조는 다음 중 하나일 수 있습니다.

source_directory/
├── requirements.txt
└── streamlit_app.py

source_directory/
├── pyproject.toml
├── streamlit_app.py
└── uv.lock

source_directory/
├── pyproject.toml
├── subdirectory/
│   └── streamlit_app.py
└── uv.lock

source_directory/
└── subdirectory/
    ├── pyproject.toml
    ├── streamlit_app.py
    └── uv.lock

[project]
name = "my-streamlit-app"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "streamlit[snowflake]==1.50.0",
    "pandas>=2.0.0",
    "plotly>5.0.0",
    "requests>2.0.0,<3.0.0"
]

streamlit[snowflake]==1.50.0
pandas>=2.0.0
plotly>5.0.0
requests>2.0.0,<3.0.0

[project]
name = "my-streamlit-app"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "streamlit[snowflake]==1.50.0",
    "pandas>=2.0.0",
    "plotly>=5.0.0",
    "requests>2.0.0,<3.0.0"
]

[[tool.uv.index]]
name = "jfrog"
url = "<server_name>.jfrog.io/artifactory/api/pypi/<repository_key>/simple"
default = true

[[tool.uv.index]]
name = "jfrog"
url = "https://<username>:<access_token>@<server_name>.jfrog.io/artifactory/api/pypi/<repository_key>/simple"
default = true

environment.yml 파일¶

environment.yml 파일을 사용하여 Warehouse Runtime 환경에 종속 항목을 설치하려면 앱 소스 위치의 루트에 파일을 만들거나 편집합니다. environment.yml 파일을 제공하지 않는 경우 Snowflake는 선택한 환경에 대해 사전 설치된 패키지만 사용합니다. :file:`environment.yml`의 구조에 대한 자세한 내용은 `conda 설명서<https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-file-manually>`_를 참조하세요.

Streamlit in Snowflake Warehouse Runtime에서 environment.yml 파일을 사용하는 경우 다음 제한 사항이 적용됩니다.

• Snowflake Anaconda 채널만 사용하여 패키지를 설치할 수 있습니다.

• :ref:`label-streamlit_supported_libraries`에 나열된 Streamlit 버전만 사용할 수 있습니다.

• dependencies 섹션에서 pip 패키지를 선언할 수 없습니다(로컬 패키지에 대한 상대 경로 포함).

다음 :file:`environment.yml`은 Python 3.11 및 5개의 Python 패키지를 선언합니다.

name: my-streamlit-app
channels:
  - snowflake
dependencies:
  - python=3.11
  - streamlit=1.50.0
  - pandas=2.*
  - plotly=5.0.*
  - requests
  - snowflake-snowpark-python

Snowflake에서는 Streamlit의 새 버전이 Snowflake Anaconda Channel에서 제공될 때 앱이 업그레이드되지 않도록 Streamlit 버전을 고정할 것을 권장합니다.

conda를 사용한 로컬 개발¶

conda를 사용하여 로컬에서 Warehouse Runtime 앱을 개발하는 경우 :file:`environment.yml`에 추가 세부 정보를 포함하여 종속성이 올바르게 설치되었는지 확인해야 합니다.

• 해당 URL:``https://repo.anaconda.com/pkgs/snowflake``로 Snowflake Anaconda 채널을 식별합니다.

• 기본 채널을 차단합니다.

environment.yml 파일에서 다음 두 채널을 사용합니다.

channels:
  - https://repo.anaconda.com/pkgs/snowflake
  - nodefaults

``defaults``가 ~/.condarc 파일에 표시되는 경우 주석 처리합니다.

channels:
  # - defaults

Snowsight 패키지 선택기¶

Warehouse Runtime 앱에 environment.yml 파일을 직접 편집하는 작업 외에도 Snowsight 에서 기본 제공 패키지 선택기를 사용하여 앱 환경에서 패키지를 추가하거나 제거할 수 있습니다. 패키지 선택기는 Warehouse Runtime을 사용하는 앱에서만 사용할 수 있습니다. 또한 패키지 선택기는 앱의 현재 Python 버전과 호환되는 패키지만 표시합니다. Python 버전과 무관한 일부 시스템 라이브러리는 패키지 선택기에 표시되지 않을 수 있으며 :file:`environment.yml`에 수동으로 추가해야 합니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » :ui:`Streamlit`을 선택한 다음 Streamlit 앱을 선택합니다.

3. 오른쪽 위 모서리에서 Edit 을 선택합니다.

4. 편집기 창의 왼쪽 상단에서 :ui:`Packages`를 선택합니다.

   Anaconda Packages 탭이 선택된 드롭다운 창이 나타납니다.

5. 다음 작업 중 하나를 수행합니다.

• Python 버전을 설정하려면 Python version 선택기에서 원하는 버전을 선택합니다.

• 패키지를 추가하려면 검색 창을 사용하여 이름별로 패키지를 찾은 후 원하는 패키지를 선택합니다.

• 패키지를 제거하려면 Installed Packages 섹션에서 패키지 버전 오른쪽에 있는 x 아이콘을 선택합니다.

• 설치된 패키지의 버전을 설정하려면 Installed Packages 섹션에서 패키지 이름 옆의 버전 선택기를 사용합니다.

Snowflake는 environment.yml 파일을 자동으로 업데이트하고 앱을 재부팅합니다. 편집기에 environment.yml 파일이 있는 경우 페이지를 새로 고쳐 변경 사항을 확인합니다.