Premiers pas avec Streamlit in Snowflake¶

Cette rubrique vous guide à travers le déploiement de votre première application Streamlit in Snowflake en moins de cinq minutes en utilisant un runtime de conteneur. Ensuite, deux exemples pratiques vous montreront comment créer des applications réelles qui interrogent les données, personnaliser l’expérience de chaque lecteur et réécrire dans Snowflake.

Conditions préalables¶

Avant de pouvoir créer une application Streamlit, assurez-vous que votre administrateur a effectué la configuration de sécurité essentielle pour les applications Streamlit.

Votre rôle doit disposer des privilèges suivants :


Privilège	Objet	Remarques
USAGE	Base de données dans laquelle vous créez l’application Streamlit
CREATE STREAMLIT, USAGE	Schéma dans lequel vous créez l’application Streamlit
USAGE	Pool de calcul qui exécute l’application Streamlit	Pour tous les comptes, Snowflake configure un pool de calcul à usage général auquel les utilisateurs standard auront accès. Pour plus d’informations, voir Configuration de vos propres pools de calcul pour les applications Streamlit.
USAGE	Entrepôt qui exécute des requêtes dans l’application Streamlit

Pour plus d’informations, voir Privilèges requis pour créer et utiliser une application Streamlit.

Déployer votre première application Streamlit in Snowflake¶

La façon la plus rapide de démarrer est de créer une application Streamlit en utilisant le code de démarrage par défaut. Lorsque vous créez une application sans spécifier les fichiers sources, Snowflake fournit automatiquement un exemple de code.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Projects » Streamlit.
Sélectionnez + Streamlit App.
Saisissez un nom pour votre application.
Sélectionnez une base de données et un schéma dans lesquels créer votre application.
Sélectionnez Run on container.
Sélectionnez un pool de calcul et un entrepôt de requêtes.
Sélectionnez Create.

Snowsight vous redirige vers l’éditeur d’applications. Votre application sera prête dans quelques minutes. Ensuite, vous pouvez la consulter et la modifier sur le champ.

Exécutez les commandes SQL suivantes dans une session SQL :

CREATE STREAMLIT my_first_app
   RUNTIME_NAME = 'SYSTEM$ST_CONTAINER_RUNTIME_PY3_11'
   COMPUTE_POOL = my_compute_pool
   QUERY_WAREHOUSE = my_warehouse;

ALTER STREAMLIT my_first_app ADD LIVE VERSION FROM LAST;

Pour voir votre application, connectez-vous à Snowsight, puis dans le menu de navigation, sélectionnez Projects » Streamlit, et sélectionnez votre application.

Note

Snowflake CLI version 3.14.0 ou ultérieure est requise. La version 3.14+ utilise par défaut la syntaxe moderne CREATE STREAMLIT.

Initialisez un nouveau projet Streamlit :
```
snow init my_first_app --template example_streamlit
```
Accédez au répertoire du projet :
```
cd my_first_app
```

Modifiez le fichier snowflake.yml pour utiliser un runtime de conteneur :

definition_version: 2
entities:
   my_streamlit:
      type: streamlit
      identifier: my_first_app
      query_warehouse: my_warehouse
      compute_pool: my_compute_pool
      runtime_name: SYSTEM$ST_CONTAINER_RUNTIME_PY3_11
      main_file: streamlit_app.py
      artifacts:
      - streamlit_app.py

Déployez l’application et ouvrez-la dans votre navigateur :
```
snow streamlit deploy --open
```

Modifier votre application¶

Après le déploiement, vous pouvez modifier le code de l’application pour le personnaliser. Pour un test rapide :

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Projects » Streamlit, puis sélectionnez votre application.
Sélectionnez Edit.
Modifiez le code dans streamlit_app.py.
Sélectionnez Run pour voir vos modifications.

Obtenez l’emplacement source de votre application :
```
DESCRIBE STREAMLIT my_first_app;
```

Copiez un fichier mis à jour à cet emplacement :

COPY FILES INTO '<live_version_location_uri>' FROM @my_stage FILES = ('streamlit_app.py');

Modifiez streamlit_app.py dans le répertoire de votre projet local.
Redéployez :
```
snow streamlit deploy --replace
```

Pour plus d’informations, voir Modifier votre application Streamlit.

Quelle est la prochaine étape ?¶

Maintenant que vous avez une application en cours d’exécution, essayez l’un de ces exemples pratiques :

Exemple : Création d’un tableau de bord de données personnalisé : Créez un tableau de bord qui interroge les données Snowflake et personnalise l’affichage pour chaque lecteur à l’aide de:code:st.connection et:code:st.user.
Exemple : Créer un formulaire qui écrit dans Snowflake : Créez un formulaire qui réécrit la saisie de l’utilisateur dans une table Snowflake, en démontrant st.form, la gestion des dépendances et st.user.

Pour en savoir plus sur des sujets spécifiques :

Créer votre application Streamlit : Instructions détaillées pour créer des applications à partir de Snowsight, SQL, ou la CLI.
Gérer les dépendances de votre application Streamlit : Ajoutez des paquets Python à votre application.
Environnements d’exécution pour les applications Streamlit : Comprend les runtimes de conteneur et d’entrepôt.
Accès au réseau externe dans Streamlit in Snowflake : Connectez votre application à des services externes.