Chargement de données à partir du stockage en nuage

Dans la carte du panier de liens de données, cliquez sur l'icône Actions et sélectionnez Paramètres pour ouvrir le volet Charger les données à partir du stockage en nuage pour cette tâche. Le volet contient :

• Onglet Paramètres - Section Table
• 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 Table

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

• Option : Sélectionnez un article dans la liste Option pour spécifier 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 contient un nom par défaut, basé sur le nom du fichier ou du dossier source. Vous pouvez le modifier si vous le souhaitez.

  • Insérer dans la 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 une liste des tables du schéma courant. 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 une liste des tables du schéma courant. Sélectionnez la table à utiliser.

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

  • Fusionner dans la table : Met à jour les rangées existantes et insère de nouvelles rangées dans la table. Lorsque vous sélectionnez cette option, le champ Nom de l'onglet Paramètres présente une liste des tables du schéma courant. Sélectionnez la table à utiliser.

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

  Note
  
  

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

  Pour vous accorder un 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 Development (Développement) présent dans le panneau de lancement :

  Grant PDB_DBA to USER;

  Vous pouvez maintenant voir 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 nouvelle table.

• Nom : Nom de la table cible.

• Colonne de partition :

  Les partitions de liste et les partitions basées sur une date sont les différents types de partitions disponibles lors du chargement des données.

  Le partitionnement par liste est requis lorsque vous souhaitez mapper des lignes à des partitions en fonction de valeurs discrètes.

  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.

  Note
  
  

  • 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 contienne qu'une seule valeur distincte pour toutes les rangées.
  • Si un fichier est partitionné par liste, la clé de partitionnement ne peut être constituée que d'une seule colonne de la table.

  Le partitionnement par 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

Spécifiez les options permettant de contrôler l'interprétation, l'aperçu et le traitement des données sources. Ces options varient en fonction du type de données sources.

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

• Clôture de texte : Sélectionnez le caractère pour l'inclusion de texte : " (caractère à guillemet double), ' (caractère à guillemet unique) ou Aucun. Cette option n'est visible que 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. La valeur par défaut est Virgule. Cette option n'est visible que lorsque le fichier sélectionné est en format texte brut (CSV, TSV ou TXT).

• Rangée d'en-tête de colonne : Cochez la case Rangée 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 quelle ligne du fichier contient les noms de colonne. Les rangées de la section Mappage ci-dessous sont remplies avec ces noms (et avec les types de données existants, sauf si vous les modifiez).

  • Si vous désélectionnez cette option, le premier enregistrement sera traité en tant que données. Pour spécifier les noms de colonne manuellement, entrez un nom pour chaque colonne cible dans la section Mappage. (Vous devrez également entrer des types de données.)

• Démarrer le traitement des données à la rangée : Spécifie le nombre de rangées à ignorer lors du chargement des données sources dans la cible :

  • Si vous sélectionnez l'option Rangée d'en-tête de colonne sous Nom de la colonne source (voir ci-dessous) et si vous entrez un nombre supérieur à 0 dans le champ Démarrer le traitement des données à la rangée, le nombre de rangées après la première rangée ne sera pas chargé dans la cible.

  • Si vous désélectionnez l'option Rangée d'en-tête de colonne sous Nom de la colonne source, et si vous entrez un nombre supérieur à 0 dans le champ Démarrer le traitement des données dans la rangée, le nombre de rangées, y compris la première rangée, ne sera pas chargé dans la cible.

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

• Nouvelles lignes incluses dans les valeurs de données : Sélectionnez cette option s'il y a des caractères de nouvelle ligne ou s'il retourne au début de la ligne courante sans avancer vers le bas dans les champs de données. La sélection de cette option augmentera le temps nécessaire au traitement du chargement. Si vous ne sélectionnez pas cette option lors du chargement des données, les lignes contenant des nouvelles lignes dans les champs seront rejetées. Vous pouvez voir la rangée rejetée dans le panneau Rapport de tâche.

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 rangées de VARCHAR2 à CHAR dans la table de mappage.

Description de l'illustration bulk-edit1.png

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

  
  Description de l'illustration bulk-edit2.png

• Dans la liste Available Columns (Colonnes disponibles), cliquez sur les colonnes à sélectionner. Pour plus d'informations, voir Recherche dans la colonne.

  
  Description de l'illustration bulk-edit3.png

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

  Cliquez sur Suivant pour passer à l'onglet Prévisualisation.

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

  
  Description de l'illustration bulk-edit5.png

  Cliquez sur OK.

• La table Mappage affiche que le type de données des rangées sélectionnées est passé de VARCHAR2 à CHAR.

  
  Description de l'illustration bulk-edit6.png

Onglet Paramètres - Section Mappage

Les paramètres de la section Mappage contrôlent la façon dont les données des fichiers sources sont chargées dans les rangées de la table de base de données cible. Pour chaque rangée, les données de la colonne répertoriée sous Colonne source seront chargées dans la colonne répertoriée sous Colonne cible.

Comme indiqué ci-dessus, le contenu de la table Mappage change en fonction de l'option de traitement que vous avez sélectionnée 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 mappage avec le champ Filtre rapide qui vous permet de filtrer les colonnes ou les expressions.

