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 :

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 :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Streamlit.

  3. À côté de + Streamlit, ouvrez le menu déroulant et sélectionnez Create from repository.

  4. 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.

  5. 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.

  6. Pour Query warehouse et App warehouse, sélectionnez un entrepôt.

  7. 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 :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Streamlit et ouvrez ou créez une application Streamlit.

  3. Dans l’onglet Files, à côté de l’explorateur d’objets de base de données, sélectionnez Connect Git Repository.

  4. 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.

  5. Sélectionnez Select Folder.

  6. 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 :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Streamlit et ouvrez ou créez une application Streamlit.

  3. 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> [ , ... ] ) ]
Copy
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;
Copy

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

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
Copy

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