Chargement de données avec l’interface Web¶

Privilèges de contrôle d’accès¶

Snowsight ne prend pas en charge l’utilisation des rôles de base de données pour accorder des privilèges sur une base de données, un schéma ou une table. Utilisez un rôle de compte pour interagir avec Snowsight. Pour plus d’informations, voir Distribution de rôles.

Charger un fichier dans une table existante¶

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Add Data.

3. Sur la page Add Data , sélectionnez Load data into a Table.

   La boîte de dialogue Load Data into Table apparaît.

4. Dans la boîte de dialogue Load Data into Table, sélectionnez ou créez une base de données et un schéma dans lesquels vous souhaitez que la table soit créée.

5. Sélectionnez Browse pour ajouter un fichier à partir de votre machine locale, Drag and drop to upload files, ou Add from stage.

   Si vous sélectionnez Add from stage, l’explorateur de zone de préparation apparaîtra. Dans l’explorateur de zone de préparation, vous pouvez parcourir les zones de préparation et les sous-dossiers et sélectionner des dossiers et des fichiers spécifiques à partir de la zone de préparation. Si vous sélectionnez Add sans sélectionner de fichiers spécifiques dans la zone de préparation, la zone de préparation racine, qui comprend tous les fichiers et dossiers de la zone de préparation, sera ajoutée.

   Le nombre maximum de fichiers pouvant être affichés dans un dossier de zone de préparation est de 250.

6. Après avoir ajouté les fichiers, sélectionnez Next. La boîte de dialogue du schéma de table apparaît.

7. Dans la boîte de dialogue du schéma de table, procédez comme suit :

   • Sélectionnez un format de fichier dans la base de données actuelle.

   • Sélectionnez un type de fichier à personnaliser, puis sélectionnez les paramètres appropriés pour votre fichier de données.

   • (Facultatif) Sélectionnez ce qui doit se passer si une erreur survient pendant le chargement. Par défaut, aucune donnée n’est chargée à partir du fichier.

   • Sélectionnez l’une des options Match by column names pour faire correspondre automatiquement le fichier source et la table cible. L’option par défaut est case insensitive.

     Notez que la détection de schémas et le mappage visuel des colonnes ne prennent pas en charge XML.

   • Sélectionnez l’onglet Edit Schema sur le côté droit de la boîte de dialogue du schéma de table. Vous pouvez voir toutes les différences entre le fichier source et la table cible. Procédez aux ajustements nécessaires.

   • Si vous sélectionnez l’onglet Table Preview, vous pouvez afficher un aperçu des données du fichier source entrant dans la table cible.

8. Sélectionnez Load.

   Snowsight charge votre fichier et affiche le nombre de lignes insérées avec succès dans la table.

Créer une table lors du chargement d’un fichier¶

Vous pouvez créer une nouvelle table lors du chargement d’un fichier en procédant comme suit.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Create » Table » From File.

   La boîte de dialogue Load Data into Table apparaît.

3. Dans la boîte de dialogue Load Data into Table, sélectionnez ou créez une base de données et un schéma dans lesquels vous souhaitez que la table soit créée.

4. Sélectionnez Browse pour ajouter un fichier à partir de votre machine locale, Drag and drop to upload files, ou Add from stage.

   Si vous sélectionnez Add from stage, l’explorateur de zone de préparation apparaîtra. Dans l’explorateur de zone de préparation, vous pouvez parcourir les zones de préparation et les sous-dossiers et sélectionner des dossiers et des fichiers spécifiques à partir de la zone de préparation. Si vous sélectionnez Add sans sélectionner de fichiers spécifiques dans la zone de préparation, la zone de préparation racine, qui comprend tous les fichiers et dossiers de la zone de préparation, sera ajoutée.

   Notez que le nombre maximum de fichiers pouvant être affichés dans un dossier de zone de préparation est de 250.

5. Saisissez un nom pour la nouvelle table, puis sélectionnez Next.

   Snowsight détecte le schéma de métadonnées du fichier et renvoie le format du fichier et les définitions de colonnes identifiées par la fonction INFER_SCHEMA.

6. Examinez le format de fichier déduit, le type de données, le nom de la colonne et un échantillon de données de la colonne. Assurez-vous que toutes les informations sont exactes et mettez-les à jour si nécessaire.

7. Sélectionnez Load.

   Snowsight charge le fichier et crée une nouvelle table pour le fichier.

Conditions préalables au chargement de données¶

Avant de commencer à charger des données à l’aide de Classic Console, procédez comme suit :

• Identifiez l’emplacement de vos fichiers de données. Vous pouvez charger des données à partir de l’un des éléments suivants :

  • Votre machine locale.

  • Une zone de préparation interne ou externe.

  • Un emplacement de stockage Cloud sur Amazon S3, Google Cloud Storage ou Microsoft Azure qui n’est pas encore ajouté à Snowflake en tant que zone de préparation externe.

