Chargement de données à partir du stockage cloud

Sur la carte du panier de liens de données, cliquez sur l'icône Actions et sélectionnez les paramètres pour ouvrir le panneau Charger les données à partir du stockage cloud pour ce travail. Le volet contient :

• Onglet Paramètres - Section Tableau
• Onglet Paramètres - Section Propriétés
• Onglet Paramètres - Section Mappage
• Onglet Aperçu
• Onglet Table
• Bouton Fermer - Enregistrer et fermer le volet

Onglet Paramètres - Section Tableau

Définissez les détails de la table cible dans la section Table.

• Option : sélectionnez un élément dans la liste Option pour indiquer comment les données doivent être chargées dans une table nouvelle ou existante. Les options de traitement sont les suivantes :

  • Créer une table : crée une table et insère les données dans la nouvelle table. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres est rempli d'un nom par défaut, en fonction du nom du fichier ou du dossier source. Vous pouvez le modifier si vous le souhaitez.

  • Insérer dans une table : insère les données chargées à partir de la source dans une table existante. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres présente la liste des tables du schéma en cours. Sélectionnez la table dans laquelle vous souhaitez insérer les données.

  • Remplacer les données : supprime toutes les données de la table existante, puis insère de nouvelles données de la source dans la table. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres présente la liste des tables du schéma en cours. Sélectionnez la table que vous voulez utiliser.

  • Supprimer la table et créer une table : supprime la table (si elle existe déjà), en crée une, puis y insère les nouvelles données. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres présente la liste des tables du schéma en cours. Sélectionnez la table que vous voulez utiliser.

  • Fusionner dans la table : met à jour les lignes existantes et insère de nouvelles lignes de la table. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres présente la liste des tables du schéma en cours. Sélectionnez la table que vous voulez utiliser.

• 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 de l'autorisation de rôle PDB_DBA.

  Pour vous accorder le rôle PDB_DBA, vous devez vous connecter à votre 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 USER;

  Vous pouvez désormais afficher la liste déroulante Schéma. Elle n'est disponible que pour les options Créer une table et Supprimer la table et créer une table.

• Nom : nom de la Table cible.

• Colonne de partition :

  Les partitions par liste et les partitions par date sont les différents types de partition disponibles dans le chargement des données.

  Le partitionnement de liste est obligatoire lorsque vous souhaitez mapper des lignes à des partitions en fonction de valeurs distinctes.

  Pour partitionner en fonction d'une colonne spécifique, cliquez sur la liste déroulante Colonne de partition et sélectionnez la colonne à utiliser pour le partitionnement.

  Vous aurez N fichiers par valeur de partition, tous partitionnés par la colonne de partition que vous sélectionnez.

  Remarque
  
  

  • Pour les fichiers liés (à partir de tables externes), il est également nécessaire que pour chaque fichier, la colonne de partitionnement de liste ne puisse contenir qu'une seule valeur distincte sur toutes les lignes.
  • Si un fichier est partitionné par liste, la clé de partitionnement ne peut comporter qu'une seule colonne de la table.

  Le partitionnement basé sur la date est disponible lorsque vous chargez un dossier contenant au moins deux sources de données contenant des données de date ou d'horodatage.

  Pour partitionner en fonction de la DATE, cliquez sur la liste déroulante Colonne de partition et sélectionnez la colonne DATE ou TIMESTAMP à utiliser pour le partitionnement.

Onglet Paramètres - Section Propriétés

Indiquez les options permettant de contrôler la façon dont les données source sont interprétées, prévisualisées et traitées. Ces options varient en fonction du type de données source.

• Encodage : sélectionnez un type d'encodage de caractères dans la liste. Cette option est disponible lorsque le fichier chargé est en format texte brut (CSV, TSV ou TXT). Le type d'encodage par défaut est UTF-8.

