Créer des notebooks Snowflake¶
Ce chapitre décrit comment créer des Snowflake Notebooks. Vous pouvez accéder à des Snowflake Notebooks par l’intermédiaire de Snowsight. Vous pouvez créer un notebook à l’aide des méthodes suivantes :
Astuce
Vous pouvez également créer un notebook à l’aide de SQL. Voir CREATE NOTEBOOK.
Conditions préalables¶
Suivez les instructions d’installation de pour activer les notebooks.
Vous utilisez un rôle avec les privilèges requis.
Créer un nouveau notebook¶
Pour créer un notebook Snowflake, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Projects » Notebooks dans le menu de navigation de gauche.
Sélectionnez + Notebook.
Saisissez un nom pour votre notebook.
Sélectionnez un Notebook location. Il s’agit de la base de données et du schéma dans lesquels votre notebook sera stocké. Ce paramètre ne peut pas être modifié après la création du notebook.
Note
La liste déroulante Notebook location peut ne pas afficher les bases de données créées après l’ouverture de la boîte de dialogue Créer un notebook. Si vous ne parvenez pas à trouver la base de données, le schéma ou l’entrepôt que vous avez récemment créé, essayez de recharger la fenêtre de votre navigateur.
(Facultatif) Sélectionnez un Query warehouse pour exécuter n’importe quelle requête SQL ou Snowpark émise par le notebook. Pour savoir quelle taille d’entrepôt utiliser, consultez Recommandations de l’entrepôt pour l’utilisation de Snowflake Notebooks.
Sélectionnez un Notebook warehouse pour exécuter des tâches spécifiques au notebook. Snowflake vous recommande d’utiliser SYSTEM$STREAMLIT_NOTEBOOK_WH, un entrepôt géré par Snowflake provisionné dans chaque compte pour l’exécution de notebooks. Pour plus de détails, voir Entrepôt par défaut pour Notebooks.
(Facultatif) Pour enregistrer les sélections actuelles pour les prochains notebooks, cochez la case Remember these settings.
Sélectionnez Create pour créer et ouvrir votre notebook.
Pour obtenir des informations sur l’ajout de cellules, consultez Développez et exécutez du code dans des Snowflake Notebooks.
Créer des Snowflake Notebooks à partir d’un fichier existant¶
Vous pouvez créer un notebook dans Snowflake en important un fichier avec l’extension *.ipynb. Il peut s’agir d’un fichier notebook créé à partir d’une application extérieure à Snowflake.
Connectez-vous à Snowsight.
Sélectionnez Projects » Notebooks.
À côté de + Notebook, ouvrez le menu déroulant et sélectionnez Import .ipynb file.
À l’aide du navigateur de fichiers, recherchez et ouvrez le fichier que vous souhaitez importer.
Saisissez un nom pour votre notebook.
Sélectionnez un Notebook location. Il s’agit de la base de données et du schéma dans lesquels votre notebook sera stocké. Ce paramètre ne peut pas être modifié après la création du notebook.
(Facultatif) Modifiez l’entrepôt sélectionné à utiliser pour exécuter votre notebook.
Pour savoir quelle taille d’entrepôt utiliser, consultez Recommandations de l’entrepôt pour l’utilisation de Snowflake Notebooks.
Sélectionnez Create pour créer et ouvrir votre notebook.
Note
Si votre notebook importe des paquets Python, vous devez ajouter les paquets au notebook avant de pouvoir exécuter le notebook importé. Voir Importer des paquets Python pour les utiliser dans les notebooks. Si le paquet que vous utilisez dans votre notebook importé n’est pas disponible, votre code risque de ne pas fonctionner.
Pour obtenir des informations sur l’ajout de cellules, consultez Développez et exécutez du code dans des Snowflake Notebooks.
Créer un notebook à partir d’un référentiel Git¶
Vous pouvez synchroniser le développement de votre notebook avec un référentiel Git. Vous pouvez ensuite créer des Snowflake Notebooks à partir des notebooks de ce référentiel Git.
Pour créer un notebook à partir d’un fichier dans Git, consultez Créer un notebook à partir d’un fichier dans un référentiel Git.
Dupliquer un notebook existant¶
Vous pouvez dupliquer des Snowflake Notebooks existants. La duplication de notebooks peut s’avérer utile si vous souhaitez, par exemple, tester des modifications de code sans modifier la version d’origine du notebook.
Lorsque vous dupliquez un notebook, le notebook copié est créé avec le même rôle et le même entrepôt que le notebook d’origine, et il est contenu dans la même base de données et le même schéma que le notebook d’origine. Pour cette raison, vous ne pouvez pas dupliquer un notebook pour le déplacer vers une base de données et un schéma différents, ou pour en changer la propriété.
Pour dupliquer un notebook, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Projects » Notebooks.
Ouvrez le notebook que vous souhaitez dupliquer.
Sélectionnez le menu vertical indiqué par une ellipse
puis sélectionnez Duplicate.(Facultatif) saisissez un nom pour le notebook dupliqué, puis sélectionnez Duplicate.
Le notebook est dupliqué.
Dans la boîte de dialogue de confirmation, sélectionnez Close pour revenir au notebook d’origine ou Open notebook pour ouvrir le notebook dupliqué.
Ouvrir un notebook existant¶
Pour ouvrir un notebook existant, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Notebooks.
Passez en revue la liste des notebooks.
Vous pouvez voir tous les notebooks appartenant à votre rôle actif ou à un rôle hérité de votre rôle actif.
Sélectionnez un notebook pour l’ouvrir et le modifier.
Pour plus d’informations sur l’édition des notebooks, consultez Développez et exécutez du code dans des Snowflake Notebooks.
Lorsque vous ouvrez un notebook, vous pouvez voir les résultats mis en cache de la dernière fois que vous avez exécuté des cellules dans le notebook. Le notebook est par défaut dans l’état Not connected mais si vous sélectionnez cet état ou si vous exécutez une cellule, votre notebook se connecte à votre entrepôt virtuel.