Créer des notebooks Snowflake

Cette rubrique explique comment créer Snowflake Notebooks sur un environnement d’exécution d’entrepôt. Vous pouvez également créer Snowflake Notebooks sur l’environnement d’exécution du conteneur pour ML. Pour plus de détails, voir Créer un notebook sur Container Runtime pour ML.

Vous pouvez accéder aux notebooks par le biais de Snowsight, où vous pouvez :

Astuce

Vous pouvez également créer un notebook à l’aide de SQL. Voir CREATE NOTEBOOK.

Conditions préalables

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. Plusieurs options s’offrent à vous lorsque vous créez un nouveau notebook :

    • Pour créer un notebook appartenant à un rôle, sélectionnez votre rôle principal actuel dans la liste déroulante Creating as.

    • Pour créer un notebook privé appartenant à l’utilisateur, sélectionnez votre nom d’utilisateur dans la liste déroulante Creating as.

    • Pour créer un notebook à partir d’un fichier existant, tel qu’un fichier de notebook créé à partir d’une application autre que Snowflake, sélectionnez la flèche vers le bas à côté de + Notebook puis sélectionnez Import .ipynb file. Ouvrez le fichier à importer.

    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.

  5. Saisissez un nom pour votre notebook.

    Note

    Si vous utilisez une région AWS, vous pouvez spécifier l’environnement d’exécution de votre notebook : soit le Container Runtime pour ML, soit l’environnement d’exécution de l’entrepôt.

  6. 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. Si vous créez un notebook privé après l’activation des bases de données personnelles pour votre compte, votre base de données personnelle sera préremplie par défaut sous Notebook location. Toutefois, si vous créez un notebook privé et qu’il n’y a qu’un seul schéma dans votre base de données personnelle, les options Notebook location ne sont pas disponibles.

    Note

    La liste déroulante Notebook location peut ne pas afficher les bases de données qui ont été créées après l’ouverture de la boîte de dialogue Create 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.

    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.

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

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

  9. 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 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 Plus d'actions pour la feuille de calcul, 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.

  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.