Configuration de l'ordre de chargement des données

0

Aucune validation n'intervient jusqu'à ce que l'élément de chargement ait terminé le traitement de ses données en entrée. Si une exception est émise, les enregistrements dont le traitement abouti peuvent être validés. Si l'exception est une exception SQL, l'utilitaire restaure toutes les données qui ont été traitées après le dernier enregistrement validé. Si un type différent d'exception est émis, il restaure uniquement les données dont le traitement a échoué. L'opération de chargement valide les enregistrements dont le traitement a abouti.

N

Où N est un entier positif. Le nombre de validations spécifie combien de lignes sont traitées avant l'appel de validation dans la base de données. La valeur par défaut est 1.

Vous pouvez inclure la propriété de configuration "rollbackForAnyException" pour contrôler les données que l'utilitaire restaure lorsqu'une exception est émise. Si la propriété a pour valeur true, l'utilitaire restaure toutes les données qui ont été traitées après le dernier enregistrement validé à chaque fois qu'une exception survient. Cette restauration a lieu quel que soit le type d'exception. Vous pouvez définir cette propriété dans la configuration de chaque élément de chargement ou dans l'élément <_config:LoadOrder> parent pour qu'elle s'applique à tous les éléments de chargement.

Insérer

Toutes les données sont insérées dans la base de données. L'utilitaire génère des instructions SQL d'insertion. Ce mode est recommandé pour un chargement initial des données. Si votre fichier de données contient des indicateurs de suppression (delete), ils sont ignorés.

En mode insertion, vous pouvez spécifier une plage de clés primaires à utiliser si l'objet n'existe pas dans la base de données et requiert la génération d'une nouvelle clé. Spécifiez la valeur dans l'élément <_config:BusinessObjectMediator>. Par exemple :

startKey="100001" endKey="200001"

Les éditeurs de données pris en charge en mode insertion sont les suivants :

• Editeur de données JDBC
• Editeur de données de chargement natif

Remarque : L'exécution de l'utilitaire de chargement de données en mode insertion peut améliorer les performances du chargement initial de grandes quantités de données. Toutefois, lorsque vous exécutez l'utilitaire de chargement de données en mode insertion, celui-ci ne vérifie pas votre base de données avant de charger vos données d'entrée. Il ne détermine pas si les objets de données que vous créez existent déjà dans votre base de données avant de tenter de charger et de créer des objets de données. Ce comportement peut entraîner l'échec du processus de chargement lorsque l'utilitaire tente de créer les objets de données qui existent déjà dans votre base de données.

Par exemple, si votre fichier d'entrée est un fichier CSV contenant une ligne qui crée un produit et une description de produit, et si le fichier contient une deuxième ligne qui charge le même produit dont la description est dans une autre langue, le processus de chargement échoue. Etant donné que l'utilitaire crée le produit et la description de la première ligne, lorsqu'il atteint la deuxième ligne, il tente de créer le produit à nouveau. Comme le produit existe, le chargement échoue. Pour charger ces données de produit et de description, vous pouvez utiliser l'une des méthodes suivantes :

• Exécutez l'utilitaire de chargement de données en mode remplacement.
• Exécutez l'utilitaire de chargement de données en mode insertion, mais chargez les informations de produit et de description séparément. Utilisez un fichier d'entrée pour charger les informations de produit, et un autre fichier d'entrée pour charger toutes les descriptions.

Pour plus d'informations sur la configuration de l'utilitaire de chargement de données pour qu'il s'exécute en mode insertion, voir Scénario : Chargement initial.

Remplacer

Valeur par défaut : toutes les données sont remplacées dans la base de données. L'utilitaire génère des instructions SQL d'insertion, de mise à jour et de suppression en fonction des données. Le mode remplacement remplace les données existantes dans la base de données par les données d'entrée. Ainsi, si des informations de colonne sont absentes des données d'entrée, la colonne est mise à jour avec la valeur Null ou la valeur par défaut, si celle-ci existe. Par exemple :

• Si un enregistrement (ligne) de votre fichier de données représente un nouvel objet, il est inséré.
• Si l'objet figure déjà dans la base de données, il est remplacé.
• Si les données comporte un indicateur qui spécifie que cet objet doit être supprimé, l'objet est supprimé.

En mode remplacement, ne spécifiez pas de valeur de plage de clés primaires car vous risquez de provoquer des conflits de clé dans la base de données.

Les éditeurs de données pris en charge en mode remplacement sont les suivants :

