Mise des fichiers en zone de préparation à l’aide de Snowsight¶
Avec Snowsight, vous pouvez créer et gérer des zones de préparation nommées sans écrire de SQL. Vous pouvez également charger des fichiers sur une zone de préparation interne nommée afin que vous puissiez visualiser vos fichiers, utiliser les fichiers dans une feuille de calcul Python, ou charger des données des fichiers dans une table.
Vous ne pouvez pas charger de fichiers sur des zones de préparation utilisateur ou des zones de préparation de table à l’aide de Snowsight. Reportez-vous à Vue d’ensemble du chargement de données pour en savoir plus sur les zones de préparation.
Dans ce chapitre :
Création d’une zone de préparation¶
Vous pouvez utiliser Snowsight pour créer une zone de préparation interne ou externe nommée.
Note
Vous devez utiliser un rôle qui bénéficie ou hérite du privilège USAGE sur la base de données et le schéma qui stockent la zone de préparation et du privilège CREATE STAGE sur le schéma.
Reportez-vous à Exigences en matière de contrôle d’accès pour CREATE STAGE.
Créer une zone de préparation interne nommée¶
Pour utiliser Snowsight afin de créer une zone de préparation interne nommée, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer une zone de préparation.
Sélectionnez Create » Stage » Snowflake Managed.
Entrez un Stage Name.
Vous pouvez également désélectionner Directory table. Les tables de répertoire permettent de voir les fichiers sur la zone de préparation, mais elles nécessitent un entrepôt et ont donc un coût. Vous pouvez choisir de désélectionner cette option pour l’instant et d’activer une table de répertoire ultérieurement.
Sélectionnez le type de Encryption pris en charge pour tous les fichiers sur votre zone de préparation. Pour plus de détails, voir chiffrement pour les zones de préparation internes. Vous ne pouvez pas modifier le type de chiffrement après la création de la zone de préparation.
Note
Pour permettre l’accès aux données, nous vous recommandons de sélectionner le chiffrement côté serveur. Sinon, les fichiers en zone de préparation sont chiffrés par défaut côté client et illisibles lorsqu’ils sont téléchargés. Pour plus d’informations, consultez Chiffrement côté serveur pour l’accès à des données non structurées.
Complétez les champs pour décrire votre zone de préparation. Pour plus d’informations, reportez-vous à CREATE STAGE.
Sélectionnez Create.
Création d’une zone de préparation externe nommée¶
Pour utiliser Snowsight afin de créer une zone de préparation externe nommée, procédez comme suit :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer une zone de préparation.
Sélectionnez Create » Stage.
Sélectionnez le service de stockage Cloud pris en charge où se trouvent vos fichiers.
Entrez un Stage Name.
Saisissez l”URL de votre emplacement de stockage externe dans le Cloud.
Si votre stockage externe n’est pas public, activez Authentication et entrez vos détails. Pour plus d’informations, reportez-vous à CREATE STAGE.
Vous pouvez également désélectionner Directory table. Les tables de répertoire permettent de voir les fichiers sur la zone de préparation, mais elles nécessitent un entrepôt et ont donc un coût. Vous pouvez choisir de désélectionner cette option pour l’instant et d’activer une table de répertoire ultérieurement.
Si vous activez Directory table, sélectionnez éventuellement Enable auto-refresh et sélectionnez votre notification d’événement ou votre intégration de notification pour actualiser automatiquement la table de répertoire lorsque des fichiers sont ajoutés ou supprimés. Pour en savoir plus, voir Actualisation automatique des métadonnées des tables de répertoire.
Si vos fichiers sont cryptés, activez Encryption et entrez vos détails.
Il est possible de développer SQL Preview pour afficher une instruction SQL générée. Pour spécifier des options supplémentaires pour votre zone de préparation telle que AUTO_REFRESH, vous pouvez ouvrir cet aperçu SQL dans une feuille de calcul.
Sélectionnez Create.
Chargement de fichiers dans une zone de préparation¶
Vous pouvez utiliser Snowsight pour charger des fichiers sur une zone de préparation interne nommée.
Pour charger des fichiers sur des zones de préparation externes dans des services tels qu’Amazon S3, Microsoft Azure ou Google Cloud Storage, utilisez les outils de ces services Cloud.
Chargement de fichiers dans une zone de préparation interne nommée¶
Note
La taille de fichier maximale est de 250 MB.
Vous devez utiliser un rôle qui bénéficie ou hérite du privilège USAGE sur la base de données et le schéma et du privilège WRITE sur la zone de préparation pour effectuer ces étapes. Reportez-vous à Privilèges de zone de préparation.
Pour charger des fichiers sur votre zone de préparation, procédez comme suit :
Connectez-vous à Snowsight.
Sélectionnez Data » Databases.
Sélectionnez le schéma de base de données dans lequel vous avez créé la zone de préparation, puis sélectionnez la zone de préparation.
Sélectionnez + Files pour charger des fichiers sur la zone de préparation.
Dans la boîte de dialogue Upload Your Files qui s’affiche, sélectionnez les fichiers que vous souhaitez charger. Vous pouvez charger plusieurs fichiers à la fois.
Si vous le souhaitez, vous pouvez sélectionner ou créer un chemin d’accès pour enregistrer vos fichiers dans la zone de préparation.
Sélectionnez Upload.
Après avoir chargé des fichiers sur la zone de préparation, vous pouvez effectuer l’une des actions suivantes en fonction du fichier :
Utilisez les fichiers dans une feuille de calcul Python. Reportez-vous à Ajouter un fichier Python d’une zone de préparation à une feuille de calcul.
Copiez les données des fichiers en zone de préparation dans une table cible. Voir Charger un fichier depuis une zone de préparation dans une table existante ou Copie de données à partir d’une zone de préparation interne.
Interrogez les données dans la zone de préparation. Reportez-vous à Interrogation des données dans des fichiers mis en zone de préparation.
Affichage de fichiers en zone de préparation¶
Vous pouvez visualiser les fichiers en zone de préparation en utilisant Snowsight. Vous pouvez consulter des fichiers provenant de zones de préparation internes et externes.
Note
Vous devez utiliser un rôle qui bénéficie ou hérite du privilège USAGE sur la base de données et le schéma et du privilège READ sur la zone de préparation pour effectuer ces étapes.
Connectez-vous à Snowsight.
Sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma qui contiennent la zone de préparation.
Sélectionnez Stages et sélectionnez la zone de préparation pour laquelle vous souhaitez visualiser les fichiers.
Si vous y êtes invité, sélectionnez Enable Directory Table pour activer une table de répertoire pour la zone de préparation afin que vous puissiez voir les fichiers.
Si vous y êtes invité, sélectionnez un entrepôt virtuel pour actualiser la table de répertoire.
Pour actualiser la table de répertoire dans une zone de préparation, sélectionnez l’icône d’actualisation.
Gestion des fichiers en zone de préparation¶
Vous pouvez utiliser Snowsight pour effectuer les actions suivantes sur les fichiers en zone de préparation :
Sélectionnez » Load into table pour charger le fichier de la zone de préparation dans une table.
Sélectionnez » Copy path pour copier le chemin d’accès au fichier afin de l’utiliser ailleurs, par exemple dans une feuille de calcul.
Pour les fichiers se trouvant dans une zone de préparation interne, vous pouvez également effectuer les actions suivantes :
Sélectionnez » Download pour télécharger le fichier de la zone de préparation.
Sélectionnez » Remove pour supprimer le fichier de la zone de préparation.
Note
Pour télécharger un fichier à partir d’une zone de préparation externe, voir Téléchargement de fichiers en zone de préparation dans Snowsight.
Gestion des zones de préparation¶
Pour gérer une zone de préparation dans Snowsight, procédez comme suit :
Note
Vous devez utiliser un rôle qui bénéficie ou hérite du privilège USAGE sur la base de données et le schéma et du privilège OWNERSHIP sur la zone de préparation pour effectuer ces étapes.
Connectez-vous à Snowsight.
Sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma qui contiennent la zone de préparation.
Sélectionnez Stages et sélectionnez la zone de préparation.
Sélectionnez Stage Details.
Vous pouvez gérer la zone de préparation de la manière suivante :
Sélectionnez » Edit pour modifier les propriétés ou activer une table de répertoire pour l’objet de zone de préparation.
Sélectionnez » Drop pour supprimer ou retirer la zone de préparation.
Sélectionnez » Transfer Ownership pour transférer des privilèges OWNERSHIP vers la zone de préparation à un autre rôle.
Si vous souhaitez gérer les privilèges pour la zone de préparation, utilisez la section Privileges pour visualiser, accorder et révoquer les privilèges.
Dépannage¶
Les fichiers ne sont pas visibles dans une zone de préparation externe¶
Ce problème peut survenir lorsqu’une zone de préparation externe n’a pas de table de répertoire activée, ou lorsque les informations sur l’emplacement de stockage externe sont incorrectes.
Pour résoudre ce problème, essayez d’effectuer les opérations suivantes :
Assurez-vous que le propriétaire de la zone de préparation a activé une table de répertoire dans la zone de préparation.
Vérifiez bien que la table de répertoire a été actualisée. Pour actualiser la table de répertoire, sélectionnez votre zone de préparation dans Snowsight, puis sélectionnez l’icône d’actualisation.
Vérifiez que l’URL du fournisseur Cloud est correcte. Si votre URL contient un sous-chemin d’accès, assurez-vous qu’elle présente une barre oblique à la fin.