Premiers pas avec les feuilles de calcul

Affichez, gérez et partagez des feuilles de calcul dans Snowsight. Vous pouvez créer des feuilles de calcul et importer des feuilles existantes depuis l”Classic Console.

Les feuilles de calcul SQL vous permettent d’écrire et d’exécuter des instructions SQL, d’explorer et de filtrer les résultats des requêtes, et de visualiser les résultats. Reportez-vous à Interrogation de données à l’aide de feuilles de calcul et Visualisation des données de la feuille de calcul. Vous pouvez également écrire en Snowpark Python dans des feuilles de calcul. Reportez-vous à Écriture de code Snowpark dans des feuilles de calcul Python.

Vous pouvez consulter l’historique des versions des feuilles de calcul et partager des feuilles de calcul avec des collègues qui utilisent également Snowflake. Reportez-vous à Utilisation de feuilles de calcul dans Snowsight.

Dans ce chapitre :

Visualisation des feuilles de calcul dans Snowsight

Après vous être connecté à Snowsight, vous voyez les feuilles de calcul dans votre compte. Si vous ne voyez pas de feuilles de calcul, il se peut que vous deviez importer des feuilles de calcul à partir de l”Classic Console. Reportez-vous à Importer des feuilles de calcul à partir de l”Classic Console.

Les options vous permettent d’afficher les feuilles de calcul que vous avez récemment ouvertes, les feuilles de calcul que vos collègues ont partagées avec vous, les feuilles de calcul que vous avez créées et qui vous appartiennent, ou les dossiers que vous avez créés ou que vos collègues ont partagés avec vous.

Pour chaque feuille de calcul ou dossier de feuille de calcul, vous pouvez consulter le titre, la date approximative de la dernière consultation ou mise à jour de la feuille de calcul ou du dossier, ainsi que le rôle associé à la feuille de calcul ou au dossier. Dans chaque ligne, vous pouvez voir les initiales de l’utilisateur qui est propriétaire de la feuille de calcul ou du dossier. Vous pouvez effectuer un tri selon n’importe quelle colonne du tableau.

Utilisez l’option Search pour rechercher les titres et le contenu des feuilles de calcul et des tableaux de bord auxquels vous pouvez accéder.

Importer des feuilles de calcul à partir de l”Classic Console

Vous pouvez importer vos feuilles de calcul SQL depuis l”Classic Console vers Snowsight à partir de Snowsight.

Importez vos feuilles de calcul SQL pour faciliter la référence aux requêtes et aux instructions SQL que vous avez écrites précédemment, sans avoir à changer d’interface Web et de session.

Note

Vous pouvez importer vos feuilles de calcul dans Snowsight même si vous ne pouvez plus accéder à l”Classic Console.

Pour importer vos feuilles de calcul SQL dans Snowsight, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets.

  3. Sélectionnez le menu plus » Import Worksheets.

  4. Dans la boîte de dialogue de confirmation, sélectionnez Import.

Snowflake crée un dossier nommé Import YYYY-MM-DD et place toutes les feuilles de calcul de l”Classic Console dans ce dossier.

Important

Snowsight a une taille maximale de feuille de calcul de 1MB. L’importation des feuilles de calcul dont la taille est supérieure à 1MB échoue. Reportez-vous à Résolution des problèmes liés à la mise à niveau vers Snowsight.

Après l’importation de feuilles de calcul

Les feuilles de calcul ne sont pas synchronisées entre Snowsight et l”Classic Console. Si vous mettez à jour une feuille de calcul SQL dans Snowsight, les modifications ne sont pas reflétées dans l”Classic Console, et vice versa.

Créer des feuilles de calcul dans Snowsight

Pour créer une feuille de calcul dans Snowsight, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Sélectionnez + et sélectionnez SQL Worksheet ou Python Worksheet pour créer une feuille de calcul.

La feuille de calcul s’ouvre dans la même fenêtre avec la date et l’heure de création comme titre par défaut.

Vous pouvez alors commencer à écrire dans votre feuille de calcul. Pour une feuille de calcul SQL, commencez à rédiger des requêtes. Pour une feuille de calcul Python, commencez à écrire du code.

