Charger des données à partir de fichiers locaux

Pour charger des données à partir de fichiers locaux dans votre instance Oracle Autonomous Database, sur la page Chargement des données, sélectionnez Charger les données et Fichier LOCAL.

Faites glisser des fichiers à partir du navigateur de votre système de fichiers local et déposez-les dans le panier de chargement des données. Vous pouvez également cliquer sur Sélectionner des fichiers ou sur l'icône correspondante, sélectionner des fichiers dans le navigateur du système de fichiers, puis cliquer sur Ouvrir.

Vous pouvez ajouter des fichiers dans les formats suivants : AVRO, CSV, JSON, GeoJSON, TSV, texte délimité, XLS, XLSX, XML, PNG, JPEG et PDF. Pour plus d'informations sur les formats de fichier pris en charge, reportez-vous à Spécifications de format pour les fichiers JSON, AVRO et XML.

Un élément pour chaque fichier apparaît dans le panier. Pour une feuille de calcul XLS ou XLSX, les feuilles de calcul de la feuille de calcul apparaissent sous forme d'éléments individuels. L'élément indique le nom de la feuille de calcul ou du fichier source et sa taille, ainsi que le nom de la table cible du chargement des données. L'outil de chargement des données prend en charge le chargement des tables à partir de la première feuille de calcul d'un fichier XLSX à plusieurs feuilles lorsque le fichier se trouve dans une banque d'objets.

Vous pouvez ajouter d'autres fichiers au panier en cliquant sur l'icône Sélectionner des fichiers. Vous pouvez ajouter un nombre quelconque de fichiers au panier et charger les données de tous ces fichiers dans un seul travail de chargement des données.

Pour enlever un fichier source du panier de chargement des données, cliquez sur l'icône Enlever (corbeille) de l'élément source. Pour enlever tous les fichiers source du panier, cliquez sur l'icône Tout enlever (corbeille) dans la barre de menu du panier de chargement des données.

Pour revenir à la page Chargement des données, cliquez sur Chargement des données au-dessus de la barre de menu du panier de chargement des données.

Indiquer les options de traitement

Pour indiquer les paramètres du travail de chargement des données ou prévisualiser les données dans la source ou la cible, sélectionnez l'icône Paramètres (crayon) de l'élément dans le panier de chargement des données.

Dans le panneau des paramètres, dans l'onglet Paramètres, vous pouvez visualiser le nom et la taille du fichier dans le titre de la boîte de dialogue Charger les données.

Le champ Nom indique le nom de la table cible. La valeur du champ varie en fonction de la sélection effectuée dans le champ Options. Si l'option est définie sur Créer une table, la valeur cible par défaut est le nom de la feuille de calcul ou du fichier source.

Pour attribuer un autre nom à la table cible, saisissez-le dans le champ Nom. Pour les autres options de table cible du champ Options, la valeur par défaut est <None>. Développez la liste déroulante et sélectionnez une table existante comme cible.

Dans le champ Options, sélectionnez Créer une table, Insérer dans une table, Remplacer les données, Supprimer (Drop) une table et créer une table ou Copier dans la table. Pointez sur l'icône représentant un point d'interrogation pour voir une brève description de l'option sélectionnée.

Sélectionnez un autre schéma dans la liste déroulante Schéma pour créer la table cible dans un autre schéma.
Remarque

La liste déroulante Schéma n'est disponible que si vous disposez d'un octroi de rôle PDB_DBA.

Pour vous accorder un rôle PDB_DBA, vous devez vous connecter à l'instance Database Actions et entrer la commande suivante dans la zone de feuille de calcul SQL affichée dans l'onglet SQL sous les outils Développement présents dans la fenêtre de lancement.

Grant PDB_DBA to Username;

Cette liste déroulante est disponible pour les options Créer une table et Déplacer une table et créer une table.

L'option Nom de colonne source indique s'il faut obtenir les noms de colonne source et cible à partir du fichier ou les indiquer manuellement. L'obtention des noms de colonne à partir de l'en-tête du fichier source est la valeur par défaut. Si vous sélectionnez l'option En-tête de colonne, la première ligne du fichier est traitée en tant que noms de colonne. Si vous désélectionnez cette option, la première ligne est traitée en tant que données. Pour indiquer les noms de colonne manuellement, saisissez un nom pour chaque colonne cible dans la section Mapping. Vous pouvez également sélectionner un type de données pour la colonne.

Le champ Démarrer le traitement des données sur la ligne indique le nombre de lignes à ignorer lors du chargement des données source dans la cible. Si vous avez sélectionné l'option En-tête de colonne et que vous saisissez un nombre supérieur à 0 dans le champ Démarrer le traitement des données à la ligne, le nombre de lignes correspondant après la première ligne n'est pas chargé dans la cible. Si vous avez désélectionné l'option En-tête de colonne et que vous saisissez un nombre supérieur à 0 dans le champ Démarrer le traitement des données à la ligne, ce nombre de lignes, y compris la première ligne, n'est pas chargé dans la cible.

Afin de modifier l'encodage de jeu de caractères pour le contenu du fichier, sélectionnez une valeur dans la liste déroulante Encodage.

