Gestion et utilisation de feuilles de calcul dans Snowsight

Les feuilles de calcul constituent une méthode puissante et polyvalente d’exécution des requêtes SQL ou de code Python, ainsi que d’autres tâches de chargement, de définition et de manipulation de données Snowflake.

Après avoir ouvert une feuille de calcul dans Snowsight, vous pouvez effectuer l’une des opérations suivantes :

En outre, vous pouvez écrire des instructions SQL et visualiser les résultats. Vous pouvez également écrire du code Python.

Parcourir d’autres feuilles de calcul à partir d’une feuille de calcul

Lorsque vous ouvrez une feuille de calcul, vous pouvez visualiser d’autres feuilles de calcul dans l’explorateur Worksheets. Vous pouvez rechercher d’autres feuilles de calcul et gérer des feuilles de calcul à partir de l’explorateur Worksheets.

Prévisualisation du contenu des feuilles de calcul

Pour prévisualiser le contenu d’une feuille de calcul, vous pouvez survoler le nom de la feuille dans l’explorateur Worksheets. La prévisualisation montre également le rôle utilisé pour exécuter la feuille de calcul.

À partir de la prévisualisation, vous pouvez également copier le contenu de la feuille de calcul. Survolez l’aperçu du contenu de la feuille de calcul et sélectionnez le bouton Copy qui apparaît.

Mettre à jour les feuilles de calcul avec des raccourcis clavier

Snowsight fournit des raccourcis clavier pour vous aider à naviguer et à modifier rapidement des requêtes dans les feuilles de calcul. Par exemple, vous pouvez déplacer votre curseur dans une feuille de calcul, effectuer des recherches et des remplacements, copier des lignes, formater des requêtes, etc. à l’aide de touches de raccourci.

Pour voir tous les raccourcis clavier disponibles, ouvrez une feuille de calcul et appuyez sur [CMD]+[SHIFT]+[?] sur un clavier Mac ou [CTRL]+[SHIFT]+[?] sur un clavier Windows.

Vous pouvez également survoler l’onglet de la feuille de calcul et sélectionner Plus d'actions pour la feuille de calcul, puis Show Shortcuts pour afficher les raccourcis.

Modifier le contexte de session d’une feuille de calcul

Définissez le contexte de session d’une feuille de calcul afin de définir le rôle et l’entrepôt à utiliser pour exécuter le contenu une feuille de calcul. Le contexte de la feuille de calcul est préservé pour les sessions suivantes.

Note

Vous ne pouvez pas choisir plusieurs rôles. Le sélecteur de contexte ne prend pas en charge les rôles secondaires. Pour activer les rôles secondaires dans une feuille de calcul SQL, exécutez USE SECONDARY ROLES.

Le contexte de rôle d’une feuille de calcul détermine quelles opérations peuvent être effectuées sur les objets Snowflake en fonction des privilèges de contrôle d’accès accordés au rôle.

Pour définir le contexte de session d’une feuille de calcul, procédez comme suit :

  1. Connectez-vous à Snowsight.

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

  3. Ouvrez une feuille de calcul.

  4. Ouvrez le sélecteur de contexte.

  5. Sélectionnez un rôle pour exécuter la feuille de calcul.

  6. Sélectionnez un entrepôt que le rôle peut utiliser (grâce à ses privilèges).

  7. Sélectionnez n’importe quel endroit en dehors de la liste déroulante pour fermer le sélecteur de contexte.

Note

Chaque feuille de calcul est une session unique et peut utiliser des rôles différents de celui que vous avez sélectionné dans le menu de compte (votre rôle actif). Le changement de votre rôle actif ne modifie pas le rôle attribué à la feuille de calcul avec le sélecteur de contexte.

Reprise et redimensionnement des entrepôts

Avant ou après avoir exécuté votre feuille de calcul, vous pouvez avoir besoin de reprendre ou de redimensionner votre entrepôt.

Vous devez avoir les privilèges MODIFY ou OWNERSHIP sur l’entrepôt pour modifier les détails de l’entrepôt.

