Streamlit in Snowflake : activation de l’intégration de Git et de la modification de plusieurs fichiers pour les applications Streamlit in Snowflake (En attente)¶
Attention
Ce changement de comportement fait partie du 2025_01 bundle.
Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.
Les applications Streamlit in Snowflake se comportent comme suit :
- Avant cette modification:
L’intégration Git et la modification de plusieurs fichiers pour les applications Streamlit in Snowflake ne sont pas prises en charge dans Snowsight.
- Après cette modification:
L’intégration Git et la modification de plusieurs fichiers sont prises en charge pour les nouvelles applications Streamlit in Snowflake et comprennent des modifications dans les domaines suivants :
-
Prend en charge la connexion des applications Streamlit in Snowflake à un référentiel Git.
Prend en charge la création d’applications Streamlit in Snowflake à partir d’un référentiel Git.
Prend en charge la modification de plusieurs fichiers au sein même de Snowsight.
Modifications apportées aux commandes CREATE STREAMLIT et ALTER STREAMLIT
Note
Les applications Streamlit in Snowflake existantes utilisant ROOT_LOCATION fonctionnent comme avant, mais l’intégration Git et la modification de plusieurs fichiers ne sont pas prises en charge.
-
Snowsight¶
Création d’une application Streamlit in Snowflake à partir d’un fichier dans un référentiel Git¶
Pour créer une application Streamlit à partir d’un fichier dans un référentiel Git, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Projects » Streamlit.
À côté de + Streamlit, ouvrez le menu déroulant et sélectionnez Create from repository.
Pour File location in repository, sélectionnez le référentiel et la branche du référentiel qui contient le fichier d’application Streamlit, puis sélectionnez le fichier
.py
spécifique. Pour des informations détaillées sur la connexion de Snowflake à votre référentiel Git, voir Configuration de Snowflake pour utiliser Git.Pour App location, sélectionnez une base de données et un schéma pour contenir l’application Streamlit. Ils ne peuvent pas être modifiés après la création de l’application.
Pour Query warehouse et App warehouse, sélectionnez un entrepôt.
Sélectionnez Create pour créer une application Streamlit à partir du fichier
.py
de votre référentiel Git.
Connexion d’une application Streamlit in Snowflake à un référentiel Git¶
Pour connecter une application Streamlit existante à un référentiel Git, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Projects » Streamlit et ouvrez ou créez une application Streamlit.
Dans l’onglet Files, à côté de l’explorateur d’objets de base de données, sélectionnez Connect Git Repository.
Pour File location in repository, sélectionnez le référentiel et la branche du référentiel avec lesquels vous souhaitez synchroniser l’application Streamlit.
Sélectionnez Select Folder.
Lorsque vous êtes invité(e) à valider et à pousser votre application dans le référentiel Git, sélectionnez Push to Git.
Modification de plusieurs fichiers au sein de Snowsight¶
Pour modifier plusieurs fichiers de votre application Streamlit in Snowflake dans Snowsight :
Connectez-vous à Snowsight.
Sélectionnez Projects » Streamlit et ouvrez ou créez une application Streamlit.
Dans l’onglet Files, sélectionnez un fichier à modifier.
Modifications apportées aux commandes CREATE STREAMLIT et ALTER STREAMLIT¶
Lorsque ce bundle de changements de comportement est activé, les modifications suivantes sont apportées aux commandes CREATE STREAMLIT et ALTER STREAMLIT.
CREATE STREAMLIT¶
Le code des applications Streamlit ne nécessite plus d’objet de zone de préparation distinct ; l’objet Streamlit stocke le code de l’application. À l’aide de la clause FROM, vous pouvez indiquer l’emplacement existant à partir duquel copier le code dans l’application Streamlit.
Syntaxe¶
CREATE [ OR REPLACE ] STREAMLIT [ IF NOT EXISTS ] <name>
[ { VERSION <version_alias_name> |
VERSION (COMMENT = <version_comment>) |
VERSION <version_alias_name> (COMMENT = <version_comment>) } ]
[ FROM <source_location>]
MAIN_FILE = '<path_to_main_file_in_root_directory>'
QUERY_WAREHOUSE = <warehouse_name>
[ COMMENT = <create_comment> ]
[ DEFAULT_VERSION = <default_version_name_or_alias> ]
[ TITLE = '<app_title>' ]
[ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
[ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]
Paramètres requis¶
name
Nom de l’appli Streamlit.
path_to_main_file_in_root_directory
Spécifie le nom de fichier de l’application Streamlit. Ce nom de fichier est relatif à la valeur de
ROOT_LOCATION
.warehouse_name
Spécifie l’entrepôt dans lequel seront exécutées les requêtes SQL émises par l’application Streamlit.
Paramètres facultatifs¶
version_alias_name
Nom d’alias de version spécifié par l’utilisateur.
version_comment
Commentaire fourni par l’utilisateur pour cette version.
source_location
Emplacement à partir duquel les fichiers sources sont copiés.
create_comment
Spécifie un commentaire pour l’objet Streamlit. Par défaut, aucune valeur n’est spécifiée.
default_version_name_or_alias
Nom de la version par défaut utilisée.
app_title
Spécifie un titre pour l’application Streamlit à afficher dans Snowsight.
stage_path_and_file_name_to_read
L’emplacement (zone de préparation), le chemin et le nom du ou des fichiers à importer.
integration_name
Noms des intégrations d’accès externe nécessaires pour que le code de l’application Streamlit puisse accéder aux réseaux externes.
Exemples¶
Pour créer une application Streamlit à partir d’une zone de préparation, exécutez la commande CREATE STREAMLIT, comme indiqué dans l’exemple suivant :
CREATE STREAMLIT app
FROM @streamlit_db.streamlit_schema.streamlit_stage;
MAIN_FILE = 'streamlit_app.py'
QUERY_WAREHOUSE = my_warehouse;
Pour créer une application Streamlit à partir d’un référentiel Git, exécutez la commande CREATE STREAMLIT, comme indiqué dans l’exemple suivant :
CREATE STREAMLIT app
FROM @streamlit_db.streamlit_schema.streamlit_repo/branches/streamlit_branch/;
MAIN_FILE = 'streamlit_app.py'
QUERY_WAREHOUSE = my_warehouse;
ALTER STREAMLIT¶
Lorsque ce bundle de changements de comportement est activé, la commande ALTER STREAMLIT est mise à jour de sorte à inclure ce qui suit :
Syntaxe¶
ALTER STREAMLIT <name> ADD VERSION [ [ IF NOT EXISTS] <version_alias_name> ]
FROM <source_location>
[ COMMENT = <add_version_comment> ]
ALTER STREAMLIT <name> ADD VERSION <version_name>
FROM { <snowgit_tag_uri> | <snowgit_commit_uri> }
[ COMMENT = <git_pull_comment> ]
ALTER STREAMLIT <name> ADD LIVE VERSION [ [IF NOT EXISTS] <version_alias_name> ]
[ FROM LAST ]
[ COMMENT = <add_version_comment> ]
ALTER STREAMLIT <name> VERSION <existing_version_name_or_alias>
SET ALIAS = <new_version_name_alias>
ALTER STREAMLIT <name> COMMIT [ VERSION <live_version_alias> ] [COMMENT = <version_comment>]
ALTER STREAMLIT <name> SET DEFAULT_VERSION = <version_name> | <version_name_alias>
ALTER STREAMLIT <name> PUSH [TO <git_branch_uri>] [ { GIT_CREDENTIALS = <snowflake_secret> | USERNAME = <git_username> password = <git_password> } NAME = <git_author_name> EMAIL = <git_author_email> ] [ COMMENT = <git_push_comment>]
ALTER STREAMLIT <name> ABORT [ VERSION <live_version_alias> ]
ALTER STREAMLIT <name> PULL
Paramètres¶
name
Nom de l’appli Streamlit.
version_alias_name
Nom d’alias de version spécifié par l’utilisateur.
source_location
Emplacement à partir duquel les fichiers sources sont copiés. Nécessite le privilège OWNERSHIP.
ALTER STREAMLIT name PUSH
Pousse les dernières modifications validées vers le référentiel Git, en utilisant la branche stockée dans la version de base si
git_branch_uri
n’est pas spécifié.Si la version de base n’est pas basée sur une branche Git, une erreur est générée. Nécessite le privilège OWNERSHIP.
git-branch-uri
Branche cible vers laquelle pousser les modifications validées.
git_author_name
Nom de l’auteur Git à utiliser.
git_author_email
Adresse e-mail valide à utiliser comme nom d’auteur Git.
git_push_comment
Commentaire spécifié par l’utilisateur à inclure dans la commande git push.
ALTER STREAMLIT name ABORT
Supprime une version existante et efface ses fichiers. Si aucune version n’est spécifiée, live_version est supprimé par défaut. Nécessite le privilège OWNERSHIP.
ALTER STREAMLIT name PULL
Extrait les dernières modifications de la source vers la version en direct de ce Streamlit. Nécessite le privilège OWNERSHIP.
Nouvelles colonnes dans la sortie DESCRIBE STREAMLIT¶
Lorsque ce bundle de changements de comportement est activé, la sortie de la commande DESCRIBE STREAMLIT comprend les nouvelles colonnes suivantes :
Nom de la colonne |
Description |
---|---|
default_version |
Pour une utilisation future. |
nom_de_la_version_par_défaut |
Pour une utilisation future. |
default_version_alias |
Pour une utilisation future. |
default_version_location_uri |
Pour une utilisation future. |
default_version_source_location_uri |
Pour une utilisation future. |
default_version_git_commit_hash |
Pour une utilisation future. |
live_version |
Chaîne. Indique quelle version est la version en direct pour cette application. |
live_version_name |
Chaîne. Nom de la version en direct pour cette application. |
live_version_alias |
Chaîne. Alias de la version en direct pour cette application. |
live_version_location_uri |
Chaîne. URI au niveau duquel sont stockés les fichiers de la version en direct. |
live_version_source_location_uri |
Chaîne. Spécifie l’URI à partir duquel la version en direct a été copiée. Null si cette application Streamlit n’a pas été clonée. |
live_version_git_commit_hash |
Chaîne. Hachage hexadécimal de la commande git commit vers lequel pointe la live_version. Null si un référentiel Git n’est pas connecté. |
Réf : 1888