Pour indiquer les caractères qui délimitent le texte, sélectionnez des guillemets, un guillemet ou None dans la liste déroulante Délimitation de texte.

Pour modifier le caractère délimiteur qui sépare les colonnes dans la source, développez la liste déroulante délimiteur de champ et sélectionnez un caractère. Par exemple, si le fichier contient des colonnes délimitées par des virgules, remplacez la virgule par défaut par un virgule.

Pour convertir une valeur non valide dans une colonne source numérique en valeur NULL dans la colonne cible, sélectionnez l'option Convertir les données non valides en valeurs NULL dans la colonne numérique numérique.

Modèle de paramètres

La fonction Enregistrer les paramètres enregistre l'ensemble de configuration dans les paramètres du panier sous la forme d'un fichier JSON. Lors de l'ouverture du modèle Paramètres, vous disposez des options suivantes :
  1. Charger le modèle de paramètres : charge un modèle de paramètres à partir de votre système local.
  2. Enregistrer le modèle de paramètres : enregistre le modèle de paramètres existant actuel.
Description de l'image settings-template.png
Description de l'image settings-template.png
Vous pouvez utiliser le modèle de paramètres de chargement si vous voulez utiliser un modèle personnalisé existant présent dans votre environnement local.
  1. Dans l'onglet Paramètres de la page Charger les données, sélectionnez Charger le modèle de paramètres.
  2. Un assistant de modèle de paramètres de chargement apparaît. Cliquez sur le modèle de paramètres JSON pour charger un fichier JSON à partir de votre système.
  3. Cliquez sur le modèle de paramètres JSON pour ouvrir votre système local. Cliquez sur OK pour charger le fichier JSON.
  4. Une fois le fichier JSON chargé, vous pouvez visualiser les mises à jour appliquées automatiquement à l'onglet des paramètres qui correspond au modèle de paramètres JSON que vous chargez à partir de votre emplacement local.
Vous pouvez utiliser l'option Enregistrer le modèle de paramètres pour enregistrer le modèle de paramètres actuel existant.
  1. Dans le modèle de paramètres de l'onglet Paramètres de la page Charger les données, sélectionnez Enregistrer le modèle de paramètres.
  2. L'éditeur de fichier de modèle apparaît. Cliquez sur le nom du fichier de modèle et nommez le nouveau modèle.
  3. Cliquez sur OK pour terminer l'enregistrement du nouveau nom du modèle existant.
  4. Vous pouvez tester la configuration du nouveau modèle.

Paramètres de modification globale

Vous pouvez utiliser les paramètres de modification en masse pour mettre à jour toutes les colonnes à la fois à partir de la table de mapping. Utilisez-le pour appliquer les modifications à la sélection actuellement affichée dans le volet de résultats. Vous pouvez rechercher les valeurs de la colonne que vous souhaitez modifier dans le champ de recherche et cliquer sur l'icône de loupe. La table de mappage affiche les résultats de la recherche. Sélectionnez le paramètre Modification en masse pour mettre à jour la colonne. Le paramètre Modification en masse vous permet d'effectuer les opérations suivantes :
  • Mettre à jour les valeurs de tous les champs d'un groupe.
  • Rechercher et remplacer, ajouter un préfixe et ajouter un suffixe au nom de la colonne cible.
  • Incluez les colonnes pour le chargement des données dans la table cible.
  • Excluez les colonnes pour le chargement des données dans la table cible.

Recherche dans la colonne

Le paramètre Modification en masse met à jour les colonnes renvoyées par le champ de recherche. La zone de recherche située sous les colonnes disponibles de l'assistant Modification en masse de la correspondance filtre la liste des colonnes à mettre à jour en masse. Vous pouvez également cliquer sur la colonne que vous souhaitez sélectionner dans la liste Colonnes disponibles. Choisissez l'une des options disponibles :
  • > : cette option vous permet de déplacer la colonne vers les colonnes sélectionnées.
  • < : pour enlever la table sélectionnée des colonnes sélectionnées, sélectionnez cette option.
  • >> : cette option vous permet de déplacer toutes les tables vers l'écran Colonnes sélectionnées.
  • << : pour enlever toutes les tables sélectionnées des colonnes sélectionnées, sélectionnez cette option.
Le mapping de modification en masse vous permet de mettre à jour les valeurs des colonnes suivantes pour toutes les recherches renvoyées par le champ de recherche :
  • Type de données
  • Nom de colonne cible
  • Inclure les colonnes dans le chargement
  • Exclure les colonnes du chargement

Envisagez de modifier le type de données des cinq premières lignes de VARCHAR2 en CHAR dans la table de mapping.

Description de l'image bulk-edit1.png ci-après
Description de l'image Bulk-edit1.png

Indiquez les mises en correspondance

Vous pouvez filtrer les résultats dans la table de mapping à l'aide du champ Filtre rapide qui vous permet de filtrer les colonnes ou les expressions.

Sélectionnez Ajouter une expression pour effectuer une analyse des sentiments ou une extraction d'expressions clés avec les données source. Pour plus d'informations, reportez-vous à Utilisation des fonctionnalités du service OCI Language dans Data Studio.

