Synchroniser Snowflake Notebooks avec un référentiel Git¶

Créer un notebook à partir d’un fichier dans un référentiel Git¶

Pour créer un notebook Snowflake à partir d’un fichier dans un référentiel Git, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks.

3. À côté de + Notebook, 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 contiennent le fichier notebook, puis sélectionnez le fichier .ipynb 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 Notebook location, sélectionnez une base de données et un schéma pour contenir le notebook. Ce paramètre ne peut pas être modifié après la création du notebook.

6. Pour Notebook warehouse, sélectionnez un entrepôt.

7. Sélectionnez Create pour créer un notebook Snowflake à partir du fichier .ipynb dans votre référentiel Git.

Lier un notebook existant à un référentiel Git¶

Pour connecter un notebook Snowflake existant à un référentiel Git, procédez comme suit :

Pour savoir comment vous connecter à votre dépôt Git, voir Configuration de Snowflake pour utiliser Git.

Pour plus de détails, voir Exigences en matière de contrôle d’accès.

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks et ouvrez ou créez un notebook Snowflake.

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 le notebook.

5. Sélectionnez Select Folder.

6. Lorsque vous êtes invité à faire un commit et push de votre notebook vers le dépôt Git, suivez les étapes de push vers Git décrites dans Transférer des modifications dans une branche d’un dépôt Git.

   Lorsque votre notebook est poussé correctement vers le dépôt Git, un nouveau dossier est créé pour votre notebook à l’emplacement sélectionné dans la branche du dépôt Git, et tous les fichiers et dossiers de cet emplacement sont synchronisés avec votre notebook. Vous pouvez sélectionner le nom de la branche et ouvrir les détails du dépôt dans Snowflake ou sur Git.

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

Si un notebook Snowflake est connecté à une branche dans un dépôt Git, après avoir apporté des modifications au notebooks, vous pouvez pousser vos modifications vers la branche.

Vous devez utiliser un rôle avec le privilège OWNERSHIP ou WRITE sur le dépôt Git pour pousser vos modifications. Pour plus de détails, voir Exigences en matière de contrôle d’accès.

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks et ouvrez un notebook Snowflake.

3. Apportez toutes les modifications nécessaires au notebook.

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 un notebook avec une branche distante d’un référentiel Git¶

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

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks et ouvrez ou créez un notebook Snowflake.

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

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