Pour afficher et ajuster les détails de l’entrepôt à l’aide du sélecteur de contexte, procédez comme suit :

  1. Connectez-vous à Snowsight.

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

  3. Ouvrez une feuille de calcul.

  4. Ouvrez le sélecteur de contexte.

  5. Sélectionnez l’icône Show warehouse details.

  6. Pour l’option Status , sélectionnez le statut et choisissez Resume si l’entrepôt est suspendu.

  7. Pour l’option Size , sélectionnez la taille et choisissez une autre taille.

  8. Sélectionnez n’importe quel endroit en dehors de la liste déroulante pour fermer le sélecteur de contexte.

Gestion des feuilles de calcul ouvertes

Après avoir ouvert une feuille de calcul, sélectionnez le Plus d'actions pour la feuille de calcul visible lorsque vous survolez l’onglet d’une feuille de calcul, pour gérer la feuille de calcul ouverte des manières suivantes :

Lorsqu’une feuille de calcul est ouverte, vous pouvez également visualiser et gérer d’autres feuilles de calcul dans l’explorateur Worksheets :

  • Recherchez d’autres feuilles de calcul.

  • Renommer, dupliquer, supprimer ou déplacer la feuille de calcul en utilisant le Plus d'options visible lorsque vous survolez le nom d’une 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 Projects » Worksheets.

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

  4. Survolez l’onglet de la feuille de calcul et sélectionnez Plus d'actions pour la feuille de calcul.

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

Partage de feuilles de calcul et de dossiers

Vous pouvez partager des feuilles de calcul et des dossiers de feuilles de calcul avec d’autres utilisateurs de Snowflake dans votre compte. Vous ne pouvez partager des feuilles de calcul directement qu’avec des utilisateurs qui se sont préalablement 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.

Le partage d’une feuille de calcul ou d’un dossier de feuilles de calcul vous permet de collaborer avec vos collègues sur cette feuille de calcul et permet aux destinataires d’une feuille de calcul partagée de modifier ou de voir le contenu de la feuille de calcul, de voir les résultats, d’exécuter la feuille de calcul ou de dupliquer la feuille de calcul partagée. Voir Autorisations pour les feuilles de calcul partagées.

Autorisations pour les feuilles de calcul partagées

Lorsque vous partagez une feuille de calcul avec quelqu’un, vous pouvez gérer l’accès à la feuille de calcul et à son contenu en choisissant les autorisations à accorder à l’autre utilisateur. Ces autorisations sont également utilisées pour partager des tableaux de bord. Les propriétaires de feuilles de calcul ont les mêmes autorisations que les éditeurs de feuilles de calcul.

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. Le rôle de la feuille de calcul est le rôle principal utilisé en dernier lieu pour exécuter la feuille de calcul et il est nécessaire pour exécuter la feuille de calcul. Le rôle de la feuille de calcul peut changer si le propriétaire ou l’éditeur de la feuille de calcul exécute la feuille de calcul en utilisant un rôle différent.

Pour voir les résultats d’une version antérieure de la feuille de calcul, vous devez avoir le rôle de la feuille de calcul qui a été utilisé pour exécuter l’instruction SQL qui a généré les résultats. Voir Vue des résultats des exécutions antérieures d’une feuille de calcul.

Permission attribuée

Les destinataires peuvent :

Modifier

  • Modifier le contenu de la feuille de calcul.

  • Exécuter la feuille de calcul, y compris en tant que rôle différent.

  • Voir les versions antérieures de la feuille de calcul.

  • Voir les résultats des versions antérieures de la feuille de calcul, s’ils ont le rôle utilisé pour générer les résultats.

  • Partager la feuille de calcul avec les autres.

  • Voir les versions antérieures de la feuille de calcul.

  • Ajouter la feuille de calcul à un autre dossier.