• Texte englobant : sélectionnez le caractère englobant le texte : " (caractère entre guillemets), ' (caractère entre guillemets simples) ou Aucun. Cette option est visible uniquement lorsque le fichier sélectionné est en format texte brut (CSV, TSV ou TXT).

• Délimiteur de champ : sélectionnez le caractère de délimiteur utilisé pour séparer les colonnes de la source. Par exemple, si le fichier source utilise des points-virgules pour délimiter les colonnes, sélectionnez Semicolon dans cette liste. Par défaut, la valeur est Virgule. Cette option est visible uniquement lorsque le fichier sélectionné est en format texte brut (CSV, TSV ou TXT).

• Ligne d'en-tête de colonne : cochez la case Ligne d'en-tête de colonne pour utiliser les noms de colonne qui forment la table source dans la table cible.

  • En sélectionnant cette option, vous pouvez indiquer la ligne du fichier contenant les noms de colonne. Les lignes de la section Mise en correspondance, ci-dessous, sont remplies de ces noms (et des types de données existants, sauf si vous les modifiez).

  • Si vous désélectionnez cette option, la première ligne est traitée en tant que données. Pour spécifier des noms de colonne manuellement, entrez un nom pour chaque colonne cible dans la section Mise en correspondance. (Vous devrez également saisir des types de données.)

• 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 sélectionnez l'option Ligne d'en-tête de colonne sous Nom de colonne source (voir ci-dessous) et que vous entrez un nombre supérieur à 0 dans le champ Démarrer le traitement des données sur la ligne, ce nombre de lignes après la première ligne n'est pas chargé dans la cible.

  • Si vous désélectionnez l'option Ligne d'en-tête de colonne sous Nom de colonne source et que vous entrez un nombre supérieur à 0 dans le champ Démarrer le traitement des données sur la ligne, ce nombre de lignes, y compris la première ligne, n'est pas chargé dans la cible.

• Colonne numérique : cochez la case Convertir les données non valides en valeurs NULL pour convertir une valeur de colonne numérique non valide en valeur NULL.

• Nouvelles lignes incluses dans les valeurs de données : sélectionnez cette option s'il existe des caractères de nouvelle ligne ou revient au début de la ligne en cours sans avancer vers le bas dans les champs de données. La sélection de cette option augmente le temps nécessaire au traitement du chargement. Si vous ne sélectionnez pas cette option lors du chargement des données, les lignes avec des lignes nouvelles dans les champs seront rejetées. Vous pouvez afficher la ligne rejetée dans le panneau Job Report.

Modèle de paramètres

Paramètres de modification en masse

Recherche dans la colonne

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

• Sélectionnez CHAR dans le champ déroulant Type de données.

  
  Description de l'image Bulk-edit2.png

• Dans la liste Colonnes disponibles, cliquez sur les colonnes à sélectionner. Pour plus d'informations, reportez-vous à Recherche dans la colonne.

  
  Description de l'image Bulk-edit3.png

• Vous pouvez afficher les colonnes à modifier dans la liste Colonnes sélectionnées.
  Description de l'illustration bulk-edit4.png

  Cliquez sur Suivant pour accéder à l'onglet Aperçu.

• Vous pouvez afficher la table mise à jour dans l'aperçu de la table.

  
  Description de l'image Bulk-edit5.png

  Cliquez sur OK.

• La table Mise en correspondance indique que le type de données des lignes sélectionnées est passé de VARCHAR2 à CHAR.

  
  Description de l'image Bulk-edit6.png

Onglet Paramètres - Section Mappage

Les paramètres de la section Mise en correspondance contrôlent la façon dont les données des fichiers source sont chargées dans les lignes de la table de base de données cible. Pour chaque ligne, les données de la colonne indiquée sous Colonne source sont chargées dans la colonne répertoriée sous Colonne cible.