• Déterminez la taille de vos fichiers de données. Chaque fichier que vous chargez peut contenir jusqu’à 250 MB. Si vous souhaitez charger des fichiers plus volumineux ou un grand nombre de fichiers, utilisez plutôt le client Snowflake, SnowSQL. Reportez-vous à Chargement en masse à partir d’un système de fichiers local.

Le rôle que vous utilisez pour charger les données doit disposer des privilèges appropriés :

• Pour charger des données, votre rôle doit disposer du privilège USAGE sur la base de données et le schéma contenant la table dans laquelle vous chargez des données.

• Pour créer une zone de préparation lors du chargement des données, votre rôle doit disposer du privilège CREATE STAGE sur le schéma de la base de données.

• Pour créer un format de fichier lorsque vous chargez des données, votre rôle doit disposer du privilège CREATE FILE FORMAT sur le schéma de la base de données.

Lancement du chargement de données¶

Pour commencer à charger un fichier dans une table spécifique, procédez comme suit :

1. Sélectionnez Databases .

2. Sélectionnez une base de données et un schéma spécifiques.

3. Sélectionnez l’onglet Tables.

4. Localisez la table dans laquelle vous souhaitez charger des données.

5. Commencez à charger des données dans une table spécifique en effectuant l’une des opérations suivantes :

   • Sélectionnez une ligne de la table, puis Load Data.

   • Cliquez sur le nom d’une table pour ouvrir la page de détails de la table, puis sélectionnez Load Table.

   L’assistant Load Data s’ouvre.

6. Sélectionnez un entrepôt à utiliser pour charger les données dans la table. La liste déroulante comprend tous les entrepôts sur lesquels vous avez le privilège USAGE.

7. Sélectionnez Next.

Sélection de données à charger¶

Selon l’endroit où vous choisissez de charger les données, suivez les étapes correspondantes. Si vous souhaitez charger des données à partir de plusieurs emplacements, utilisez l’assistant Load Data plusieurs fois.

Pour charger des données à partir de votre ordinateur :

1. Sélectionnez l’option Load files from your computer et sélectionnez Select Files pour naviguer jusqu’aux fichiers que vous souhaitez charger.

2. Sélectionnez un ou plusieurs fichiers de données locaux, et sélectionnez Open.

3. Sélectionnez Next.

Pour charger les données d’une zone de préparation existante :

1. Sélectionnez l’option Load files from external stage.

2. Sélectionnez une zone de préparation existante dans la liste déroulante Stage.

3. (Facultatif) Spécifiez un chemin d’accès aux fichiers de la zone de préparation.

4. Sélectionnez Next.

Pour créer une zone de préparation, par exemple pour charger des données à partir d’un stockage externe Cloud :

1. Sélectionnez l’option Load files from external stage.

2. Sélectionnez + à côté de la liste déroulante Stage.

3. Sélectionnez le service de stockage Cloud pris en charge où se trouvent vos fichiers.

4. Sélectionnez Next.

5. Complétez les champs pour décrire votre zone de préparation. Pour plus d’informations, reportez-vous à CREATE STAGE.

6. Sélectionnez Finish.

   Votre nouvelle zone de préparation est automatiquement sélectionnée dans la liste déroulante Stage.

7. (Facultatif) Spécifiez un chemin d’accès aux fichiers de la zone de préparation.

8. Sélectionnez Next.

Fin du chargement de données¶

Après avoir sélectionné les fichiers à charger, terminez le chargement des données dans votre table.

Pour terminer le chargement des données, procédez comme suit :

1. Sélectionnez un format de fichier nommé existant dans la liste déroulante, ou créez-en un.

   Pour créer un format de fichier :

   1. Sélectionnez + à côté de la liste déroulante.

   2. Remplissez les champs pour faire correspondre le format de vos fichiers de données. Pour une description des options, voir CREATE FILE FORMAT.

   3. Sélectionnez Finish.

   Votre nouveau format de fichier est automatiquement sélectionné dans la liste déroulante.

2. Déterminez comment vous souhaitez gérer les erreurs qui surviennent lors du chargement des données :

   • Si vous souhaitez que le chargement des données s’arrête en cas d’erreur, sélectionnez Load.

   • Si vous souhaitez que les erreurs soient traitées différemment :

     1. Sélectionnez Next.

     2. Sélectionnez l’option qui décrit la manière dont vous souhaitez gérer les erreurs. Pour plus de détails sur les options, reportez-vous à la section ON_ERROR de COPY INTO <table>.

     3. Sélectionnez Load.

   Snowflake charge les données dans votre table sélectionnée en utilisant l’entrepôt que vous avez sélectionné.

3. Sélectionnez OK pour fermer l’assistant Load Data.