Gérer les dépendances de votre application Streamlit¶

Versions prises en charge de la bibliothèque Streamlit dans les environnements d’exécution d’entrepôt¶

Streamlit in Snowflake prend en charge les versions suivantes de la bibliothèque open-source 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

Intégrations d’accès externes pour les environnements d’exécution de conteneurs¶

Pour une vue d’ensemble des intégrations d’accès externe (EAIs), voir Vue d’ensemble de l’accès au réseau externe.

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

Fichiers de dépendance¶

Les environnements d’exécution des conteneurs utilisent uv pour une résolution rapide et fiable des dépendances. uv fonctionne comme pip pour installer des paquets Python, mais il est plus performant et personnalisable. Pour plus d’informations sur les fonctions d’uv, voir la vue d’ensemble des fonctionnalités dans la documentation d’uv.

Les environnements d’exécution des conteneurs recherchent les fichiers de dépendances dans le même répertoire que le fichier de point d’entrée de votre application. Si aucun fichier de dépendance n’est trouvé, la recherche continue dans l’arborescence des répertoires jusqu’à atteindre la racine de l’emplacement source de votre application. Le premier fichier de dépendance trouvé est utilisé pour installer les dépendances de votre appli.

Lorsque plusieurs fichiers de dépendances existent dans le même répertoire, ils sont utilisés dans l’ordre de préséance suivant :

• requirements.txt : Répertorie les paquets Python et les versions requis par votre application Streamlit, y compris Streamlit lui-même. Vous ne pouvez pas configurer votre version de Python avec requirements.txt.

  Pour plus d’informations sur le format de requirements.txt, voir Formats de fichier requis dans la documentation de pip.

• pyproject.toml (recommandé) : gère votre version de Python et vos dépendances. Actuellement, seule la version 3.11 de Python est prise en charge. Lorsque vous fournissez un fichier pyproject.toml, uv génère un fichier uv.lock pour verrouiller les versions de vos dépendances. Ce fichier de verrouillage sera mis à jour chaque fois que vous mettez à jour vos dépendances. Vous devez utiliser pyproject.toml si vous souhaitez utiliser un index de paquets différent de PyPI.

  Pour plus d’informations sur le format des pyproject.toml, voir Écrire votre pyproject.toml dans la documentation Python.

requirements.txt est le moyen le plus simple de déclarer les dépendances de votre appli et est fourni pour faciliter la prise en main. Cependant, pour une gestion des dépendances plus avancée, Snowflake recommande d’utiliser pyproject.toml à la place. Par exemple, cela vous permet de verrouiller les versions des dépendances pour garantir que vos constructions soient reproductibles.

Il arrive souvent que votre fichier de point d’entrée et votre fichier de dépendance se trouvent à la racine du répertoire de votre projet. Cependant, votre fichier de point d’entrée peut se trouver dans un sous-répertoire et votre fichier de dépendance peut se trouver dans le même répertoire ou dans tout parent jusqu’à la racine de votre projet.

Par exemple, votre répertoire de projet peut avoir l’une des structures suivantes :

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

fichier environment.yml¶

Pour installer des dépendances dans l’environnement d’exécution de votre entrepôt à l’aide d’un fichier environment.yml, créez ou modifiez le fichier à la racine de l’emplacement source de votre application. Si vous ne fournissez pas de fichier environment.yml, Snowflake utilise uniquement les paquets préinstallés pour votre environnement sélectionné. Pour plus d’informations sur la structure de environment.yml, voir la documentation de conda ` <https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-file-manually>`_.

Les limites suivantes s’appliquent lors de l’utilisation de fichiers environment.yml dans les environnements d’exécution d’entrepôt Streamlit in Snowflake :

• Vous ne pouvez utiliser le canal Anaconda de Snowflake que pour installer des paquets.

• Vous ne pouvez utiliser que les versions de Streamlit répertoriées dans Versions prises en charge de la bibliothèque Streamlit dans les environnements d’exécution d’entrepôt.

• Vous ne pouvez pas déclarer des paquets pip dans la section dependencies, y compris les chemins relatifs vers les paquets locaux.

Le fichier environment.yml suivant déclare Python 3.11 et cinq paquets 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 recommande d’épingler une version de Streamlit pour éviter que l’application ne soit mise à niveau lorsqu’une nouvelle version de Streamlit est disponible dans le canal Anaconda de Snowflake.

Développement local avec conda¶

Lorsque vous développez votre application d’exécution d’entrepôt localement avec conda, vous devez inclure des détails supplémentaires dans votre fichier environment.yml pour que les dépendances soient installées correctement.

• Identifiez le canal Anaconda de Snowflake par son URL: https://repo.anaconda.com/pkgs/snowflake.

• Bloquez le canal par défaut.

Dans votre fichier environment.yml, utilisez les deux canaux suivants :

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

Si defaults apparaît dans votre fichier ~/.condarc, commentez-le :

channels:
  # - defaults

Sélecteur de paquets Snowsight¶

Outre la modification du fichier environment.yml directement pour votre application d’exécution d’entrepôt, vous pouvez également utiliser le sélecteur de paquets intégré dans Snowsight pour ajouter ou supprimer des paquets dans l’environnement de votre application. Le sélecteur de paquets n’est disponible que pour les applications utilisant des environnements d’exécution d’entrepôt. En outre, le sélecteur de paquets n’affiche que les paquets compatibles avec la version Python actuelle de votre application. Certaines bibliothèques système qui sont indépendantes de la version Python peuvent ne pas être affichées dans le sélecteur de paquets et doivent être ajoutées manuellement à environment.yml.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects, » Streamlit puis votre application Streamlit.

3. Dans le coin supérieur droit, sélectionnez Edit.

4. Dans le coin supérieur gauche du panneau de l’éditeur, sélectionnez Packages.

   Un volet déroulant apparaît avec l’onglet Anaconda Packages sélectionné.

5. Effectuez une des actions suivantes :

• Pour définir la version de Python, dans le sélecteur Python version, choisissez la version souhaitée.

• Pour ajouter un paquet, utilisez la barre de recherche pour rechercher des paquets par leur nom, puis sélectionnez le paquet souhaité.

• Pour supprimer un paquet, dans la section Installed Packages, sélectionnez l’cône x à droite de la version du paquet.

• Pour définir la version d’un paquet installé, dans la section Installed Packages, utilisez le sélecteur de version à côté du nom du paquet.

Snowflake met automatiquement à jour le fichier environment.yml et redémarre votre application. Si le fichier” environment.yml est ouvert dans l’éditeur, actualisez la page pour voir les modifications.