Verwalten von Abhängigkeiten für Ihre Streamlit-App¶

Unterstützte Versionen der Streamlit-Bibliothek in Warehouse Runtimes¶

Streamlit in Snowflake unterstützt die folgenden Versionen der Streamlit-Open-Source-Bibliothek:

• 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

Externe Zugriffsintegrationen für Container Runtimes¶

Für einen allgemeinen Überblick über externe Zugriffsintegrationen (EAIs) siehe Übersicht über externen Netzwerkzugriff.

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);

Abhängigkeitsdateien¶

Container Runtimes verwenden „uv“ für eine schnelle und zuverlässige Auflösung von Abhängigkeiten. uv funktioniert wie pip, um Python-Pakete zu installieren, aber es ist leistungsfähiger und besser anpassbar. Weitere Informationen zu den uv-Features finden Sie in der Übersicht Features in der uv-Dokumentation.

Container Runtimes suchen nach Abhängigkeitsdateien im gleichen Verzeichnis wie die Einstiegspunkt-Datei Ihrer App. Wenn keine Abhängigkeitsdateien gefunden werden, wird die Suche im Verzeichnisstrukturbaum fortgesetzt, bis das Stammverzeichnis des Quellspeicherorts Ihrer App erreicht ist. Die erste gefundene Abhängigkeitsdatei wird verwendet, um die Abhängigkeiten Ihrer App zu installieren.

Wenn im selben Verzeichnis mehrere Abhängigkeitsdateien vorhanden sind, werden diese in der folgenden Reihenfolge verwendet:

• requirements.txt: Listet die Python-Pakete und -Versionen auf, die für Ihre Streamlit-App erforderlich sind, einschließlich Streamlit selbst. Sie können Ihre Python-Version nicht mit requirements.txt konfigurieren.

  Weitere Informationen zum Format von requirements.txt finden Sie unter Requirements File Format in der pip-Dokumentation.

• pyproject.toml (empfohlen): Verwaltet Ihre Python-Version und Abhängigkeiten. Derzeit wird nur die Python-Version 3.11 unterstützt. Wenn Sie eine pyproject.toml-Datei bereitstellen, erzeugt uv eine uv.lock-Datei, um Ihre Abhängigkeitsversionen zu sperren. Diese Sperrdatei wird immer dann aktualisiert, wenn Sie Ihre Abhängigkeiten aktualisieren. Sie müssen pyproject.toml verwenden, wenn Sie einen anderen Paketindex als PyPI verwenden möchten.

  Weitere Informationen zum Format von pyproject.toml finden Sie unter Writing your pyproject.toml in der Python-Dokumentation.

requirements.txt ist der einfachste Weg, die Abhängigkeiten Ihrer App zu deklarieren, und wird bereitgestellt, um den Einstieg zu erleichtern. Für eine fortgeschrittene Verwaltung von Abhängigkeiten empfiehlt Snowflake jedoch die Verwendung von pyproject.toml. Damit können Sie zum Beispiel Abhängigkeitsversionen sperren, um sicherzustellen, dass Ihre Builds reproduzierbar sind.

In der Regel befinden sich Ihre Einstiegspunkt-Datei und Ihre Abhängigkeitsdatei im Stammverzeichnis Ihres Projektverzeichnisses. Ihre Einstiegspunkt-Datei kann sich jedoch in einem Unterverzeichnis befinden, und Ihre Abhängigkeitsdatei kann sich im selben Verzeichnis oder in einem beliebigen übergeordneten Verzeichnis bis zum Stammverzeichnis Ihres Projekts befinden.

Ihr Projektverzeichnis könnte z. B. eine der folgenden Strukturen haben:

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-Datei¶

