Créer et visualiser une application Streamlit en utilisant Snowsight¶
Attention
Cette fonctionnalité est disponible pour les comptes des régions commerciales AWS et Microsoft Azure. AWS PrivateLink et Azure Private Link ne sont pas pris 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 :
Examinez les Fonctions Streamlit non prises en charge et Limitations supplémentaires lors de l’utilisation de Streamlit in Snowflake.
Assurez-vous que votre compte dispose des privilèges appropriés, comme décrit dans Privilèges requis pour créer et utiliser une application Streamlit.
Pour créer une application Streamlit :
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.
Dans la barre de navigation de gauche, sélectionnez Projects » Streamlit.
Sélectionnez + Streamlit.
La fenêtre Create Streamlit App s’ouvre.
Saisissez un nom pour votre application.
Dans la liste déroulante Warehouse sélectionnez l’entrepôt dans lequel vous souhaitez exécuter votre application et les requêtes.
Dans la liste déroulante App location sélectionnez la base de données et le schéma de votre application.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit dont vous souhaitez visualiser les paquets.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit à laquelle vous souhaitez ajouter un paquet Python.
Dans la partie supérieure de l’éditeur Streamlit, sélectionnez Packages.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit à partir de laquelle vous souhaitez supprimer un paquet Python.
Dans la partie supérieure de l’éditeur Streamlit, sélectionnez Packages.
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 :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit que vous souhaitez afficher.
L’application principale Streamlit s’ouvre dans la visionneuse Streamlit dans Snowflake.
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 :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit que vous souhaitez modifier.
L’application principale Streamlit s’ouvre dans la visionneuse Streamlit dans Snowflake.
Sélectionnez Edit.
L’éditeur Streamlit s’ouvre.
Mettez à jour le code de votre application.
Pour afficher les modifications apportées à l’application, sélectionnez Run.
Renommez une application Streamlit.¶
Pour renommer une application Streamlit :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit que vous souhaitez renommer.
Sélectionnez Edit.
Sélectionnez le nom de l’application dans le coin supérieur gauche.
Saisissez le nouveau nom dans la zone de texte.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit dont vous souhaitez modifier l’entrepôt.
Sélectionnez le nom de l’application dans le coin supérieur gauche.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le privilège CREATE STREAMLIT.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez l’application Streamlit que vous souhaitez supprimer.
Sélectionnez Edit.
Sélectionnez le nom de l’application dans le coin supérieur gauche.
Sélectionnez Delete puis sélectionnez Delete App.
Snowflake supprime l’application Streamlit et affiche la liste actualisée des applications disponibles.