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 dans la plateforme Snowflake, 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 :
Mettre à jour et organiser des feuilles de calcul dans des dossiers.
Récupérer les feuilles de calcul appartenant à un utilisateur supprimé.
Navigation et ouverture des feuilles de calcul¶
Lorsque vous ouvrez une feuille de calcul, vous pouvez visualiser et gérer d’autres feuilles de calcul dans l”Worksheets explorer. L”Worksheets explorer vous permet également de rechercher des feuilles de calcul spécifiques.
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 de calcul dans l”Worksheets explorer. 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.
Exécution de tâches à l’aide 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 sur CTRL + SHIFT + / sur un clavier Windows.
Modification du contexte d’une feuille de calcul¶
Lorsque vous créez une feuille de calcul, vous spécifiez le rôle et l’entrepôt utilisés pour exécuter le contenu de la feuille de calcul. Ces informations, appelées contexte de la feuille de calcul, sont conservées pour les sessions futures et sont partagées avec tous les utilisateurs de la même feuille de calcul.
Note
Le sélecteur de rôle vous permet de choisir votre rôle principal. Pour activer les rôles secondaires dans une feuille de calcul SQL, exécutez USE SECONDARY ROLES. Pour déterminer si les rôles secondaires sont actifs dans votre session actuelle, appelez la fonction CURRENT_SECONDARY_ROLES CURRENT_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 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 a une session unique et peut utiliser des rôles différents de celui que vous avez sélectionné dans le menu utilisateur (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 ou redimensionnement d’un entrepôt¶
Avant ou après avoir exécuté votre feuille de calcul, vous pouvez avoir besoin de reprendre ou de redimensionner votre entrepôt.
Note
Vous devez avoir les privilèges MODIFY ou OWNERSHIP sur l’entrepôt pour modifier les détails de l’entrepôt.
Pour afficher ou 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¶
Vous pouvez gérer les feuilles de calcul dans l”Snowsight à partir de l’onglet de la feuille de calcul ou de l”Worksheets explorer. Pour accéder au menu de l’onglet de la feuille de calcul, ouvrez une feuille de calcul, passez la souris sur l’onglet et sélectionnez l’onglet . Pour accéder à l”Worksheets explorer, passez la souris sur le nom d’une feuille de calcul et sélectionnez l”
.
Les actions disponibles dans chaque menu sont basées sur votre rôle actuel. En fonction de vos autorisations, vous pouvez effectuer les opérations suivantes :
Renommer, supprimer ou déplacer une feuille de calcul (nécessite des autorisations de modification ou de propriété).
Organiser les feuilles de calcul en les déplaçant dans des dossiers ou un tableau de bord.
Importer une instruction SQL à partir d’un fichier externe.
Formater vos requêtes
Recherchez d’autres feuilles de calcul.
Dupliquer une feuille de calcul (n’importe quel rôle).
Astuce
Vous pouvez survoler une feuille de calcul pour prévisualiser son contenu.
Vous pouvez identifier les feuilles de calcul ouvertes dans les onglets en vous référant à l’icône de la feuille de calcul. Une icône fixe indique que la feuille de calcul est actuellement ouverte. Pour accéder aux options du menu, passez la souris sur le nom d’une feuille de calcul et sélectionnez les points de suspension visibles.
Gestion de l’historique et des versions des feuilles de calcul¶
Toutes les modifications locales que vous apportez à une feuille de calcul sont automatiquement enregistrées toutes les trois secondes mais restent visibles uniquement par vous. Lorsque vous exécutez une requête SQL ou que vous exécutez du code dans une feuille de calcul, la dernière version est mise à jour et partagée avec tous les collaborateurs. Vous pouvez également afficher les versions antérieures d’une feuille de calcul et éventuellement copier les détails de n’importe quelle version. Pour plus d’informations, voir Changement de version de 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 visualiser jusqu’à 10 000 lignes de 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¶
Pour 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.
Pour voir les résultats d’une exécution antérieure de la feuille de calcul, consultez l”Query History 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¶
Note
Disponible pour la plupart des comptes. Les comptes situés dans les régions du gouvernement américain, les comptes utilisant Virtual Private Snowflake (VPS) et les comptes utilisant la connectivité privée pour accéder à Snowflake continuent de voir les résultats de leurs requêtes limités à 10 000 lignes.
Tous les résultats des requêtes exécutées dans des feuilles de calcul sont disponibles pendant 24 heures maximum. Après 24 heures, vous devez exécuter à nouveau votre requête pour voir les résultats.
Pour prendre en charge les statistiques contextuelles et le partage des résultats des feuilles de calcul, les 25 derniers résultats de la requête sont mis en cache pour une durée maximale de 90 jours. 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¶
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.