Sélectionnez Ajouter une expression pour effectuer une analyse de sentiments ou une extraction de phrases clés avec les données sources. Pour plus de détails, voir Utiliser les capacités du service de langue pour OCI dans Data Studio.

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

• Colonne source : Liste les colonnes du fichier source.

  Si l'option Rangée d'en-tête de colonne sous Propriétés est sélectionnée, la colonne source affiche les noms des colonnes dans le fichier source. Si l'option Rangée 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 voir deux colonnes sources FILE$NAME et SYSTIMESTAMP. La colonne FILE$NAME vous 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 de la liste font référence aux noms de service dans l'ensemble de l'organisation. Par exemple, un fichier finance.txt contient des données du service des finances. Dans le mappage, vous pouvez utiliser des types de données de type chaîne pour extraire le nom de 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 nous permet de voir l'horodatage courant dans la base de données.

  Note
  
  

  • Les colonnes sources 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 dynamique, les colonnes sources FILE$NAME et SYSTIMESTAMP apparaissent par défaut dans la table de mappage.

• Colonne cible : Liste 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 la colonne cible ne peut pas être 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 diffère selon ce que vous avez sélectionné pour le traitement de la table Option et selon que vous avez sélectionné l'option Rangée d'en-tête de colonne.

  • If (1) the processing option is Create Table or Drop Table and Create New Table and (2) the Column header row option is selected, then the Target column uses the names of the columns in the source file. Vous pouvez modifier le nom d'une colonne cible en remplaçant le nom fourni par un nouveau nom.

  • If (1) the processing option is Create Table or Drop Table and Create New Table and (2) the Column header row option is not selected, then generic names like COLUMN_1, COLUMN_2, etc., are used. Vous pouvez modifier le nom d'une colonne cible en remplaçant le nom fourni par un nouveau nom.

  • If (1) the processing option is Insert into Table, Replace Data, or Merge Into Table and (2) the Column header row option is selected, then the Target column has a drop-down list of all the columns in the target table, with their data types. Par défaut, la colonne portant le nom correspondant à la colonne source est sélectionnée, mais vous pouvez en sélectionner une autre dans la liste.

  • If (1) the processing option is Insert into Table, Replace Data, or Merge Into Table and (2) the Column header row option is not selected, then the Target column has a drop-down list of all the columns in the target table, with their data types. Sélectionnez une colonne dans la liste à utiliser comme colonne cible.

  Note
  
  

  Si vous chargez plusieurs fichiers à partir d'un dossier dans une seule tâche de chargement de données, seul le premier fichier sera affiché dans la section Mappage. Toutefois, tant que les noms de colonne et les types de données correspondent, les données de tous les fichiers sources sont chargées.

• Type de données : Liste 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 la table et créer une nouvelle table. Le contenu varie selon que l'option Obtenir à partir de l'en-tête de fichier est sélectionnée.

  • If the Get from file header option is selected, Data type shows the data types of the columns in the source file (for Create Table) or in the existing table (for Drop Table and Create New 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 Rangée d'en-tête de colonne est non sélectionnée, 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/précision des nombres dans la colonne. La précision est le nombre de chiffres significatifs dans un nombre. La précision peut aller de 1 à 38.

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

  Avec la fonction de taille automatique de la largeur de colonne, vous pouvez dimensionner automatiquement n'importe quelle colonne en fonction de la plus grande valeur de la colonne. Sélectionnez Automatique dans la liste déroulante Longueur/Précision ou sélectionnez une valeur dans la liste déroulante.

• Ajuster (Facultatif) : Pour les colonnes dont le type de données est NUMBER, entrez l'échelle des nombres dans la colonne. L'échelle est le nombre de chiffres à droite (positif) ou à gauche (négatif) du signe décimal. L'échelle peut aller de -84 à 127.

• Format: If the data type in the Data type column is DATE or one of the TIMESTAMP types, select a format for that type from the from the Format drop-down list.

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

  Pour l'option Fusionner dans la table, vous devez spécifier 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 rangée de la table. Pour spécifier une colonne de clé, cochez la case Clé de fusion de la colonne. Les clés de fusion ne doivent contenir aucune valeur nulle. Pour charger des 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 Prévisualisation affiche les données sources sous forme de tableau dans le menu Prévisualisation du chargement. L'affichage reflète les paramètres que vous avez sélectionnés dans la section Propriétés.

Le menu Fichier de l'onglet Prévisualiser affiche les données sources avec toutes les colonnes portant leur nom. Vous pouvez copier le texte.

Onglet Table

L'onglet Table affiche ce à quoi la table cible doit ressembler une fois les données chargées. Si vous avez sélectionné 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 cette tâche de chargement de données.

Bouton Fermer - Enregistrer et fermer le volet

Après avoir entré tous les détails de la tâche de chargement de données, cliquez sur Fermer au bas de la page. Cela enregistre les détails que vous avez entrés et vous ramène au volet Charger les données à partir du stockage en nuage. Pour fermer la page sans enregistrer vos entrées, appuyez sur Échapper.