Créer un notebook¶

Conditions préalables¶

• Vous avez configuré et activé les notebooks.

• Vous utilisez un rôle avec les privilèges requis.

Créer un nouveau notebook¶

Vous pouvez créer un nouveau notebook en sélectionnant + Notebook, ou vous pouvez importer un fichier portant l’extension *.ipynb. Il peut s’agir d’un fichier notebook créé à partir d’une application extérieure à Snowflake.

Pour créer un nouveau notebook, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks dans le menu de navigation de gauche.

3. Sélectionnez + Notebook.

4. Saisissez un nom pour votre notebook. Snowflake conserve la casse exacte du nom du notebook tel qu’il a été saisi, y compris pour les noms contenant des espaces. Les noms des notebooks sont sensibles à la casse.

   Note

   Si vous utilisez une région AWS, vous pouvez spécifier l’environnement d’exécution de votre notebook : Warehouse Runtime ou Container Runtime.

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

   Il se peut que la liste Notebook location n’affiche pas les bases de données créées après l’ouverture de la boîte de dialogue Create Notebook. Si vous ne trouvez pas la base de données, le schéma ou l’entrepôt que vous venez de créer, essayez de recharger la fenêtre de votre navigateur.

   La requête de données dans le notebook n’est pas limitée à cet emplacement. Dans le notebook, vous pouvez effectuer des requêtes sur les données de tous les emplacements auxquels vous avez accès. Pour spécifier l’emplacement, exécutez USE WAREHOUSE et USE SCHEMA.

6. Sélectionnez Run on warehouse ou Run on container comme environnement Python.

7. (Facultatif) Sélectionnez un Query warehouse pour exécuter n’importe quelle requête SQL ou Snowpark émise par le notebook.

8. 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 et provisionné dans chaque compte pour l’exécution de notebooks.

9. Sélectionnez Create pour créer et ouvrir votre notebook.

Pour créer un nouveau notebook à partir d’un fichier existant, procédez comme suit :

1. Sélectionnez la flèche vers le bas à côté de + Notebook, puis sélectionnez Import .ipynb file.

2. Ouvrez le fichier à importer, par exemple un fichier de notebook créé à partir d’une application autre que Snowflake.

   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.

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 à l’aide de SQL¶

Vous pouvez créer un notebook à l’aide de la commande CREATE NOTEBOOK. Cette commande vous permet de définir par programmation l’emplacement, le fichier principal et la source de la version du notebook. Toutefois, lorsque vous créez un notebook à l’aide de SQL, celui-ci n’inclut pas automatiquement une version en direct. Une version en direct est exigée pour pouvoir exécuter le notebook à l’aide de la commande EXECUTE NOTEBOOK.

Si vous tentez d’exécuter un notebook qui n’a pas de version en direct, ou si le notebook a été abandonné et recréé, l’erreur suivante s’affiche :

Live version is not found.

Pour résoudre ce problème, ajoutez une version en direct au notebook avant de l’exécuter, comme le montre l’exemple suivant :

ALTER NOTEBOOK DB_NAME.SCHEMA_NAME.NOTEBOOK_NAME ADD LIVE VERSION FROM LAST;

• DB_NAME est le nom de la base de données qui contient le notebook

• SCHEMA_NAME est le nom du schéma qui contient le notebook

• NOTEBOOK_NAME est le nom du notebook

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 :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks.

3. Ouvrez le notebook que vous souhaitez dupliquer.

4. Sélectionnez le menu des points de suspension verticaux , puis Duplicate.

5. (Facultatif) Saisissez un nom pour le notebook dupliqué, puis sélectionnez Duplicate.

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

1. Connectez-vous à Snowsight.

2. Sélectionnez Notebooks.

   Note

   Les notebooks récemment utilisés apparaissent également dans l”Snowsight. Sous Recently viewed, sélectionnez Notebooks.

3. 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. Chaque notebook affiche les informations suivantes :

   • Title : le titre du notebook

   • Viewed : la dernière fois que le notebook a été consulté

   • Updated : la dernière fois que le notebook a été exécuté

   • Environment : l’environnement d’exécution du notebook (Container Runtime ou Warehouse Runtime)

   • Location : l’emplacement de la base de données et du schéma correspondant au notebook

   • Owner : le propriétaire du notebook

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