Créer et visualiser une application Streamlit en utilisant Snowsight

Attention

Cette fonctionnalité est disponible pour les comptes des régions commerciales AWS. La région AWS PrivateLink n’est pas prise en charge.

Streamlit in Snowflake fournit un éditeur Python dans Snowsight où vous pouvez écrire, modifier et exécuter du code pour une application Streamlit. L’éditeur fournit une auto-complétion et affiche la documentation pour les fonctions Streamlit et Snowpark.

Note

Vous pouvez créer des applications Streamlit à page unique en utilisant Snowsight, mais pour déployer une application Streamlit à pages multiples, vous devez utiliser des commandes SQL. Voir Création d’une application Streamlit en utilisant SQL pour plus de détails.

Après avoir déployé une application Streamlit, vous pouvez visualiser l’application multi-pages dans Snowsight. Consultez Visualiser une application Streamlit pour plus d’informations.

Créer une application Streamlit avec Snowsight

Avant de créer une application Streamlit via Snowsight, vous devez remplir les conditions préalables suivantes :

Pour créer une application Streamlit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur disposant du privilège CREATE STREAMLIT sur le schéma dans lequel vous souhaitez créer l’application.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez + Streamlit.

    La fenêtre Create Streamlit App s’ouvre.

  4. Saisissez un nom pour votre application.

  5. Dans la liste déroulante Warehouse sélectionnez l’entrepôt dans lequel vous souhaitez exécuter votre application et les requêtes.

  6. Dans la liste déroulante App location sélectionnez la base de données et le schéma de votre application.

  7. Sélectionnez Create.

    L’éditeur Streamlit in Snowflake ouvre un exemple d’application Streamlit en mode visualisation. Le mode visualisation vous permet de voir comment l’application Streamlit apparaît yeux des utilisateurs.

L’interface Streamlit in Snowflake se divise en trois volets :

  • Navigateur d’objets : vous permet de voir les bases de données, les schémas et les vues auxquels vous avez le droit d’accéder.

  • Éditeur Streamlit : fournit un éditeur Python pour votre code Streamlit.

  • Aperçu de Streamlit : affiche l’application Streamlit en cours d’exécution.

Par défaut, seuls l’éditeur Streamlit et les volets de prévisualisation sont affichés. Pour modifier l’affichage, utilisez les boutons afficher/masquer dans le coin inférieur gauche de l’éditeur Streamlit dans Snowflake.

Exécuter une application Streamlit dans Streamlit in Snowflake

Pour exécuter une application Streamlit, sélectionnez Run pour mettre à jour le contenu dans le volet d’aperçu Streamlit.

Gérer les paquets pour une application Streamlit

Vous pouvez visualiser, ajouter et supprimer des paquets Python externes pour votre application Streamlit en utilisant l’éditeur Streamlit dans Snowsight.

Voir les paquets installés pour une application Streamlit

Pour afficher les paquets installés pour une application Streamlit, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit dont vous souhaitez visualiser les paquets.

  4. Dans la partie supérieure de l’éditeur Streamlit, sélectionnez Packages.

Snowsight affiche une liste des paquets installés.

Ajouter un paquet Python pris en charge à une application Streamlit

Par défaut, Streamlit in Snowflake installe les paquets python, snowflake-snowpark, et streamlit dans votre environnement. Vous pouvez utiliser Snowsight pour ajouter d’autres paquets. Consultez le canal Anaconda Snowflake pour obtenir une liste des paquets pris en charge.

Pour ajouter un paquetage Python pris en charge à une application Streamlit, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit à laquelle vous souhaitez ajouter un paquet Python.

  4. Dans la partie supérieure de l’éditeur Streamlit, sélectionnez Packages.

  5. Dans le champ de texte de recherche, sélectionnez un paquet dans la liste des paquets pris en charge ou saisissez le nom du paquet.

Supprimer un paquet d’une application Streamlit

Pour supprimer un paquet d’une application Streamlit, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit à partir de laquelle vous souhaitez supprimer un paquet Python.

  4. Dans la partie supérieure de l’éditeur Streamlit, sélectionnez Packages.

  5. Sélectionnez l’icône x à côté du paquet que vous souhaitez supprimer.