Affichage + exécution

  • S’ils ont le rôle de la feuille de calcul :

    • Exécuter la feuille de calcul.

    • Voir les résultats de la version la plus récente de la feuille de calcul.

  • Voir le contenu de la feuille de calcul.

  • Dupliquer et exécuter la feuille de calcul en utilisant leur propre rôle.

Voir les résultats

  • Voir les résultats de la version la plus récente de la feuille de calcul, s’ils ont le rôle de feuille de calcul.

  • Voir le contenu de la feuille de calcul.

  • Dupliquer et exécuter la feuille de calcul en utilisant leur propre rôle.

Lien avec Vue + Exécution

  • S’ils ont le rôle de la feuille de calcul :

    • Exécuter la feuille de calcul.

    • Voir les résultats de la version la plus récente de la feuille de calcul.

  • Voir le contenu de la feuille de calcul. Les utilisateurs disposant du lien ne peuvent pas dupliquer et exécuter la feuille de calcul.

Lien avec la vue des résultats

  • Voir les résultats de la version la plus récente de la feuille de calcul, s’ils ont le rôle de feuille de calcul.

  • Voir le contenu de la feuille de calcul. Les utilisateurs disposant du lien ne peuvent pas dupliquer et exécuter la feuille de calcul.

Le propriétaire de la feuille de calcul est l’utilisateur qui a créé la feuille de calcul et dispose des mêmes droits que l’éditeur de la feuille de calcul. Le propriétaire de la feuille de calcul change si le propriétaire ou l’éditeur de la feuille de calcul ajoute la feuille de calcul à un dossier appartenant à un autre utilisateur.

Si le propriétaire de la feuille de calcul est supprimé de Snowflake, l’utilisateur supprimé reste le propriétaire de la feuille de calcul, mais les utilisateurs ayant des autorisations de modification peuvent continuer à utiliser la feuille de calcul. Si vous souhaitez récupérer les feuilles de calcul appartenant à un utilisateur supprimé, voir Récupérer les feuilles de calcul appartenant à un utilisateur supprimé.

Vue des résultats des exécutions antérieures d’une feuille de calcul

Tous les utilisateurs ayant accès à une feuille de calcul peuvent voir les résultats de la dernière exécution de la feuille de calcul.

Pour voir les résultats des exécutions antérieures d’une feuille de calcul, les conditions suivantes doivent être réunies :

Vous pouvez voir les résultats d’une feuille de calcul exécutée précédemment en consultant l’historique des requêtes pour une feuille de calcul. Voir Afficher l’historique des requêtes.

Prudence

Lorsque vous partagez une feuille de calcul, vous partagez également une version en cache des résultats. Si votre feuille de calcul interroge des données protégées par des politiques de masquage ou d’accès aux lignes, ou si vous avez activé des rôles secondaires pour votre utilisateur, les résultats mis en cache peuvent contenir des résultats visibles uniquement par votre utilisateur. Les destinataires de la feuille de calcul partagée n’auront peut-être pas l’autorisation de générer ces résultats, mais, s’ils disposent du rôle nécessaire sur la feuille de calcul, ils peuvent afficher l’ensemble des résultats mis en cache.

Partage d’une feuille de calcul

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

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » 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. La liste n’affiche 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. Choisissez les autorisations à accorder aux utilisateurs avec lesquels vous partagez la feuille de calcul.

  7. En option, définissez les autorisations d’accès pour les personnes ayant un lien vers la feuille de calcul.

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

  9. Sélectionnez Done.

Note

La version la plus récente d’une feuille de calcul est celle qui est partagée. Si vous n’avez pas encore exécuté la feuille de calcul, une feuille de calcul vide est partagée.

Les modifications que vous apportez à votre version de la feuille de calcul, que vous soyez éditeur ou propriétaire de la feuille de calcul, n’apparaissent pas pour les collaborateurs tant que vous n’avez pas exécuté tout ou partie du code de la feuille de calcul.