Pour créer une feuille de calcul SQL à partir d’un fichier SQL existant, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Sélectionnez le menu plus » Create Worksheet from SQL File.

  4. Recherchez le fichier SQL à charger.

  5. Une nouvelle feuille de calcul s’ouvre avec un titre correspondant au nom du fichier.

Vous pouvez également ajouter un fichier SQL à une feuille de calcul SQL existante. Reportez-vous à Ajouter un script SQL à une feuille de calcul existante.

Ouvrir les feuilles de calcul dans des onglets

Vous pouvez utiliser des onglets pour vous référer à plusieurs feuilles de calcul actives et explorer les bases de données et les schémas dans Snowflake tout en écrivant des instructions SQL ou du code Python dans Snowsight. La position de défilement est conservée dans chaque onglet, ce qui facilite les comparaisons entre les feuilles de calcul. Les onglets des feuilles de calcul sont conservés d’une session à l’autre, ce qui vous permet de reprendre votre travail là où vous l’avez laissé.

Pour ouvrir vos feuilles de calcul Snowsight sous forme d’onglets, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets.

  3. Sélectionnez une feuille de calcul existante ou sélectionnez + Worksheet pour ouvrir une nouvelle feuille de calcul. Une feuille de calcul s’ouvre dans un onglet.

  4. Sélectionnez un rôle pour exécuter la feuille de calcul et sélectionnez un entrepôt pour allouer les ressources de calcul à votre requête.

  5. Dans le menu Worksheets, sélectionnez une feuille de calcul existante ou sélectionnez + pour ouvrir un nouvel onglet de feuille de calcul. Par défaut, la nouvelle feuille de calcul utilise votre rôle et votre entrepôt par défaut.

  6. (Facultatif) Modifier le rôle ou l’entrepôt utilisé pour exécuter la nouvelle feuille de calcul.

Après avoir ouvert une feuille de calcul, vous pouvez mettre à jour son contenu, exécuter des instructions SQL ou écrire du code Python, et gérer la feuille de calcul.

Gestion des feuilles de calcul ouvertes

Après avoir ouvert une feuille de calcul, sélectionnez more actions for worksheet, visible lorsque vous survolez l’onglet d’une feuille de calcul, pour gérer la feuille de calcul ouverte de la manière suivante :

  • Renommer la feuille de calcul.

  • Déplacer la feuille de calcul vers un dossier ou un tableau de bord.

  • Dupliquez la feuille de calcul.

  • Supprimez la feuille de calcul.

Lorsque des feuilles de calcul sont ouvertes, vous pouvez également visualiser et gérer d’autres feuilles de calcul dans l’explorateur Worksheets :

  • Recherchez d’autres feuilles de calcul.

  • Sélectionnez More options, visible lorsque vous survolez le nom d’une feuille de calcul, pour renommer, dupliquer, supprimer ou déplacer la feuille de calcul.

  • Identifiez les feuilles de calcul ouvertes dans un onglet à l’aide de l’icône de la feuille de calcul. Une icône remplie indique une feuille de calcul ouverte dans un onglet.

Organisation des feuilles de calcul dans des dossiers

Vous pouvez organiser et gérer les feuilles de calcul dans des dossiers en utilisant Snowsight.

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets.

  3. Sélectionner une feuille de calcul pour l’ouvrir.

  4. Survolez l’onglet de la feuille de calcul et sélectionnez more actions for worksheet.

  5. Dans la liste déroulante, sélectionnez Move et choisissez un dossier ou un tableau de bord, ou créez-en un, vers lequel déplacer la feuille de calcul.

Partage de feuilles de calcul et de dossiers

Snowsight vous permet de partager des feuilles de calcul et des dossiers avec d’autres utilisateurs Snowflake de votre compte afin qu’ils puissent visualiser ou exécuter les feuilles de calcul et les dossiers que vous possédez. Le partage direct avec des utilisateurs n’est possible qu’avec des utilisateurs qui se sont déjà connectés à Snowsight.

