Sélection de la cible pour une tâche de chargement de données

Sélectionnez la ressource de données, la connexion et le schéma à utiliser comme cible. Configurez ensuite une nouvelle entité cible ou sélectionnez une entité de données existante dans laquelle charger les données.

Sélection d'une ressource de données cible, d'une connexion et d'un schéma

Pour configurer l'entité de données cible pour une tâche de chargement de données, vous commencez par sélectionner une ressource de données, une connexion et un schéma.

Vous pouvez paramétrer les ressources après avoir effectué les sélections.

  1. Dans la page Créer une tâche de chargement de données, allez à l'étape Cible.
  2. Pour créer et sélectionner la ressource de données pour cette cible, sélectionnez Créer à côté de Ressource de données pour créer une ressource de données.
  3. Pour sélectionner une entité de données cible dans une ressource de données existante, utilisez d'abord les menus de ressources pour sélectionner la ressource de données, la connexion et le schéma (ou le seau) dans l'ordre affiché. Notez ce qui suit :
    • Les ressources de données disponibles pour sélection dépendent du type de cible que vous avez sélectionné à l'étape Informations de base. Sélectionnez Tout voir à côté d'une ressource si vous ne trouvez pas ce que vous voulez dans le menu de ressources.

    • Si applicable à une ressource de données (par exemple, Stockage d'objets), sélectionnez un compartiment avant de sélectionner un seau (schéma).

    • Pour une connexion de base de données, vous pouvez sélectionner Ajouter pour créer et ajouter la connexion.

  4. (Facultatif) Vous pouvez affecter un paramètre à la ressource de données, à la connexion et au schéma après avoir effectué des sélections pour les ressources. Effectuez l'une des opérations suivantes pour une ressource sur la cible :
    • Sélectionnez Parameterize (Parameteriser) à côté de la ressource pour affecter un paramètre à cette ressource. Lors du paramétrage, le service d'intégration de données ajoute un paramètre du type approprié et règle la valeur par défaut du paramètre à la valeur actuellement configurée pour cette ressource.
    • Si disponible, sélectionnez Réutiliser le paramètre <resource> source pour utiliser le même paramètre qui a été ajouté à la ressource du même type sur la source. Pour plus d'informations, voir Réutilisation des paramètres pour les ressources sources ou cibles.

    Notez que lorsque le type de ressource de données est Stockage d'objets, vous pouvez paramétrer le seau (schéma), mais pas le compartiment qui contient le seau.

  5. Selon le type de ressource de données de la cible, d'autres options peuvent être disponibles pour sélection.
    Type de ressource de données Option

    Stockage d'objets, HDFS

    Sous Paramètres de fichier, sélectionnez le type de fichier et le type de compression, ainsi que l'encodage, le cas échéant. Les types de compression disponibles pour sélection dépendent du type de fichier.

    Pour CSV, les autres paramètres que vous pouvez configurer sont les suivants :

    • Si tous les fichiers ont la première rangée en tant que rangée d'en-tête, sélectionnez Les données ont un en-tête.
    • Si les valeurs des rangées de données couvrent plusieurs lignes, sélectionnez Lignes multiples.
    • Spécifiez le caractère d'évaluation pour les autres caractères figurant dans les valeurs de données. Par exemple : \
    • Sélectionnez le délimiteur qui sépare les champs de données. Par exemple : COLON (:), COMMA (,), PIPE (|), SEMICOLON (;) ou TAB (\t)
    • Spécifiez le caractère guillemet qui traite les autres caractères en tant que caractères littéraux. Par exemple : "
    • Si un délimiteur de colonne est inclus à la fin d'une rangée de données dans tous les fichiers, sélectionnez Délimiteur de fin.

    Les éléments suivants ne sont disponibles que lorsque vous avez sélectionné Utiliser une entité de données existante sous Paramètres de chargement des entités de données cibles : Pour les fichiers JSON, sélectionnez Utiliser un schéma personnalisé si vous voulez coller ou charger un exemple de schéma personnalisé utilisé pour déduire la forme de l'entité.

    • Si vous sélectionnez Charger, déposez un fichier de schéma personnalisé dans la zone fournie ou cliquez sur Sélectionner un fichier pour sélectionner le fichier de schéma à charger.

    • Si vous sélectionnez Coller dans le schéma, copiez le contenu du fichier texte du schéma et collez-le dans la zone fournie.

    Autonomous Data Warehouse, Autonomous Transaction Processing

    • Si la ressource de données que vous sélectionnez est configurée avec un emplacement temporaire par défaut, le service d'intégration de données utilise automatiquement ce seau de stockage d'objets pour le stockage temporaire. Utilisez l'emplacement temporaire par défaut configuré pour la ressource de données ou spécifiez un autre emplacement temporaire.

      Pour utiliser un autre emplacement temporaire, sous Emplacement temporaire, désélectionnez la case Utiliser les paramètres d'emplacement temporaire par défaut. Utilisez ensuite les menus de ressources pour sélectionner une ressource de données de stockage d'objets, une connexion, un compartiment, puis un seau (schéma) à utiliser pour le stockage temporaire.

    • Si la ressource de données que vous sélectionnez n'a pas d'emplacement intermédiaire par défaut configuré, utilisez les menus de ressources pour sélectionner une ressource de données de stockage d'objets, une connexion, un compartiment, puis le seau (schéma) à utiliser pour le stockage temporaire.

Après avoir sélectionné la ressource de données, la connexion, le schéma (ou le seau) et les options cibles applicables, configurez les paramètres de chargement de la cible pour une nouvelle entité de données ou une entité de données existante.
Utilisation de nouvelles entités de données cibles

Le service d'intégration de données peut créer de nouvelles entités de données cibles lors du chargement de données à partir des entités sources.

Pour le type de chargement Entité de données unique, vous ne pouvez utiliser un paramètre pour l'entité de données que si vous choisissez l'option d'entrée d'un nom d'entité de données.

  1. Allez à l'étape Cible, onglet Entités de données.
  2. Sous Paramètres de chargement des entités de données cibles, sélectionnez Créer une nouvelle entité de données.

    Pour une nouvelle cible, la stratégie d'intégration est toujours Insérer.

  3. Pour le stockage d'objets cible uniquement : Cochez la case Créer la sortie en tant que fichier unique si vous voulez utiliser un seul fichier de sortie. Sinon, plusieurs fichiers sont créés.

    Le fichier de sortie unique est remplacé chaque fois que la tâche est exécutée. La création d'un fichier de sortie unique peut avoir une incidence sur la performance du service d'intégration de données. N'utilisez pas l'option de fichier de sortie unique pour les jeux de données grands.

    Pour le type de chargement de plusieurs entités de données, chaque nouvelle entité de la cible a un fichier unique correspondant.

  4. Spécifiez l'option Nom de l'entité de données cible voulue pour la nouvelle cible. Vous pouvez choisir parmi les suivants :
    • Utiliser les mêmes noms d'entité que la source : Sélectionnez cette option pour créer des entités cibles portant les mêmes noms que les entités sources.

    • Ajouter un préfixe/suffixe : Sélectionnez cette option pour ajouter une chaîne au début ( préfixe) ou à la fin (suffixe) des noms des entités sources pour créer les noms des entités cibles.

    • (Pour le type de chargement d'entité unique) Sélectionner un nom d'entité : Entrez le nom de la nouvelle entité cible.

      • Pour le service de stockage d'objets : Entrez le nom de la nouvelle entité de données, suivi d'une barre oblique (/). Par exemple, entrez newfile/ ou newdirectory/newfile/. Toutefois, si vous cochez la case Créer la sortie en tant que fichier unique pour créer un fichier de sortie unique, entrez le nom de la nouvelle entité sans la barre oblique (/) à la fin.

      • Pour une cible de base de données : Si le nom d'entité que vous indiquez existe déjà, le résultat de l'opération dépend de la forme de la cible dans la tâche de chargement de données et de la forme de l'entité existante.

  5. (Facultatif) (Pour un type de chargement d'entité unique uniquement) Vous ne pouvez affecter un paramètre à l'entité de données que si vous avez sélectionné d'entrer un nom d'entité de données à l'étape précédente. Effectuez l'une des actions suivantes :
    • Sélectionnez Parameterize (Parameteriser) à côté de la ressource pour affecter un paramètre à cette ressource. Lors du paramétrage, le service d'intégration de données ajoute un paramètre du type approprié et règle la valeur par défaut du paramètre à la valeur actuellement configurée pour cette ressource.
    • Si disponible, sélectionnez Réutiliser le paramètre d'entité de données source pour utiliser le paramètre d'entité source en tant que paramètre pour cette entité de données cible. Pour plus d'informations, voir Réutilisation des paramètres pour les ressources sources ou cibles.
  6. S'il y a lieu, sélectionnez l'onglet Paramètres et entrez une valeur pour la limite de rejet.

    For une base de données Autonomous Data Warehouse ou Autonomous Transaction Processing :

    Vous pouvez indiquer le nombre maximal de rangées erronées dont le chargement dans la cible peut échouer, avant l'échec de la tâche. Par exemple, si la source de données contient 1 000 rangées et que vous réglez la limite de rejet à 200, la tâche échoue immédiatement après le rejet de la 200e rangée erronée.

    Si vous ne spécifiez pas de valeur, la valeur par défaut est zéro, ce qui signifie que la tâche échoue lors du rejet de la première rangée erronée.

    En cas d'échec d'une tâche, recherchez dans les journaux les noms des tables dans lesquelles les rangées ont été rejetées. Interrogez ensuite les tables et les rangées concernées dans la base de données autonome.

Utilisation d'entités de données cibles existantes

Lorsque vous utilisez des entités de données cibles existantes, vous sélectionnez la stratégie d'intégration qui détermine comment charger les données dans la cible existante.

Pour un type de chargement d'entité de données unique, vous pouvez utiliser un paramètre pour l'entité de données après avoir sélectionné une entité de données.

  1. Allez à l'étape Cible, onglet Entités de données.
  2. Sous Paramètres de chargement des entités de données cibles, sélectionnez Utiliser une entité de données existante.
  3. Pour spécifier comment charger les données dans la cible, sélectionnez une des options de stratégie d'intégration disponibles.
    • Insérer : Permet d'insérer de nouveaux enregistrements ou d'ajouter les enregistrements lorsque les données existent dans la cible.

    • Remplacement : Vide la cible avant d'insérer de nouveaux enregistrements.

      La stratégie d'intégration doit être Remplacement si vous voulez créer un fichier de sortie unique pour la cible de stockage d'objets.

    • Fusion :Insère de nouveaux enregistrements et les fusionne avec les enregistrements existants. La stratégie de fusion n'est disponible que pour les cibles de base de données.

      Pour le type de chargement Entité de données unique (voir étape 5), vous avez la possibilité de sélectionner une clé unique autre que la clé primaire pour fusionner les données.

      Pour le type de chargement Plusieurs entités de données, la clé primaire est utilisée par défaut. Aucune autre action ou sélection n'est nécessaire.

  4. Pour la stratégie de remplacement et la cible du stockage d'objets uniquement : Cochez la case Créer la sortie en tant que fichier unique si vous voulez utiliser un seul fichier de sortie. Sinon, plusieurs fichiers sont créés.

    Le fichier de sortie unique est remplacé chaque fois que la tâche est exécutée. La création d'un fichier de sortie unique peut avoir une incidence sur la performance du service d'intégration de données. N'utilisez pas l'option de fichier de sortie unique pour les jeux de données volumineux.

    Pour plusieurs types de chargement d'entités de données, chaque entité sélectionnée dans la cible a un fichier unique correspondant.

  5. Pour le type de chargement entité de données unique :
    1. Dans le tableau Entités de données disponibles, sélectionnez une entité de données. Vous pouvez :
      • Cochez la case à côté d'un nom d'entité, puis sélectionnez Définir comme cible.

      • Filtrer la liste en entrant un nom ou un modèle dans le champ et en appuyant sur Entrée.

        Vous pouvez entrer un nom partiel ou un modèle à l'aide de caractères spéciaux tels que *. Par exemple, vous pouvez entrer ADDRESS_* pour rechercher ADDRESS_EU1, ADDRESS_EU2 et ADDRESS_EU3.

        Dans la liste filtrée, cochez la case située à côté du nom d'une entité, puis sélectionnez Définir comme cible.

      • Pour une cible de stockage d'objets avec la stratégie d'intégration Remplacement, sélectionnez une entité de données existante dont le nom ne comporte pas de barre oblique (/) finale.
      Le nom de l'entité de données que vous avez sélectionnée s'affiche à côté de l'étiquette Entités de données sélectionnées. Pour sélectionner une autre entité de données à utiliser comme cible, sélectionnez Supprimer, puis sélectionnez l'entité dans le tableau Entités de données disponibles.
    2. (Facultatif) Vous pouvez affecter un paramètre à l'entité de données après avoir sélectionné une entité de données à l'étape précédente. Effectuez l'une des actions suivantes :
      • Sélectionnez Parameterize (Parameteriser) à côté de la ressource pour affecter un paramètre à cette ressource. Lors du paramétrage, le service d'intégration de données ajoute un paramètre du type approprié et règle la valeur par défaut du paramètre à la valeur actuellement configurée pour cette ressource.
      • Si disponible, sélectionnez Réutiliser le paramètre d'entité de données source pour utiliser le paramètre d'entité source en tant que paramètre pour cette entité de données cible. Pour plus d'informations, voir Réutilisation des paramètres pour les ressources sources ou cibles.
    3. (Facultatif) Pour une cible de base de données avec la stratégie d'intégration Fusion :

      La clé de fusion identifie le ou les attributs permettant de déterminer les rangées existantes ou les nouvelles rangées à mettre à jour ou à insérer. Vous pouvez sélectionner une clé principale/unique ou une clé non principale comme clé de fusion.

      Cliquez sur Sélectionner ou sur Modifier. Dans le panneau Clé de fusion, effectuez l'une des actions suivantes :

      • Sélectionnez Attributs de clé principale/unique et sélectionnez une clé.
      • Sélectionnez Autres attributs pour utiliser d'autres attributs (non principaux). Entrez un nom pour la clé de fusion et sélectionnez les attributs dans la liste.
  6. Pour le type de chargement Multiple data entity (Plusieurs entités de données) : Par défaut, les entités de données sources sont automatiquement mappées aux entités de données cibles disponibles par nom.
    1. Dans le tableau Entités de données sources, colonne Mappage, vous pouvez placer le curseur sur un mappage comportant une coche verte pour voir le nom de l'entité cible mappée.
    2. Pour créer un mappage manuel, faites glisser l'entité de données source vers l'entité de données cible. Une règle de mappage est ajoutée lorsque vous effectuez un mappage manuel.
    3. Pour supprimer un mappage AUTO ou manuel, dans le tableau Entités de données cibles, colonne Mappage, sélectionnez Effacer à côté d'un mappage. Sélectionnez ensuite Annuler le mappage pour confirmer la suppression du mappage. Une règle de mappage est ajoutée lorsque vous supprimez un mappage.
    4. Dans le tableau Entités de données sources ou Entités de données cibles, vous pouvez :
      • Filtrer la liste en entrant un nom ou un modèle dans le champ et en appuyant sur Entrée.

        Vous pouvez entrer un nom partiel ou un modèle à l'aide de caractères spéciaux tels que *. Par exemple, vous pouvez entrer ADDRESS_* pour rechercher ADDRESS_EU1, ADDRESS_EU2 et ADDRESS_EU3.

      • Affichez toutes les entités, les entités mappées ou les entités non mappées, en sélectionnant l'option appropriée dans le menu situé au-dessus du tableau.

    5. Dans le menu Actions, vous pouvez sélectionner :
      • Mapper automatiquement par nom : Utilisez cette action pour permettre au service d'intégration de données de créer automatiquement des mappages entre les entités sources et les entités cibles par nom.

      • Mapper par modèle : Utilisez cette action pour définir un modèle source et un modèle cible pour mapper les entités sources aux entités cibles. La correspondance par modèle est sensible à la casse.

        Voir Mapper par modèle.

    Pour gérer les règles de mappage, voir Consultation et suppression de règles de mappage.
Consultation et suppression de règles de mappage (plusieurs entités de données cibles)

Le service d'intégration de données ajoute des règles de mappage lorsque vous mappez manuellement des entités de données sources à des entités de données cibles existantes pour une tâche de chargement de données.

Des règles sont également ajoutées lorsque vous supprimez des mappages.

  1. Allez à l'étape Cible, onglet Entités de données.
  2. Pour afficher les règles créées pour une tâche de chargement de données, sélectionnez Voir les mappages.
  3. Dans le panneau Règles de mappage d'entités, vérifiez les mappages que vous avez créés.
  4. Pour supprimer une règle de mappage, vous pouvez utiliser l'une des deux méthodes suivantes :
    • Cochez la case d'une règle, puis sélectionnez Supprimer.

    • Sélectionnez le menu Actions (Menu Actions) d'une règle, puis sélectionnez Supprimer.