• Editeur de données JDBC
• Editeur de données de chargement natif

Remarque : Vous pouvez éviter tout remplacement accidentel des informations dans la base de données par des données de type null. Modifiez les données d'entrée d'origine utilisées dans le chargement initial lorsque vous remplacez un sous-ensemble des données d'origine. Ne spécifiez pas de zones vides dans votre fichier source, sauf si vous désirez que ces zones contiennent des données Null dans la base de données.

Pour plus d'informations sur la configuration de l'utilitaire de chargement de données pour qu'il s'exécute en mode remplacement, voir Scénario : Chargement delta.

Mettre à jour

Les données d'entrée de catalogue et de description d'entrée de catalogue spécifiées sont mises à jour dans la base de données. L'utilitaire compare les données d'entrée de catalogue dans le fichier d'entrée avec les données correspondantes pour les entrées de catalogue dans la base de données. Ensuite, il remplace ou ajoute les données nouvelles ou modifiées uniquement pour les colonnes qui sont spécifiées dans le fichier d'entrée. Les autres colonnes restent inchangées.

Le mode mise à jour ne prend en charge que l'éditeur de données JDBC.

Remarque : l'utilitaire de chargement de données peut s'exécuter en mode mise à jour pour ne charger que les informations d'entrée de catalogue ou de description d'entrée de catalogue.

Pour plus d'informations sur la configuration de l'utilitaire de chargement de données pour qu'il s'exécute en mode mise à jour, voir Scénario : Chargement de mise à jour d'entrée de catalogue.

Supprimer

Toutes les données qui sont identifiées dans le fichier d'entrée et qui se trouvent dans la base de données sont supprimées de la base de données. Dans ce mode, l'utilitaire ignore la valeur qui figure dans l'élément ou dans la colonne Delete dans un fichier d'entrée. Il génère les instructions SQL de suppression qui sont nécessaires pour supprimer les objets dans le fichier d'entrée. Lorsque vous exécutez l'utilitaire dans ce mode, l'éditeur de données JDBC seulement est pris en charge.

Remarque : Si votre site utilise la recherche HCL Commerce, il se peut que l'index de recherche delta ne soit pas régénéré correctement lorsque vous supprimez certains objets de catalogue avec l'utilitaire de chargement de données en mode suppression. Lorsque vous supprimez un objet enfant d'une entrée de catalogue ou d'une catégorie avec l'utilitaire en mode suppression, l'objet enfant et l'objet parent sont supprimés de la régénération de l'index de recherche delta. Suite à cette suppression, il se peut que la catégorie ou l'entrée de catalogue parent ne soit plus indexée ou ne s'affiche plus correctement dans la boutique en ligne.

Servez-vous de l'utilitaire en mode remplacement pour supprimer des objets de catalogue lorsque votre site utilise la recherche HCL Commerce. Pour supprimer des objets avec l'utilitaire en mode remplacement, spécifiez la valeur 1 dans la colonne Delete d'un objet dans votre fichier d'entrée. Si vous décidez de supprimer des objets de catalogue avec l'utilitaire en mode suppression, exécutez une régénération d'index complète une fois l'opération de chargement terminée.

<_config:LoadItem name="CatalogGroup" businessObjectConfigFile=
"wc-loader-catalog-group.xml" >

<_config:DataSourceLocation location="CatalogGroups\CatalogGroups.xml"/>

<_config:DataSourceLocation location="CatalogGroups"/>

<?xml version="1.0" encoding="UTF-8" ?> 
<_config:DataLoadConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config 
../../../../xml/config/xsd/wc-dataload.xsd" 
xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
  <_config:DataLoadEnvironment configFile="wc-dataload-env.xml" />
  <_config:LoadOrder commitCount="100" batchSize="1" dataLoadMode="Replace">
    <_config:property name="firstTwoLinesAreHeader" value="true" />
    <_config:LoadItem name="CatalogGroup" businessObjectConfigFile="wc-loader-catalog-group.xml">
      <_config:property name="validateCatalogGroup" value="true" />
      <_config:DataSourceLocation location="CatalogGroups.csv" />
    </_config:LoadItem>
    <_config:LoadItem name="CatalogEntry" businessObjectConfigFile="wc-loader-catalog-entry.xml">
      <_config:DataSourceLocation location="CatalogEntries.csv" />
    </_config:LoadItem>
  </_config:LoadOrder>
</_config:DataLoadConfiguration>