Note

Les feuilles de calcul dans Snowsight utilisent des sessions uniques avec des rôles et des entrepôts spécifiques attribués dans le contexte de la feuille de calcul. Si vous partagez une feuille de calcul avec quelqu’un qui n’a pas le même rôle que celui que vous avez utilisé pour exécuter la feuille de calcul, cette personne peut dupliquer la feuille de calcul et l’exécuter sous un de ses propres rôles.

Pour partager une feuille de calcul, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Dans le coin supérieur droit de la feuille de calcul, sélectionnez Share.

  5. Saisissez les noms ou les noms d’utilisateur des utilisateurs Snowflake que vous souhaitez inviter à utiliser votre feuille de calcul. L’annonce ne montre que les utilisateurs qui se sont déjà connectés à Snowsight. Si vous voulez effectuer un partage avec quelqu’un qui ne s’est pas encore connecté à Snowsight, partagez plutôt un lien.

  6. En option, définissez comment les personnes ayant le lien peuvent interagir avec la feuille de calcul. Par défaut, les personnes ayant le lien ne peuvent pas visualiser la feuille de calcul. Par exemple, vous pouvez choisir d’autoriser les personnes à visualiser les résultats de la feuille de calcul, mais pas à exécuter les requêtes dans la feuille de calcul.

  7. Si vous le souhaitez, sélectionnez Get Link pour obtenir un lien vers votre feuille de calcul que vous pourrez partager avec d’autres personnes.

  8. Sélectionnez Done.

Note

Si vous partagez une feuille de calcul provisoire ou une feuille de calcul contenant des modifications que vous n’avez pas encore exécutées, la version de la feuille de calcul partagée est la dernière version exécutée.

Pour partager un dossier, y compris toutes les feuilles de calcul qu’il contient, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez un dossier.

  4. Dans le coin supérieur droit de la Worksheets page, sélectionnez Share.

  5. Saisissez les noms ou les noms d’utilisateur des utilisateurs Snowflake que vous souhaitez inviter dans votre dossier. L’annonce ne montre que les utilisateurs qui se sont déjà connectés à Snowsight. Si vous voulez effectuer un partage avec quelqu’un qui ne s’est pas encore connecté à Snowsight, partagez plutôt un lien.

  6. Si vous le souhaitez, vous pouvez définir comment les personnes ayant le lien peuvent interagir avec le dossier et les feuilles de calcul qu’il contient. Par défaut, les personnes ayant le lien ne peuvent pas voir le dossier ou son contenu. Par exemple, vous pouvez choisir d’autoriser les personnes à visualiser les résultats d’une feuille de calcul, mais pas à exécuter les feuilles de calcul.

  7. Si vous le souhaitez, sélectionnez Get Link pour obtenir un lien vers votre dossier que vous pourrez partager avec d’autres personnes.

  8. Sélectionnez Done.

Objets internes de Snowflake pour les feuilles de calcul

Snowflake crée les objets internes suivants pour prendre en charge l’utilisation des feuilles de calcul dans Snowsight :

Type d’objet

Nom

Intégration de sécurité

WORKSHEETS

Blobs

WORKSHEETS_APP

Base de données

WORKSHEETS_APP

Utilisateur

WORKSHEETS_APP_USER

Rôles

APPADMIN, WORKSHEETS_APP_RL

Ces objets internes sont utilisés pour mettre en cache les résultats des requêtes dans une zone de préparation interne de votre compte. Ces données mises en cache sont cryptées et protégées par la hiérarchie des clés du compte.

Les privilèges limités accordés au rôle interne permettent uniquement à Snowsight d’accéder à la zone de préparation interne pour stocker ces résultats. Le rôle ne peut pas lister les objets de votre compte ou accéder aux données de vos tables.

L’utilisateur et le rôle Snowsight sont renvoyés lorsque vous interrogez les vues USERS et ROLES , respectivement, dans le schéma ACCOUNT_USAGE de la base de données partagée SNOWFLAKE. Les instructions SHOW <objets> ne renvoient pas ces objets internes.