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 , 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 :
Connectez-vous à Snowsight.
Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.
Ouvrez une feuille de calcul.
Ouvrez le sélecteur de contexte.
Sélectionnez un rôle pour exécuter la feuille de calcul.
Sélectionnez un entrepôt que le rôle peut utiliser (grâce à ses privilèges).
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 :
Connectez-vous à Snowsight.
Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.
Ouvrez une feuille de calcul.
Ouvrez le sélecteur de contexte.
Sélectionnez l’icône Show warehouse details.
Pour l’option Status , sélectionnez le statut et choisissez Resume si l’entrepôt est suspendu.
Pour l’option Size , sélectionnez la taille et choisissez une autre taille.
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 visible lorsque vous survolez l’onglet d’une feuille de calcul, pour gérer la feuille de calcul ouverte des manières suivantes :
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.
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 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.
Connectez-vous à Snowsight.
Sélectionnez Projects » Worksheets.
Sélectionner une feuille de calcul pour l’ouvrir.
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.
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 :
Connectez-vous à Snowsight.
Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.
Ouvrez la feuille de calcul.
Sélectionnez Code Versions pour la feuille de calcul.
Dans la liste des versions de la feuille de calcul, sélectionnez l’horodatage de la version que vous souhaitez voir.
Examinez et copiez éventuellement les détails de la feuille de calcul pour cette version.
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 :
Téléchargez les feuilles de calcul récupérées appartenant à un utilisateur supprimé.
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.
Connectez-vous à Snowsight.
Sélectionnez Projects » Worksheets.
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.
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.