Chargement de données avec l’interface Web

Vous pouvez utiliser Snowsight ou Classic Console pour charger des fichiers contenant des données structurées (par exemple, CSV, TSV) ou des données semi-structurées (par exemple, JSON, Avro, ORC, Parquet, ou XML).

Utilisez l’interface Web pour charger des données à partir de fichiers dont la taille ne dépasse pas 250MB. Pour charger des fichiers plus volumineux ou un grand nombre de fichiers, utilisez le client Snowflake, SnowSQL. Reportez-vous à Chargement en masse à partir d’un système de fichiers local.

Dans ce chapitre :

Chargement de données avec Snowsight

Vous pouvez utiliser Snowsight pour charger des fichiers dans les cas suivants :

  • Chargement d’un fichier ou de plusieurs fichiers de votre machine locale dans une table existante.

  • Chargement d’un fichier d’une zone de préparation dans une table existante.

  • Création d’une nouvelle table lors du chargement d’un fichier local ou en zone de préparation. Snowsight utilise la fonction de table INFER_SCHEMA pour détecter automatiquement le schéma de métadonnées du fichier, récupérer les définitions de colonnes et générer une nouvelle table. Cette fonction ne prend pas en charge les fichiers XML.

Vous pouvez charger des données à partir de fichiers individuels d’une taille maximale de 250 MB.

Note

Pour utiliser Snowsight pour charger des données, vous devez utiliser un rôle qui dispose du privilège OWNERSHIP sur la table dans laquelle vous souhaitez charger des données et du privilège USAGE sur la base de données et le schéma qui contiennent la table. Voir Privilèges de table.

Si vous souhaitez utiliser un format de fichier nommé, votre rôle doit bénéficier du privilège USAGE sur ce format de fichier spécifique.

Charger des fichiers de votre machine locale dans une table existante

  1. Connectez-vous à Snowsight.

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

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

  4. Dans l’explorateur d’objets, sélectionnez la table dans laquelle vous souhaitez charger des données.

  5. Sélectionnez Load Data.

  6. Dans la boîte de dialogue Load Data into Table, sélectionnez Browse.

  7. Ajouter des fichiers de données structurées ou semi-structurées.

  8. Si vous n’avez pas défini d’entrepôt par défaut pour votre utilisateur, sélectionnez un entrepôt.

  9. Sélectionnez Next.

  10. Effectuez au choix :

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

  11. (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.

  12. Sélectionnez Load.

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

  13. Effectuez au choix :

    • Pour ouvrir une feuille de calcul avec la syntaxe SQL pour l’interrogation de votre table, sélectionnez Query Data.

    • Pour fermer la boîte de dialogue, sélectionnez Done.

    Si votre fichier ne peut pas être chargé, par exemple si les colonnes du fichier ne correspondent pas aux colonnes spécifiées dans la table, un message d’erreur s’affiche. Pour ajuster vos paramètres, sélectionnez Back.

Charger un fichier depuis une zone de préparation dans une table existante

Avant de charger des fichiers d’une zone de préparation dans une table, vous devez créer une zone de préparation et y charger des fichiers. Pour obtenir des instructions, voir Mise des fichiers en zone de préparation à l’aide de Snowsight.

  1. Connectez-vous à Snowsight.

  2. Dans l’explorateur d’objets, sélectionnez la zone de préparation à partir de laquelle vous souhaitez charger des fichiers.

  3. Dans la liste des fichiers en zone de préparation, sélectionnez le fichier que vous souhaitez charger dans la table.

  4. Dans le menu déroulant indiqué par une ellipse au niveau du fichier sélectionné, sélectionnez Load into table.

  5. Dans la boîte de dialogue Load Data into Table, sélectionnez une base de données, un schéma et une table où vous souhaitez charger le fichier.

  6. Sélectionnez Next.

  7. Effectuez au choix :

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

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

  9. Sélectionnez Load.

    Snowsight charge votre fichier de la zone de préparation vers la table.

Vous pouvez également charger un fichier en zone de préparation dans une table en copiant le chemin du fichier en zone de préparation.

  1. Suivez les étapes 1 à 3 de la procédure précédente.

  2. Dans le menu déroulant indiqué par une ellipse au niveau du fichier sélectionné sur la zone de préparation, sélectionnez Copy path.

  3. Dans l’explorateur d’objets, sélectionnez la table dans laquelle vous souhaitez charger des données.

  4. Sélectionnez Load Data.

  5. Dans la boîte de dialogue Load Data into Table qui apparaît, sélectionnez Add from Stage.

  6. Collez le chemin que vous avez copié dans le champ du chemin, puis sélectionnez Add.

    Le nom du fichier en zone de préparation apparaît.

  7. Sélectionnez Next.

  8. Effectuez au choix :

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

  9. (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.

  10. 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. Alternativement, vous pouvez ouvrir la boîte de dialogue Load Data into Table à partir d’une zone de préparation en suivant les étapes 1-4 de la section précédente Charger un fichier depuis une zone de préparation dans une table existante et ensuite suivre les étapes suivantes 6-10 pour accomplir les mêmes tâches.

Note

Cette fonction prend en charge les fichiers délimités, les fichiers JSON, Parquet, Avro et ORC. Elle ne prend pas en charge les fichiers XML.

Pour effectuer les tâches ci-dessous, vous devez disposer des privilèges pour la création de table.

  1. Connectez-vous à Snowsight.

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

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

  4. Sélectionnez Create.

  5. Dans le menu déroulant, sélectionnez Table » From File.

  6. Dans la boîte de dialogue Load Data into Table, sélectionnez Browse to add a file ou Drag and drop a file to the dialog ou Add a file from stage. En option, choisissez l’emplacement de votre fichier.

  7. Sélectionnez une base de données et un schéma dans lesquels vous souhaitez que la table soit créée.

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

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

  10. Sélectionnez Load.

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

Chargement de données à l’aide de la console classique

Classic Console fournit un assistant pour charger des quantités limitées de données dans une table à partir d’un petit ensemble de fichiers. L’assistant effectue les mêmes opérations PUT et COPY qu’avec SQL, mais combine les deux phases (mise en zone de préparation des fichiers et chargement des données) en une seule opération et supprime tous les fichiers en zone de préparation une fois le chargement terminé.

Vous pouvez charger des données à partir de fichiers sur votre machine locale, ou à partir de fichiers déjà mis en zone de préparation dans un emplacement de stockage Cloud sur Snowflake, Amazon S3, Google Cloud Storage, ou Microsoft Azure.

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’à 250MB. 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 Onglet Bases de données.

  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.

Note

Si votre entrepôt n’est pas en cours d’exécution lorsque vous terminez le chargement des données, vous devez attendre que l’entrepôt reprenne (jusqu’à 5 minutes) avant que les données ne soient chargées.

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.