Comme indiqué ci-dessus, le contenu de la table Mise en correspondance change en fonction de l'option de traitement que vous avez choisie dans la section Table et des propriétés que vous avez définies dans la section Propriétés.

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 de phrase clé avec les données source. Pour plus d'informations, reportez-vous à Utilisation des fonctionnalités du service OCI Language dans Data Studio.

• Inclure : cette case à cocher garantit que la ligne que vous sélectionnez est chargée de la colonne source vers la colonne cible.

• Colonne source : répertorie les colonnes du fichier source.

  Si l'option Ligne d'en-tête de colonne sous Propriétés est sélectionnée, l'option Colonne source affiche les noms des colonnes dans le fichier source. Si l'option Ligne d'en-tête de colonne n'est pas sélectionnée, des noms génériques tels que COLUMN_1, COLUMN_2, etc., sont utilisés. Ce champ est toujours en lecture seule.

  Vous pouvez visualiser deux colonnes source FILE$NAME et SYSTIMESTAMP. La colonne FILE$NAME permet de localiser le fichier source contenant un enregistrement de données particulier. Par exemple, vous chargez un fichier source qui contient une liste de fichiers. Les noms de fichier dans la liste des fichiers font référence aux noms de service dans toute l'organisation. Par exemple, un fichier finance.txt contient des données du service financier. Dans le mapping, vous pouvez utiliser des types de données de type chaîne pour extraire le nom du service de la sortie de la colonne de nom de fichier. Vous pouvez utiliser le nom du service extrait pour traiter les données différemment pour chaque service.

  La colonne SYSTIMESTAMP permet de visualiser l'horodatage en cours dans la base de données.

  Remarque
  
  

  • Les colonnes source FILE$NAME et SYSTIMESTAMP ne sont pas incluses par défaut. Vous devez cocher la case Inclure et exécuter le chargement pour la table cible afin d'afficher ces deux colonnes.
  • Lorsque vous créez un flux d'activité, les colonnes source FILE$NAME et SYSTIMESTAMP apparaissent par défaut dans la table de mapping.

• Colonne cible : répertorie les colonnes de la table cible. Acceptez, sélectionnez ou entrez une colonne dans la table cible. Vous devez vous assurer que la colonne cible n'est pas vide. Le nom de colonne cible ne peut pas avoir un nom en double en tant qu'autre colonne cible. La longueur de la colonne cible ne doit pas dépasser 128 octets. La limite de 128 octets est une limite de base de données.

  Le contenu de cette colonne varie selon ce que vous avez sélectionné pour l'option de traitement de table et selon que vous avez sélectionné l'option Ligne d'en-tête de colonne.

  • Si (1) l'option de traitement est Créer une table ou Supprimer une table et créer une table et (2) l'option Ligne d'en-tête de colonne est sélectionnée, la colonne cible utilise les noms des colonnes dans le fichier source. Vous pouvez modifier le nom d'une colonne cible en remplaçant le nom fourni par un nouveau nom.

  • Si (1) l'option de traitement est Créer une table ou Supprimer une table et créer une table et (2) que l'option Ligne d'en-tête de colonne n'est pas sélectionnée, les noms génériques tels que COLUMN_1, COLUMN_2, etc., sont utilisés. Vous pouvez modifier le nom d'une colonne cible en remplaçant le nom fourni par un nouveau nom.

  • Si (1) l'option de traitement est Insertion dans la table, Remplacer les données ou Fusionner dans la table et (2) l'option Ligne d'en-tête de colonne est sélectionnée, la colonne cible comporte une liste déroulante de toutes les colonnes de la table cible, avec leurs types de données. Par défaut, la colonne dont le nom correspond à la colonne source est sélectionnée, mais vous pouvez en sélectionner une autre dans la liste.

  • Si (1) l'option de traitement est Insertion dans la table, Remplacer les données ou Fusionner dans la table et (2) que l'option Ligne d'en-tête de colonne n'est pas sélectionnée, la colonne cible comporte une liste déroulante de toutes les colonnes de la table cible, avec leurs types de données. Sélectionnez une colonne dans la liste à utiliser comme colonne cible.

  Remarque
  
  

  Si vous chargez plusieurs fichiers à partir d'un dossier dans un seul travail de chargement de données, seul le premier fichier sera affiché dans la section Mise en correspondance. Toutefois, tant que les noms de colonne et les types de données correspondent, les données de tous les fichiers source sont chargées.