Partage d’un dossier de feuilles de calcul

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 Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez un dossier.

  4. Sélectionnez Share.

  5. Saisissez les noms ou les noms d’utilisateur des utilisateurs Snowflake que vous souhaitez inviter dans votre dossier. La liste n’affiche 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. Choisissez les autorisations à accorder aux utilisateurs avec lesquels vous partagez le dossier.

  7. En option, définissez les autorisations d’accès pour les personnes ayant un lien vers le dossier.

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

  9. Sélectionnez Done.

Si vous ajoutez une feuille de calcul à un dossier partagé, la feuille de calcul hérite des paramètres de partage du dossier. Si le dossier appartient à une personne autre que le propriétaire de la feuille de calcul, l’utilisateur propriétaire de la feuille de calcul devient propriétaire du dossier et le propriétaire initial de la feuille de calcul hérite des autorisations de partage du dossier.

Par exemple, si un propriétaire de feuille de calcul ajoute une feuille de calcul à un dossier sur lequel il a des autorisations de modification, la feuille de calcul est mise à jour et devient la propriété du propriétaire du dossier, et le propriétaire initial de la feuille de calcul a alors les droits de modification sur la feuille de calcul.

Partage de feuilles de calcul entre comptes

Les feuilles de calcul ne sont pas des objets Snowflake et ne peuvent donc pas être répliquées ou partagées entre les comptes. Si vous souhaitez partager le contenu d’une feuille de calcul avec les utilisateurs d’un autre compte Snowflake, copiez le contenu et partagez-le avec les utilisateurs du compte en dehors de Snowflake.

Gestion de l’historique et des versions des feuilles de calcul

Les nouvelles versions d’une feuille de calcul sont enregistrées lorsque vous apportez des modifications et que vous exécutez une requête SQL ou le code dans la feuille de calcul.

Lorsque vous apportez des modifications à des feuilles de calcul et que vous gérez les versions des feuilles de calcul, tenez compte des éléments suivants :

  • Lorsque vous partagez une feuille de calcul avec d’autres utilisateurs, les utilisateurs disposant d’autorisations de modification peuvent voir les versions antérieures de la feuille de calcul. Tous les utilisateurs avec lesquels vous partagez une feuille de calcul peuvent voir les résultats de la version la plus récente de la feuille de calcul.

  • Chaque fois qu’une personne disposant d’autorisations exécute une feuille de calcul, une nouvelle version de la feuille de calcul est enregistrée.

  • Si vous apportez des modifications à la feuille de calcul et qu’elles semblent disparaître, utilisez l’historique des versions pour ouvrir le brouillon enregistré avec vos modifications.

  • La dernière version exécutée de la feuille de calcul est la version visible par les collaborateurs.

  • Si vous apportez à la feuille de calcul des modifications que vous souhaitez rendre visibles aux utilisateurs avec lesquels vous avez partagé la feuille de calcul, vous devez exécuter la feuille de calcul.

  • Si plusieurs utilisateurs modifient et exécutent une feuille de calcul partagée en même temps, chaque exécution de la feuille de calcul crée une nouvelle version. La dernière version exécutée de la feuille de calcul est celle qui est visible lorsque vous ouvrez ou actualisez la feuille de calcul.

Changement de version de la feuille de calcul

Si vous souhaitez consulter les versions antérieures d’une feuille de calcul, procédez comme suit :

  1. Connectez-vous à Snowsight.

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

  3. Ouvrez la feuille de calcul.

  4. Sélectionnez Code Versions pour la feuille de calcul.

  5. Dans la liste des versions de la feuille de calcul, sélectionnez l’horodatage de la version que vous souhaitez voir.

  6. Examinez et copiez éventuellement les détails de la feuille de calcul pour cette version.

  7. Sélectionnez Close pour revenir à la version actuelle de la feuille de calcul.

Si vous souhaitez voir les résultats d’une exécution antérieure de la feuille de calcul, consultez l’historique des requêtes pour la feuille de calcul. Voir Afficher l’historique des requêtes.

Résultats enregistrés pour les versions antérieures de la feuille de calcul