Si vous sélectionnez l'option Créer une table ou Supprimer et créer une table, et que vous obtenez les noms de colonne source à partir de l'en-tête de fichier, dans la section Mapping, acceptez les valeurs par défaut pour les types de données et les colonnes cible, ou indiquez d'autres valeurs. Pour indiquer d'autres valeurs, dans la colonne cible, saisissez le nom de la colonne. Dans la colonne Type de données, sélectionnez un type de données dans la liste déroulante. Si vous ne récupérez pas les noms de colonne source à partir de l'en-tête de fichier, pour chaque colonne source, indiquez le nom de la colonne cible et sélectionnez un type de données dans la liste déroulante Type de données. Pour le type de données Date, sélectionnez un format de date dans la liste déroulante Format.
Remarque

Vous recevrez un message d'erreur d'info-bulle indiquant le motif exact du message d'erreur lorsque vous aurez terminé la modification d'une cellule. La cellule de la grille de mappage sera mise en surbrillance avec le rouge pour indiquer une valeur non valide qui doit être corrigée. La mise en surbrillance est supprimée lorsque vous corrigez la valeur non valide. Par exemple, vous pouvez afficher le message d'erreur d'info-bulle suivant lorsque le nom de la colonne cible n'est pas renseigné. Description de l'info-bulle-error.png
Description de l'image info-bulle-error.png

Avec l'option Fusionner dans la table, pour chaque colonne source, sélectionnez une colonne cible dans la liste déroulante. Vous devez indiquer au moins une colonne comme colonne de clé. Pour indiquer une colonne en tant que colonne de clé, cochez la case Clé de fusion de la colonne. Les clés de fusion sont des colonnes qui identifient de manière unique chaque ligne de la table. Les clés de fusion ne doivent pas contenir de valeurs NULL. Pour le chargement de tables avec des clés primaires, cette option active automatiquement la sélection des colonnes de clé primaire comme clés de fusion.

Avec les options Insérer dans une table ou Remplacer les données, pour chaque colonne source, sélectionnez une colonne cible dans la liste déroulante des colonnes existantes.

Prévisualiser les données source

Pour visualiser une sélection de données dans le fichier source, sélectionnez l'onglet Aperçu. L'onglet Aperçu affiche un menu Fichier qui affiche les données sous forme de tableau avec ses valeurs. Vous pouvez copier la table. L'onglet Aperçu du chargement affiche les données source.

Les modifications apportées dans l'aperçu de la source n'ont pas d'incidence sur le chargement des données à partir du fichier.

Aperçu des données cible

Avec toutes les options, à l'exception de Créer une table, pour visualiser les données existantes dans la table cible, sélectionnez l'onglet Aperçu du chargement. L'aperçu de chargement affiche les données dans la table cible avant l'exécution du travail de chargement des données.

Pour fermer le panneau des paramètres, cliquez sur Fermer.

Exécution du travail de chargement des données

Une fois que vous avez ajouté toutes les sources du travail et défini les paramètres de chaque source, pour exécuter le travail, cliquez sur l'icône Démarrer dans la barre de menu du panier de chargement des données. Dans la boîte de dialogue Exécuter le travail de chargement des données, cliquez sur Démarrer. Pour arrêter le travail de chargement des données, cliquez sur l'icône Arrêter.

Une fois le travail de chargement des données démarré, vous pouvez visualiser sa progression dans le tableau de bord. Pour plus de détails, reportez-vous à Page de chargement des données.

Une fois le travail de chargement des données terminé, la page de tableau de bord Chargement des données affiche les résultats du travail. En haut de l'en-tête du chargement de table, vous pouvez afficher le nom de la table ainsi que le nombre total de colonnes présentes dans la table.

Cliquez sur Rapport pour visualiser le nombre total de lignes traitées avec succès et le nombre de lignes rejetées. Vous pouvez également afficher l'heure de début. Le volet SQL de l'état affiche le code SQL équivalent du travail.

Pour afficher des informations sur un élément du travail, cliquez sur l'icône Actions sur le chargement de table.

Pour afficher le journal de l'opération de chargement, cliquez sur l'icône Journalisation. Vous pouvez enregistrer le journal, l'effacer ou l'actualiser. Cliquez sur OK pour abandonner le journal.

La liste des tables de la page Chargement des données contient toutes les nouvelles tables créées. Les tables cible pour les options Insérer dans une table, Remplacer les données, Supprimer (DROP) une table et créer une table) et Fusionner dans la table contiennent les données chargées.

Correction d'un travail de chargement des données

Après le travail de chargement des données, vous pouvez voir des erreurs à corriger ou, lors d'une inspection, vouloir nommer différemment une colonne. Dans ce cas, vous verrez un signe d'avertissement sur le chargement de la table. Cliquez sur l'icône Recharger pour recharger la source avec les corrections suggérées. Cliquez sur l'icône Actions sur le chargement de table et sélectionnez Modifier pour apporter des modifications au travail de chargement des données (par exemple, pour modifier le nom d'une colonne).

Cliquez sur Appliquer pour appliquer les modifications. Cliquez sur Fermer pour revenir à la page Database Actions.