• Type de données : répertorie le type de données à utiliser pour les données de cette colonne. Cette colonne est affichée uniquement pour Créer une table ou Supprimer une table et créer une table. Le contenu varie selon que l'option Obtenir à partir de l'en-tête de fichier est sélectionnée ou non.

  • Si l'option Obtenir à partir de l'en-tête de fichier est sélectionnée, le champ Type de données affiche les types de données des colonnes du fichier source (pour Créer une table) ou de la table existante (pour Supprimer une table et créer une table). Si vous souhaitez modifier le type de données de la cible, cliquez sur le nom et sélectionnez-en un autre dans la liste.

  • Si l'option Ligne d'en-tête de colonne n'est pas sélectionnée, le champ Type de données affiche tous les types de données disponibles. Sélectionnez le type de données à utiliser pour la colonne cible dans la liste.

• Longueur/précision (facultatif) : Pour les colonnes dont le type de données est NUMBER, entrez la longueur/la précision des nombres de la colonne. La précision est le nombre de chiffres significatifs d'un nombre. La précision peut être comprise entre 1 et 38.

  Pour les colonnes dont le type de données est VARCHAR2, la valeur Auto du champ Longueur/précision active la fonction de taille automatique.

  Avec la fonction de dimensionnement automatique de la largeur de colonne, vous pouvez définir automatiquement la taille de n'importe quelle colonne afin qu'elle contienne la valeur la plus grande. Sélectionnez Auto dans la liste déroulante Longueur/précision ou choisissez une valeur dans la liste déroulante.

• Echelle (facultatif) : pour les colonnes dont le type de données est NUMBER, entrez l'échelle des nombres dans la colonne. L'échelle représente le nombre de chiffres à droite du séparateur décimal (positif) ou à gauche (négatif). L'échelle peut être comprise entre -84 et 127,

• Format : si le type de données dans la colonne Type de données est DATE ou l'un des types TIMESTAMP, sélectionnez un format pour ce type dans la liste déroulante Format.

• Clé de fusion : cette option est utilisée uniquement pour l'option de traitement Fusionner dans une table.

  Pour l'option Fusionner dans une table, vous devez indiquer au moins une colonne à utiliser comme colonne de clé. Les clés de fusion sont une ou plusieurs colonnes qui identifient de manière unique chaque ligne de la table. Pour spécifier une colonne de clé, cochez la case Fusionner la clé de la colonne. 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 en tant que clés de fusion.

Onglet Aperçu

L'onglet Aperçu affiche les données source sous forme de tableau dans le menu Prévisualiser le chargement. L'affichage reflète les paramètres choisis dans la section Propriétés.

Le menu Fichier de l'onglet Aperçu affiche les données source avec toutes les colonnes avec leur nom. Vous pouvez copier le texte.

Onglet Table

L'onglet Table affiche à quoi la table cible doit ressembler une fois les données chargées. Si vous avez choisi l'option de traitement Créer une table, aucune table n'est affichée.

Onglet SQL

L'onglet SQL affiche les commandes SQL qui seront exécutées pour terminer ce travail de chargement de données.

Bouton Fermer - Enregistrer et fermer le volet

Après avoir entré tous les détails du travail de chargement de données, cliquez sur Fermer en bas de la page. Les détails que vous avez saisis sont enregistrés et vous êtes renvoyé au panneau Charger les données à partir du stockage cloud. Pour fermer la page sans enregistrer vos entrées, appuyez sur Echap.