Les résultats des requêtes exécutées dans les feuilles de calcul sont mis en cache pendant 90 jours ou 25 versions de feuilles de calcul, la durée la plus longue étant retenue. Ce cache est inclus dans l’utilisation du stockage de données pour votre compte.

Récupérer les feuilles de calcul appartenant à un utilisateur supprimé

Si vous supprimez un utilisateur, vous pouvez récupérer jusqu’à 500 des feuilles de calcul appartenant à cet utilisateur. Pour récupérer les feuilles de calcul, procédez comme suit :

  1. Téléchargez les feuilles de calcul récupérées appartenant à un utilisateur supprimé.

  2. Créez des feuilles de calcul à partir d’un fichier SQL pour ajouter les feuilles de calcul récupérées à Snowflake.

Si vous souhaitez modifier le propriétaire ou conserver l’accès aux feuilles de calcul avant de supprimer un utilisateur, demandez à cet utilisateur de partager les feuilles de calcul. Voir Partage de feuilles de calcul et de dossiers.

Télécharger les feuilles de calcul récupérées appartenant à un utilisateur supprimé

Pour récupérer les feuilles de calcul appartenant à un utilisateur supprimé, téléchargez un fichier d’archive .tar.gz contenant jusqu’à 500 feuilles de calcul appartenant à cet utilisateur.

Note

Vous devez avoir le rôle ACCOUNTADMIN pour pouvoir récupérer les feuilles de calcul des utilisateurs supprimés.

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets.

  3. Sélectionnez Plus d'options » Recover Worksheets from Dropped User.

  4. Dans la boîte de dialogue, saisissez le nom d’utilisateur d’un utilisateur supprimé dans votre compte.

    Important

    La casse et l’orthographe du nom d’utilisateur doivent correspondre exactement au nom d’utilisateur tel qu’il a été enregistré dans Snowflake.

  5. Sélectionnez Recover.

    Votre navigateur Web télécharge un fichier .tar contenant jusqu’à 500 feuilles de calcul. Si l’utilisateur supprimé a plus de 500 feuilles de calcul, seules les 500 feuilles de calcul les plus récemment modifiées sont téléchargées.

Après avoir téléchargé les feuilles de calcul appartenant à un utilisateur supprimé, ajoutez les feuilles de calcul récupérées à Snowsight en créant des feuilles de calcul à partir des fichiers SQL.

Vous devez développer le fichier .tar téléchargé dans un dossier de fichiers .sql avant de pouvoir ajouter les feuilles de calcul récupérées à Snowsight. Vous ne pouvez ajouter qu’une feuille de calcul à la fois à Snowsight, et l’utilisateur qui ajoute les feuilles de calcul récupérées à Snowsight devient le nouveau propriétaire des feuilles de calcul.

Voir Créer des feuilles de calcul à partir d’un fichier SQL pour plus de détails.

Considérations relatives à la récupération des feuilles de calcul appartenant à des utilisateurs supprimés

Considérations à prendre en compte lors de la récupération des feuilles de calcul :

  • Seuls le titre et le contenu de la dernière version exécutée d’une feuille de calcul sont récupérés. L’historique des versions des feuilles de calcul, les destinataires et les autorisations de partage, les résultats des requêtes et les métadonnées des feuilles de calcul ne sont pas récupérés.

  • Il est récupéré un maximum de 500 feuilles de calcul. Pour les utilisateurs supprimés ayant plus de 500 feuilles de calcul, seules les 500 feuilles de calcul les plus récemment modifiées sont récupérées.

  • Seules les feuilles de calcul de Snowsight sont récupérées. Les feuilles de calcul de Classic Console appartenant à des utilisateurs supprimés ne peuvent pas être récupérées via cette méthode.

  • Si plusieurs utilisateurs supprimés ont le même nom d’utilisateur, les feuilles de calcul appartenant à tous les utilisateurs supprimés portant ce nom d’utilisateur sont récupérées.

Si la récupération des feuilles de calcul échoue pour des raisons imprévues, contactez l’assistance Snowflake.

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.