# tHMapRecord

Note InformationsRemarque : Ce composant n'est pas intégré par défaut à votre Studio Talend. Pour l'utiliser, vous devez installer la fonctionnalité Data Mapper &gt; Talend Data Mapper pour Spark à l'aide du Gestionnaire des fonctionnalités. Pour plus d'informations, consultez [Installer les fonctionnalités à l'aide du Gestionnaire des fonctionnalités](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/install-features-to-talend-studio).

Ce composant exécute un mapping Talend Data Mapper dans lequel les structures d'entrée et de sortie peuvent varier, en tant qu'exécution Spark Streaming.

Note InformationsAvertissement : Ce composant est disponible dans la Palette du Studio Talend lorsque vous avez souscrit à l'une des solutions Talend avec Big Data.

Le tHMapRecord prend une connexion d'entrée venant d'un composant en amont et peut avoir une ou plusieurs connexions vers d'autres composants, le tout dans un environnement Spark.

## Propriétés du tHMapRecord pour Apache Spark Streaming

Ces propriétés sont utilisées pour configurer le tHMapRecord s'exécutant dans le framework de Jobs Spark Streaming.

Le composant tHMapRecord Spark Streaming appartient à la famille Processus en cours.

Le composant de ce framework est disponible dans Talend Real-Time Big Data Platform et Talend Data Fabric.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Storage | Pour vous connecter à une installation HDFS, cochez la case Define a storage configuration component et sélectionnez le nom du composant à utiliser, parmi ceux disponibles dans la liste déroulante.<br><br>Cette option nécessite d'avoir précédemment configuré la connexion à l'installation HDFS à utiliser, comme décrit dans la documentation du composant tHDFSConfiguration.<br><br>Si vous laissez la case Define a storage configuration component décochée, vous pouvez convertir les fichiers seulement en local. |
| Open Map Editor | Cliquez sur le bouton [...] pour ouvrir l'assistant Structure Generate/Select.<br><br>Vous pouvez d'abord sélectionner le type de map à créer :<br><br><ul> <li><span>Standard Map</span>&nbsp;: Les maps standards effectuent des mappings à l'aide de fonctions basées sur xQuery.</li> <li><span>DSQL Map</span>&nbsp;: Les maps DSQL effectuent des mappings à l'aide de <span>Data Shaping Query Language</span>.</li> </ul><br><br><br>Vous pouvez cocher la case Don't ask me again pour enregistrer cette préférence. Pour plus d'informations concernant ces types de maps, consultez [Utilisation de maps](https://help.qlik.com/talend/r/fr-FR/8.0/data-mapper-user-guide/working-with-maps).<br><br>Note InformationsRemarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle R2023-10 du Studio ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.<br><br>Vous pouvez ensuite obtenir une structure de mappeur hiérarchique générée automatiquement à partir du schéma ou sélectionner une structure de mappeur hiérarchique existante. Vous devez effectuer cette action pour l'entrée et la sortie de mapping. Voici les différentes options pour la structure de sortie :<br><br><ul> <li>                                 Option <span>Generate hierarchial mapper structure based on the schema</span>&nbsp;: lorsque le tHMap a plusieurs liens de sortie, la page affiche un message de confirmation vous informant que les structures de l'éditeur de mapping sont générées selon les liens de sortie.</li> <li>                                 Option <span>Select an existing hierarchical mapper structure</span>&nbsp;: vous pouvez relier plusieurs sorties basées sur le payload au tHMap. S'il n'y a qu'une seule connexion de type payload, vous pouvez cocher la case <span>Allow support for multiple output connections</span>.                                 Le mapping de sortie généré hérite de la structure du payload existante.</li> </ul><br><br>Si le Studio Talend détecte plusieurs liens de sortie disponibles, la fenêtre affiche les différentes options de structure de sortie mais pas la case Allow support for multiple output connections.<br><br>S'il n'existe aucun lien d'entrée ou de sortie, la page Structure Selection s'ouvre. |
| Synchronize map with schema connections | Cochez cette case si vous souhaitez générer à nouveau automatiquement vos structures d'entrée et de sortie de map après modification de l'une d'entre elles :<br><br><ul> <li>Modification de la métadonnées de connexion</li> <li>Connexion d'entrée ou de sortie ajoutée</li> <li>Connexion d'entrée ou de sortie supprimée</li> </ul><br><br><br>Aucune modification n'est détectée lorsqu'une connexion est activée ou désactivée.<br><br>Si cette case est cochée, la map est automatiquement synchronisée lorsqu'elle est ouverte à partir du composant, après une modification. Sinon, une boîte de dialogue s'ouvre et vous propose de synchroniser.<br><br>Note InformationsRemarque : Pour les structures avec plusieurs connexions, la map peut uniquement être synchronisée si les structures ont été créées de la même manière que celles générées par l'assistant de configuration du composant. Par exemple, les maps d'aplatissement avec plusieurs sorties ne peuvent être synchronisées. |
| Map Path | Cliquez sur [...] pour sélectionner une map existante. La fenêtre s'affiche dans un assistant vous permettant de sélectionner une map depuis la vue Hierarchical Mapper de Talend Data Mapper. |
| Die on error | Cochez cette case pour arrêter l'exécution du Job lorsqu'une erreur survient.<br><br>Décochez la case pour ignorer les lignes en erreur et terminer le processus. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| Use old Eclipse runtime (deprecated) | Cochez cette case pour inclure l'ancien environnement d'exécution Eclipse dans votre Job.<br><br>Note InformationsRemarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle R2024-03 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.<br><br>Note InformationsRemarque : À partir de la version 8.0 R2025-04 du Studio Talend, le paramètre Use old Eclipse runtime (deprecated) est supprimé. |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| Règle d'utilisation | Ce composant est utilisé avec le tHDFSConfiguration, définissant la connexion au stockage HDFS, ou en tant que composant standalone pour mapper des fichiers locaux uniquement. |
| Fonctionnalité glisser-déposer | Si vous avez une map tHMapRecord existante dans la vue Data Mapping, vous pouvez glisser-déposer facilement la map :<br><br><ul> <li>Lorsque vous glissez puis déposez la map tHMapRecord dans l'espace de travail, le composant tHMapRecord est automatiquement créé.</li> <li>Lorsque vous glissez puis déposez la map tHMapRecord dans le composant tHMapRecord existant, le libellé et la référence de la map du composant sont automatiquement mis à jour.</li> </ul> |
| Utilisation avec Talend Runtime | Si vous souhaitez déployer un Job ou une Route contenant un composant de mapping de données avec Talend Runtime, vous devez d'abord installer la fonctionnalité Talend Data Mapper. Pour plus d'informations, consultez [Utiliser Talend Data Mapper avec Talend Runtime](https://help.qlik.com/talend/r/fr-FR/8.0/data-mapper-user-guide/using-talend-data-mapper-with-talend-runtime). |

**Concepts associés**

* [Connexion du tHMapRecord à plusieurs sorties](https://help.qlik.com/talend/fr-FR/components/8.0/data-mapping/thmaprecord-tfixedflowinput-tlogrow-tlogrow-connecting-thmaprecord-to-multiple-outputs-in-this "Vous pouvez créer un Job comprenant une connexion d'entrée, le composant tHMapRecord et plusieurs connexions de sortie de type schéma ou payload.")