Note

Les paquets python, snowflake-snowpark, et streamlit sont installés par défaut et ne peuvent pas être supprimés.

Visualiser une application Streamlit

Voir Privilèges requis pour visualiser une application Streamlit pour plus d’informations sur les privilèges requis pour visualiser une application Streamlit.

Pour visualiser une application Streamlit, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit que vous souhaitez afficher.

    L’application principale Streamlit s’ouvre dans la visionneuse Streamlit dans Snowflake.

  4. Facultatif : si vous consultez une application Streamlit multi-pages, sélectionnez un onglet pour afficher des pages supplémentaires.

Gérer des applications Streamlit

Après avoir créé une application Streamlit, vous pouvez effectuer d’autres tâches connexes décrites dans les sections suivantes.

Modifier une application Streamlit

Pour modifier une application Streamlit, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit que vous souhaitez modifier.

    L’application principale Streamlit s’ouvre dans la visionneuse Streamlit dans Snowflake.

  4. Sélectionnez Edit.

    L’éditeur Streamlit s’ouvre.

  5. Mettez à jour le code de votre application.

  6. Pour afficher les modifications apportées à l’application, sélectionnez Run.

Partagez une application Streamlit

Vous pouvez partager votre application Streamlit avec d’autres utilisateurs de Snowflake assignés à un rôle spécifique. Le partage de votre application Streamlit permet à d’autres utilisateurs d’interagir avec votre application lorsqu’elle est en cours d’exécution.

Pour partager une application Streamlit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit que vous souhaitez partager.

  4. Sélectionnez Share.

    La fenêtre Share Streamlit s’ouvre.

  5. Saisissez le nom du rôle avec lequel vous souhaitez partager votre application Streamlit.

  6. Sélectionnez le nom du rôle.

    Le nouveau rôle apparaît dans la liste des rôles. Ajouter des rôles supplémentaires si nécessaire.

  7. Pour copier l’URL dans votre application Streamlit, sélectionnez Copy to clipboard.

    Vous pouvez ensuite envoyer cette URL par e-mail ou par SMS.

  8. Sélectionnez Done.

Renommez une application Streamlit.

Pour renommer une application Streamlit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit que vous souhaitez renommer.

  4. Sélectionnez Edit.

  5. Sélectionnez le nom de l’application dans le coin supérieur gauche.

  6. Saisissez le nouveau nom dans la zone de texte.

  7. Cliquez en dehors de la zone de texte pour valider la modification.

Modifier l’entrepôt d’une application Streamlit

Lors du développement, des tests et de l’exécution d’une application Streamlit, il se peut que vous souhaitiez modifier l’entrepôt utilisé pour exécuter l’application et les requêtes. Par exemple, il peut être nécessaire d’utiliser un entrepôt de plus grande capacité pour traiter les requêtes exécutées par l’application.

Pour modifier l’entrepôt d’une application Streamlit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit dont vous souhaitez modifier l’entrepôt.

  4. Sélectionnez le nom de l’application dans le coin supérieur gauche.

  5. Sélectionnez le nouvel entrepôt dans la liste déroulante.

Supprimer une application Streamlit

La suppression d’une application Streamlit la retire définitivement de Snowflake. Les utilisateurs avec lesquels vous avez partagé l’application ne seront plus en mesure de voir l’application Streamlit ni d’interagir avec. Avant de supprimer une application Streamlit, assurez-vous que vous avez sauvegardé le code de votre application en dehors de Snowflake.

Pour supprimer une application Streamlit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.

  2. Dans la barre de navigation de gauche, sélectionnez Streamlit.

  3. Sélectionnez l’application Streamlit que vous souhaitez supprimer.

  4. Sélectionnez Edit.

  5. Sélectionnez le nom de l’application dans le coin supérieur gauche.

  6. Sélectionnez Delete puis sélectionnez Delete App.

Snowflake supprime l’application Streamlit et affiche la liste actualisée des applications disponibles.