Synchroniser les applications Streamlit in Snowflake avec un référentiel Git

Pour utiliser le contrôle de version avec vos applications Streamlit, vous pouvez synchroniser votre application avec une branche dans un référentiel Git.

Vous devez avoir déjà configuré votre compte Snowflake pour qu’il soit connecté à un référentiel Git et avoir créé une branche dans ce référentiel pour l’utiliser avec votre application. Voir Configuration de Snowflake pour utiliser Git.

Note

Pour les applications Streamlit créées à l’aide de l’ancien paramètre ROOT_LOCATION, l’intégration Git n’est pas prise en charge.

Création d’une application Streamlit in Snowflake à partir d’un fichier dans un référentiel Git

  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. Vous ne pouvez pas les modifier après avoir créé 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 existante avec un référentiel Git

Note

Pour connecter une application Streamlit à un référentiel Git, vous devez utiliser un rôle disposant au minimum des privilèges suivants :

  • OWNERSHIP ou READ dans le référentiel Git

  • USAGE sur le schéma qui contient le référentiel Git

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Streamlit, puis 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 que vous souhaitez synchroniser avec l’application Streamlit.

  5. Sélectionnez Select Folder.

  6. Lorsque l’invite à valider votre application dans le référentiel Git apparaît, effectuez les étapes de validation décrites dans Transférer des modifications dans une branche d’un dépôt Git.

Après avoir connecté votre application Streamlit à un référentiel Git, vous pouvez sélectionner le nom de la branche et ouvrir les détails du référentiel dans Snowflake ou Github.

Transférer des modifications dans une branche d’un dépôt Git

Si une application Streamlit est connectée à une branche dans un référentiel Git, après avoir apporté des modifications à l’application, vous pouvez pousser vos modifications dans la branche.

Note

Vous devez utiliser un rôle avec le privilège OWNERSHIP ou WRITE sur le dépôt Git pour pousser vos modifications.

  1. Connectez-vous à Snowsight.

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

  3. Apportez toutes les modifications pertinentes à l’application Streamlit.

  4. Sélectionnez Push to Git.

  5. Dans la boîte de dialogue Push to Git qui s’affiche, vous pouvez vérifier le nom d’utilisateur et l’adresse e-mail utilisés pour valider les modifications dans la branche et le dépôt spécifiés. Si vous devez mettre à jour le nom d’utilisateur et l’adresse e-mail, développez la section Credentials et mettez à jour les adresses Author name et Author email.

  6. Pour Commit message, saisissez un message à joindre à votre validation.

  7. Développez la section Credentials pour configurer les identifiants de connexion. Saisissez votre jeton d’accès personnel au référentiel Git dans le champ Personal access token. Ce jeton d’accès provient du fournisseur distant de Git, tel que GitHub.

    • Ce jeton est nécessaire pour s’authentifier auprès du référentiel Git.

    • Le jeton doit avoir un accès en lecture et en écriture au contenu du référentiel pour que la validation fonctionne.

    • Une fois saisi, le jeton sera enregistré pour les prochaines validations. Vous pouvez le mettre à jour lors des prochaines validations.

  8. Sélectionnez Push.

Un message de confirmation indique que vos modifications ont été poussées correctement vers votre branche.

Synchroniser une application Streamlit in Snowflake avec une branche distante dans un référentiel Git

Après avoir connecté votre application à une branche d’un référentiel Git, vous pouvez synchroniser toutes les modifications de la branche distante avec votre application Streamlit.

Pour synchroniser une application Streamlit avec une branche distante dans un référentiel Git :

  1. Connectez-vous à Snowsight.

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

  3. Dans l’onglet Files de l’explorateur d’objets de la base de données, sélectionnez Pull.

Snowflake récupère toutes les modifications présentes sur la branche du référentiel distant et fusionne le contenu avec ces modifications.

Fusionner les conflits

Snowflake tente de résoudre les conflits de fusion qui se produisent au cours d’une synchronisation. S’il existe des conflits de fusion que Snowflake n’est pas en mesure de résoudre, vous recevrez un message vous demandant d’abandonner ou de valider vos modifications à une nouvelle branche. Lorsqu’elles sont validées dans une nouvelle branche, utilisez votre fournisseur Git pour fusionner manuellement vos modifications de la nouvelle branche vers la branche d’origine. Ensuite, vous devriez télécharger les dernières mises à jour dans votre application Streamlit.