So installieren Sie Abhängigkeiten in Ihrer Warehouse Runtime-Umgebung mithilfe einer environment.yml-Datei: Erstellen oder bearbeiten Sie die Datei im Stammverzeichnis des Quellspeicherorts Ihrer App. Wenn Sie keine environment.yml-Datei angeben, verwendet Snowflake nur die für Ihre ausgewählte Umgebung vorinstallierten Pakete. Weitere Informationen über die Struktur von environment.yml finden Sie in der conda-Dokumentation.

Die folgenden Beschränkungen gelten bei der Verwendung von environment.yml-Dateien in Streamlit in Snowflake Warehouse Runtimes:

• Sie können nur den Snowflake Anaconda-Kanal verwenden, um Pakete zu installieren.

• Sie können nur die unter Unterstützte Versionen der Streamlit-Bibliothek in Warehouse Runtimes aufgeführten Streamlit-Versionen verwenden.

• Sie können keine pip-Pakete im Abschnitt dependencies deklarieren, einschließlich relativer Pfade zu lokalen Paketen.

Die folgende environment.yml deklariert Python 3.11 und fünf Python-Pakete:

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

Snowflake empfiehlt, eine Version von Streamlit anzuheften, um zu verhindern, dass die App aktualisiert wird, wenn eine neue Version von Streamlit im Snowflake-Anaconda-Kanal verfügbar wird.

Lokale Entwicklung mit conda¶

Wenn Sie Ihre Warehouse-Laufzeit-App lokal mit conda entwickeln, müssen Sie zusätzliche Details in Ihre environment.yml-Datei aufnehmen, um sicherzustellen, dass die Abhängigkeiten korrekt installiert sind.

• Identifizieren Sie den Snowflake Anaconda-Kanal durch seine URL: https://repo.anaconda.com/pkgs/snowflake.

• Blockieren Sie den Standardkanal.

In Ihrer environment.yml verwenden Sie die folgenden zwei Kanäle:

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

Wenn defaults in Ihrer ~/.condarc-Datei erscheint, kommentieren Sie es aus:

channels:
  # - defaults

Snowsight Paketauswahl¶

Neben der direkten Bearbeitung der environment.yml-Datei für Ihre Warehouse Runtime-App können Sie auch die integrierte Paketauswahl in Snowsight verwenden, um Pakete zur Umgebung Ihrer App hinzuzufügen oder aus dieser zu entfernen. Die Paketauswahl ist nur für Anwendungen verfügbar, die Warehouse Runtimes verwenden. Außerdem zeigt die Paketauswahl nur Pakete an, die mit der aktuellen Python-Version Ihrer App kompatibel sind. Einige Systembibliotheken, die von der Python-Version unabhängig sind, werden möglicherweise nicht in der Paketauswahl angezeigt und müssen manuell zu environment.yml hinzugefügt werden.

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie im Navigationsmenü die Option Projects » Streamlit und dann Ihre Streamlit-App aus.

3. Wählen Sie in der rechten oberen Ecke die Option Edit aus.

4. Wählen Sie in der linken oberen Ecke des Editorbereichs die Option Packages aus.

   Es wird ein Dropdown-Bereich mit ausgewählter Anaconda Packages-Registerkarte angezeigt.

5. Führen Sie eine der folgenden Aktionen aus:

• Um die Python-Version festzulegen, wählen Sie im Python version-Selektor die gewünschte Version aus.

• Um ein Paket hinzuzufügen, verwenden Sie die Suchleiste, um Pakete nach Namen zu suchen, und wählen Sie dann das gewünschte Paket aus.

• Um ein Paket zu entfernen, klicken Sie im Abschnitt Installed Packages auf das Symbol x rechts neben der Paketversion.

• Um die Version eines installierten Pakets festzulegen, verwenden Sie im Abschnitt Installed Packages die Versionsauswahl neben dem Paketnamen.

Snowflake aktualisiert Ihre environment.yml-Datei automatisch und startet die App neu. Wenn Sie die Datei environment.yml im Editor geöffnet haben, aktualisieren Sie die Seite, um die Änderungen zu sehen.