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.

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 :

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. Ensuite, il vous est demandé de valider votre notebook au référentiel Git. Effectuez les étapes de validation décrites dans la section Valider des modifications dans une branche d’un référentiel Git.

Après avoir connecté votre notebook à 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 sur Github.

Valider des modifications dans une branche d’un référentiel Git¶

Si un notebook Snowflake est lié à une branche dans un référentiel Git, après avoir apporté des modifications au notebook Snowflake, vous pouvez valider vos modifications dans la branche.

Vous devez utiliser un rôle doté du privilège OWNERSHIP ou WRITE sur le référentiel Git pour valider vos modifications. 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 Commit.

5. Dans la boîte de dialogue Commit to Repository 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 référentiel 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 Git distant, 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 Commit.

Un message de confirmation indique que vos modifications ont été validées dans 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.