# tHiveRow

Selon la nature de la requête et de la base de données, ce composant agit sur la structure même de la base de données ou sur les données (mais sans les manipuler).

Le tHiveRow exécute des requêtes Hive QL déclarées sur la base de données spécifiée. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de données en sortie.

Le SQLBuilder peut vous aider à rapidement et aisément écrire vos requêtes.

Ce composant peut également effectuer des requêtes sur une base de données HBase, une fois la case Store by HBase disponible et cochée.

Ce composant n'est pas intégré par défaut à votre Studio Talend. Vous devez l'installer à 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).

## Propriétés du tHiveRow Standard

Ces propriétés sont utilisées pour configurer le tHiveRow s'exécutant dans le framework de Jobs Standard.

Le composant tHiveRow Standard appartient aux familles Big Data et Bases de données.

Le composant de ce framework est disponible dans tous les produits Talend.

## Basic settings

Configuration de la connexion :

* Lorsque vous utilisez ce composant avec Google Dataproc :

  | Project ID | Saisissez l'ID de votre projet Google Cloud Platform.<br><br>Si vous n'êtes pas certain de l'ID de votre projet, vérifiez dans la page Manage Resources de vos services Google Cloud Platform. |
  | --- | --- |
  | Cluster ID | Saisissez l'ID de votre cluster Dataproc à utiliser. |
  | Region | Dans cette liste déroulante, sélectionnez la région Google Cloud à utiliser. |
  | Google Storage staging bucket | Comme un Job Talend nécessite ses fichiers .jar dépendants pour être exécuté, spécifiez le répertoire Google Storage dans lequel ces fichiers .jar sont transférés afin que votre Job accède à ces fichiers lors de l'exécution.<br><br>Le répertoire à saisir doit se terminer par une barre oblique (/). Si le répertoire n'existe pas, un répertoire est créé à la volée mais le bucket à utiliser doit déjà exister. |
  | Database | Saisissez dans ce champ le nom de la base de données. |
  | Provide Google Credentials in file | Lorsque vous lancez votre Job à partir d'une machine donnée sur laquelle Google Cloud SDK a été installé et vous a autorisé à utiliser vos identifiants de compte utilisateur·trice pour accéder à Google Cloud Platform, ne cochez pas cette case. Dans cette situation, cette machine est souvent votre machine locale.<br><br>Lorsque vous lancez votre Job à partir d'une machine distante, comme un Talend JobServer, cochez cette case et dans le champ Path to Google Credentials file qui s'affiche, saisissez le répertoire dans lequel ce fichier JSON est stocké dans la machine du Talend JobServer. Vous pouvez également cliquer sur le bouton [...] puis, dans la boîte de dialogue qui s'ouvre, parcourir le fichier JSON.<br><br>Pour plus d'informations concernant le fichier Google Credentials, contactez l'administrateur·trice de votre Google Cloud Platform ou consultez [Google Cloud Platform Auth Guide](https://cloud.google.com/docs/authentication). |

* Lorsque vous utilisez ce composant avec la distribution Microsoft HDInsight :

  | Livy configuration | Saisissez l'adresse et les informations d'authentification du cluster Microsoft HDInsight à utiliser. Par exemple, l'adresse peut être https://your\_hdinsight\_cluster\_name.azurehdinsight.net et les informations d'authentification peuvent être votre nom de compte Azure : yourname. Le Studio Talend utilise ce service pour soumettre le Job au cluster HDInsight.<br><br>Dans le champ Job result folder, saisissez l'emplacement où vous souhaitez stocker les résultats d'exécution du Job dans Azure Storage. |
  | --- | --- |
  | Job status polling configuration | Dans le champ Poll interval when retrieving Job status (in ms), saisissez l'intervalle de temps (en millisecondes) à l'issue duquel vous souhaitez que le Studio Talend interroge Spark au sujet du statut du Job. Par exemple, ce statut peut être Pending (en attente) ou Running (en cours d'exécution).<br><br>Dans le champ Maximum number of consecutive statuses missing, saisissez le nombre maximal de tentatives du Studio Talend pour obtenir un statut lorsqu'il n'y a pas de réponse. |
  | HDInsight configuration | <ul> <li> <span>L'identifiant <span>Username</span> est celui défini lors de la création de votre cluster. Vous pouvez le trouver dans le panneau <span>SSH + Cluster login</span>, dans votre cluster.</span> </li> <li>Le mot de passe <span>Password</span> est défini lors de la création de votre cluster HDInsight pour authentification dans ce cluster.</li> </ul> |
  | Windows Azure Storage configuration | Saisissez l'adresse et les informations d'authentification du compte Azure Storage ou ADLS Gen2 à utiliser. Dans cette configuration, vous ne définissez pas l'emplacement où lire ou écrire vos données métier, seulement où déployer votre Job.<br><br>Dans le champ Container, saisissez le nom du conteneur à utiliser. Vous pouvez trouver les conteneurs disponibles dans le panneau Blob, dans le compte Azure Storage à utiliser.<br><br>Dans le champ Deployment Blob, saisissez l'emplacement où vous souhaitez stocker le Job et ses bibliothèques dépendantes dans le compte Azure Storage.<br><br>Dans le champ Hostname, saisissez l'endpoint du service du Blob primaire de votre compte Azure Storage, sans la partie https://. Vous pouvez trouver cet endpoint dans le panneau Properties de ce compte de stockage.<br><br>Dans le champ Username, saisissez le nom du compte Azure Storage à utiliser.<br><br>Dans le champ Password, saisissez la clé d'accès du compte Azure Storage à utiliser. Cette clé se trouve dans le panneau Access keys de ce compte de stockage. |
  | Database | Saisissez dans ce champ le nom de la base de données. |

* Lorsque vous utilisez d'autres distributions :

  | Connection mode | Sélectionnez un mode de connexion dans la liste. Les options varient en fonction de la distribution que vous utilisez. |
  | --- | --- |
  | Version de Hive | Sélectionnez la version de Hive que vous utilisez. |
  | Host | Saisissez l'adresse IP du serveur de la base de données. |
  | Port | Saisissez le numéro du port d'écoute du serveur de la base de données. |
  | Base de données | Saisissez dans ce champ le nom de la base de données. |
  | Username et Password | Informations d'authentification de l'utilisateur ou de l'utilisatrice de base de données.<br><br>Pour saisir le mot de passe, cliquez sur le bouton [...] à côté du champ Password, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles et cliquez sur OK afin de sauvegarder les paramètres. |
  | Use kerberos authentication | Si vous accédez au Metastore de Hive avec une sécurité Kerberos, cochez cette case et saisissez ensuite les paramètres appropriés dans les champs qui s'affichent.<br><br>Les valeurs des paramètres suivants peuvent être trouvées dans le fichier *hive-site.xml* du système Hive utilisé.<br><br><ol> <li> <p> <span>Hive principal</span> utilise la valeur de <em>hive.metastore.kerberos.principal</em>. C'est le principal du service du Metastore de Hive.</p> </li> <li> <p> <span>HiveServer2 local user principal</span> utilise la valeur de <em>hive.server2.authentication.kerberos.principal</em>.</p> </li> <li> <p> <span>HiveServer2 local user keytab</span> utilise la valeur de <em>hive.server2.authentication.kerberos.keytab</em> </p> </li> <li> <p> <span>Metastore URL</span> utilise la valeur de <em>javax.jdo.option.ConnectionURL</em>. C'est la chaîne JDBC de connexion au Metastore de Hive.</p> </li> <li> <p> <span>Driver class</span> utilise la valeur de <em>javax.jdo.option.ConnectionDriverName</em>. C'est le nom du pilote de la connexion JDBC.</p> </li> <li> <p> <span>Username</span> utilise la valeur de <em>javax.jdo.option.ConnectionUserName</em>. Ce paramètre, ainsi que le paramètre Password, sont utilisés pour les informations de connexion de l'utilisateur ou de l'utilisatrice au Metastore de Hive.</p> </li> <li> <p> <span>Password</span> utilise la valeur de <em>javax.jdo.option.ConnectionPassword</em>.</p> </li> </ol><br><br><br>Pour les autres paramètres affichés, veuillez consulter les fichiers de configuration Hadoop auxquels ils appartiennent. Par exemple, le Principal du NameNode (Namenode principal) peut être trouvé dans le fichier *hdfs-site.xml* ou le fichier *hdfs-default.xml* de la distribution que vous utilisez.<br><br>Cette case est disponible ou non selon la distribution Hadoop à laquelle vous vous connectez. |
  | Use a keytab to authenticate | Cochez la case Use a keytab to authenticate pour vous connecter à un système utilisant Kerberos à l'aide d'un fichier keytab. Un fichier Keytab contient les paires des Principaux et clés cryptées Kerberos. Vous devez saisir le principal à utiliser dans le champ Principal et le chemin d'accès au fichier keytab dans le champ Keytab. Ce fichier keytab doit être stocké sur la machine où s'exécute votre Job, par exemple, sur un Talend JobServer.<br><br>l'utilisateur ou l'utilisatrice exécutant un Job utilisant un fichier Keytab n'est pas nécessairement celui désigné par un Principal mais doit avoir le droit de lire le fichier Keytab utilisé. Par exemple, le nom d'utilisateur ou d'utilisatrice que vous utilisez pour exécuter le Job est *user1* et le principal à utiliser est *guest*. Dans cette situation, assurez-vous que *user1* a les droits de lecture pour le fichier Keytab à utiliser. |
  | Use SSL encryption | Cochez cette case pour activer la connexion chiffrée SSL ou TLS.<br><br>Les champs qui s'affichent ensuite fournissent les informations d'authentification :<br><br><ul> <li> <p>Dans le champ <span>Trust store path</span>, saisissez le chemin ou parcourez votre système jusqu'au fichier TrustStore à utiliser. Par défaut, les types TrustStore supportés sont <em>JKS</em> et <em>PKCS 12</em>.</p> </li> <li> <p>Pour saisir le mot de passe, cliquez sur le bouton <span>[...]</span> à côté du champ Password, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles et cliquez sur <span>OK</span> afin de sauvegarder les paramètres.</p> </li> </ul><br><br>Cette fonctionnalité n'est disponible que pour HiveServer2 en mode Standalone pour les distributions suivantes :<br><br><ul> <li> <p>Hortonworks Data Platform 2.0 +</p> </li> <li> <p>Cloudera CDH4 +</p> </li> <li> <p>Pivotal HD 2.0 +</p> </li> <li> <p>Amazon EMR 4.0.0 +</p> </li> </ul> |
  | Set Resource Manager | Cochez cette case et, dans le champ qui s'affiche, saisissez l'emplacement du ResourceManager de votre distribution. Par exemple tal-qa114.talend.lan:8050.<br><br>Vous pouvez continuer à configurer les paramètres suivants selon la configuration du cluster Hadoop à utiliser (si vous ne cochez pas la case d'un paramètre, alors la configuration de ce paramètre dans le cluster Hadoop à utiliser sera ignorée lors de l'exécution) :<br><br><ol> <li> <p>Cochez la case <span>Set resourcemanager scheduler address</span> et saisissez l'adresse de l'ordonnanceur (Scheduler) dans le champ qui apparaît.</p> </li> <li> <p>Cochez la case <span>Set jobhistory address</span> et saisissez l'emplacement du serveur JobHistory du cluster Hadoop à utiliser. Cela permet de stocker les informations relatives aux métriques du Job courant sur le serveur JobHistory.</p> </li> <li> <p>Cochez la case <span>Set staging directory</span> et saisissez le chemin d'accès au répertoire défini dans votre cluster Hadoop pour les fichiers temporaires créés par l'exécution de programmes. Ce répertoire se trouve sous la propriété <em>yarn.app.mapreduce.am.staging-dir</em> dans les fichiers de configuration comme <em>yarn-site.xml</em> ou <em>mapred-site.xml</em> de votre distribution.</p> </li> <li> <p>Allouez des volumes de mémoire aux calculs <span>Map</span> et <span>Reduce</span> et au service <span>ApplicationMaster</span> de YARN en cochant la case <span>Set memory</span> dans la vue <span>Advanced settings</span>.</p> </li> <li> <p>Cochez la case <span>Set Hadoop user</span> et saisissez le nom de l'utilisateur ou de l'utilisatrice avec lequel vous souhaitez exécuter le Job. Puisque les fichiers et répertoires dans Hadoop ont un auteur spécifique avec les droits appropriés de lecture ou d'écriture, ce champ vous permet d'exécuter le Job directement avec l'utilisateur ou l'utilisatrice ayant les droits d'accès appropriés au fichier ou répertoire à traiter.</p> </li> <li> <p>Cochez la case <span>Use datanode hostname</span> pour permettre au Job d'accéder aux nœuds de données via leurs hébergeurs. Cela permet de configurer la propriété <em>dfs.client.use.datanode.hostname</em> à <em>true</em>. Lorsque vous vous connectez à un système de fichiers S3N, vous devez cocher cette case.</p> </li> </ol><br><br><br>Pour plus d'informations concernant ces paramètres, consultez la documentation ou contactez l'administrateur du cluster Hadoop à utiliser.<br><br>Pour plus d'informations concernant le framework Hadoop Map/Reduce, consultez le tutoriel Map/Reduce dans [la documentation de Apache Hadoop](http://hadoop.apache.org/) (en anglais). |
  | Set NameNode URI | Cochez cette case et, dans le champ qui s'affiche, saisissez l'URI du NameNode Hadoop, le nœud maître d'un système Hadoop. Par exemple, si vous avez choisi une machine nommée masternode comme NameNode, l'emplacement est hdfs://masternode:portnumber. Si vous utilisez WebHDFS, l'emplacement doit être webhdfs://masternode:portnumber ; WebHDFS avec SSL n'est pas supporté.<br><br>Pour plus d'informations concernant le framework Hadoop Map/Reduce, consultez le tutoriel Map/Reduce dans [la documentation de Apache Hadoop](http://hadoop.apache.org/) (en anglais). |
  | Spark catalog | Sélectionnez l’implémentation Spark à utiliser.<br><br><ul> <li> <span>In-memory</span> : sélectionnez cette valeur pour configurer <span>Hive thrift metastore</span> sur un métastore Hive qui n'est pas externe.</li> <li> <span>Hive</span> : sélectionnez cette valeur pour configurer <span>Hive thrift metastore</span> sur un métastore Hive externe à votre cluster.</li> </ul> |

Les autres propriétés :

| Propriétés | Description |
| --- | --- |
| Property type | Peut être Built-In ou Repository.<br><br>Built-In : aucune propriété n'est stockée de manière centrale.<br><br>Repository : Sélectionnez le fichier dans lequel sont stockées les propriétés du composant. |
| Use an existing connection | Cochez cette case et sélectionnez le composant de connexion adéquat dans la liste Component list pour réutiliser les paramètres d'une connexion que vous avez déjà définie.<br><br>Note InformationsRemarque : Lorsqu'un Job contient un Job parent et un Job enfant, si vous devez partager une connexion existante entre ces deux niveaux, par exemple pour partager la connexion créée par le Job parent au Job enfant, procédez comme suit.<br><br><ol> <li>au niveau du Job parent, enregistrer la connexion à la base de données à partager dans la vue <span>Basic settings</span> du composant de connexion créant cette connexion à la base de données. </li> <li>au niveau du Job enfant, utiliser un composant de connexion dédié afin de lire cette connexion enregistrée. </li> </ol><br><br>Pour un exemple de partage d'une connexion à une base de données à travers différents niveaux de Jobs, consultez [Partager une connexion à une base de données](https://help.qlik.com/talend/r/fr-FR/7.3/studio-user-guide/sharing-database-connection). |
| Distribution | Sélectionnez dans la liste le cluster que vous utilisez. Les options de la liste varient selon le composant que vous utilisez. Parmi ces options, les suivantes nécessitent une configuration spécifique :<br><br><ul> <li> <p>Si disponible dans la liste de <span>Distribution</span>, l'option <span>Microsoft HDInsight</span> vous permet d'utiliser un cluster Microsoft HDInsight. Dans cette optique, vous devez configurer les connexions au cluster HDInsight et au service Windows Azure Storage du cluster dans les zones affichées. Pour des explications détaillées au sujet de ces paramètres, consultez <a href="https://help.qlik.com/talend/r/fr-FR/7.3/studio-user-guide/configuring-connection-manually" target="_blank">Configurer manuellement la connexion</a>. </p> </li> <li> <p>Si vous avez sélectionné <span>Amazon EMR</span>, obtenez davantage d'informations dans <a href="https://help.qlik.com/talend/r/en-US/8.0/amazon-emr-getting-started" target="_blank">Amazon EMR - Getting Started</a> (en anglais).</p> </li> <li> <p>L'option <span>Custom</span> vous permet de vous connecter à un cluster différente des clusters de la liste, par exemple une distribution non supportée officiellement par <span> <span>Talend</span> </span>.</p> </li> </ul><br><br><ol> <li> <p>Sélectionner <span>Import from existing version</span> pour importer une distribution de base officiellement supportée et ajouter manuellement les autres Jars requis non fournis par cette distribution.</p> </li> <li> <p>Sélectionner <span>Import from zip</span> pour importer le fichier .zip de configuration pour la distribution personnalisée à utiliser. Ce fichier .zip doit contenir les bibliothèques des différents éléments Hadoop et le fichier d'index de ces bibliothèques. </p> <p>Notez que les versions personnalisées ne sont pas officiellement supportées par <span><span>Talend</span></span>. <span><span>Talend</span></span>  et sa Communauté fournissent l'opportunité de vous connecter à des versions personnalisées depuis le <span>Studio Talend</span> mais ne peuvent garantir que la configuration de la version choisie sera simple, car de nombreuses versions et distributions d'Hadoop différentes sont disponibles. Il est recommandé de configurer cette connexion uniquement si vos connaissances relatives à Hadoop sont suffisantes pour gérer d'éventuels problèmes par vous-même.</p> <div><span>Note Informations</span><span>Remarque :</span> <p>Dans cette boîte de dialogue, la case de la zone active doit être cochée, afin d'importer les fichiers .jar correspondant à la connexion créée entre la distribution personnalisée et ce composant.</p> </div> <p>Pour un exemple étape par étape expliquant comment se connecter à une distribution personnalisée et partager cette connexion, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/hortonworks" target="_blank">Hortonworks</a>.</p> </li> </ol><br><br>Note InformationsRemarque : À partir de la version 8.0 R2024-04 du Studio Talend, le paramètre Distribution est supprimé. |
| Version de Hive | Sélectionnez la version HBase de la distribution Hadoop que vous utilisez.<br><br>Note InformationsRemarque : À partir de la version 8.0 R2024-04 du Studio Talend, le paramètre Hive version (Version de Hive) est supprimé. |
| Hiver Server | Sélectionnez la version de Hive que vous utilisez. |
| Hadoop version | Sélectionnez la version de Hadoop que vous utilisez. |
| Execution engine | Cochez cette case et, dans la liste déroulante, sélectionnez le framework à utiliser pour le traitement Big Data. Les frameworks disponibles sont MapReduce et Tez.<br><br>Cette propriété est disponible avec les modes de connexion suivants :<br><br><ul> <li>Dataproc</li> <li>HDInsight</li> <li>Standalone</li> </ul><br><br>Avant d'utiliser Tez ou MapReduce, assurez-vous que le cluster Hadoop que vous utilisez supporte Tez, en consultant le paramètre hive.execution.engine dans le fichier hive-site.xml. Vous devez configurer l'accès aux bibliothèques Tez correspondantes via la vue Advanced settings de ce composant.<br><br>Pour plus d'informations concernant Hive sur Tez, consultez la [documentation Apache correspondante](https://cwiki.apache.org/confluence/display/Hive/Hive+on+Tez). Des exemples vous sont présentés afin d'expliquer comment Tez peut être utilisé pour optimiser les performances par rapport à MapReduce. |
| Schema et Edit Schema | Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.<br><br>Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :<br><br><ul> <li> <p> <span>View schema</span>&nbsp;: sélectionnez cette option afin de voir uniquement le schéma.</p> </li> <li> <p> <span>Change to built-in property</span>&nbsp;: sélectionnez cette option pour passer le schéma en mode <span>Built-In</span> et effectuer des modifications locales.</p> </li> <li> <p> <span>Update repository connection</span>&nbsp;: sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs.</p> <p>Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur <span>No</span> et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre <span>Repository Content</span>.</p> </li> </ul><br><br>Built-in : le schéma est créé et stocké localement pour ce composant seulement. Scénario associé : [Paramétrer un schéma built-in dans un Job](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/setting-built-in-schema-in-job).<br><br>Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé. Scénario associé : [Paramétrer un schéma du Repository dans un Job](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/setting-repository-schema-in-job). |
| Table name | Nom de la table à traiter. |
| Query type | Peut être Built-in ou Repository .<br><br><ul> <li> <span>Built-In</span> : renseignez manuellement l'instruction de requête ou créez-la graphiquement en utilisant SQLBuilder.</li> <li> <span>Repository</span>&nbsp;: sélectionnez la requête de votre choix, stockée dans le référentiel. Le champ Query est renseigné automatiquement.</li> </ul> |
| Guess Query | Cliquez sur le bouton Guess Query pour générer une requête correspondant à votre schéma de table dans le champ Query. |
| This query uses Parquet objects | Lorsqu'elle est disponible, cochez cette case pour indiquer que la table à gérer utilise le format Parquet et permet au composant d'appeler le fichier JAR requis.<br><br>Notez que, lorsque le format de fichier à utiliser est PARQUET, il est possible qu'il vous soit demandé de trouver le fichier JAR Parquet spécifique et de l'installer dans le Studio Talend.<br><br><ul> <li> <p>Lorsque le mode de connexion à Hive est <span>Embedded</span>, le Job est exécuté sur votre machine locale et appelle ce JAR installé dans le <span>Studio Talend</span>.</p> </li> <li> <p>Lorsque le mode de connexion à Hive est <span>Standalone</span>, le Job est exécuté sur le serveur hébergeant Hive et ce fichier JAR est envoyé au système HDFS du cluster auquel vous vous connectez. Assurez-vous d'avoir correctement défini l'URI du NameNode dans le champ correspondant de la vue <span>Basic settings</span>.</p> </li> </ul><br><br><br>Ce fichier JAR est téléchargeable depuis le site Web d'Apache. Pour plus d'informations concernant l'installation de modules externes, consultez [Installer des modules externes](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/installing-external-modules). |
| Query | Saisissez votre requête de base de données en faisant particulièrement attention à l'ordre des champs afin qu'ils correspondent à la définition du schéma.<br><br>Pour plus d'informations, consultez [Hive query language manual](https://cwiki.apache.org/confluence/display/Hive/LanguageManual) (en anglais).<br><br>Note InformationsRemarque : Les données compressées en Gzip ou Bzip2 peuvent être traitées via les instructions de requête. Pour plus d'informations, consultez [Compressed Data Storage](https://cwiki.apache.org/confluence/display/Hive/CompressedStorage) (en anglais).<br><br>Hadoop fournit différents formats de compression permettant de réduire l'espace nécessaire au stockage des fichiers et d'accélérer le transfert de données. Lorsque vous lisez un fichier compressé, le Studio Talend doit l'extraire avant de pouvoir en alimenter le flux d'entrée. |
| Die on error | Cette case est cochée par défaut. Décochez-la pour ignorer les lignes en erreur et terminer le processus avec les lignes sans erreur. Si nécessaire, vous pouvez récupérer les lignes en erreur en utilisant un lien de type Row &gt; Rejects. |
| Store by HBase | Cochez cette case afin d'afficher les paramètres à configurer pour permettre aux composants Hive d'accéder aux tables HBase :<br><br><ul> <li> <p>Une fois l'accès configuré, vous pourrez utiliser, dans un <span>tHiveRow</span> et un <span>tHiveInput</span>, les instructions Hive QL permettant de lire et d'écrire des données dans HBase.</p> </li> <li> <p>Si vous utilisez l'authentification Kerberos, vous devez définir les principaux relatifs à HBase dans les champs correspondants qui sont affichés.</p> </li> </ul><br><br>Pour plus d'informations à propos de cet accès concernant Hive et HBase, consultez la documentation de Apache Hive concernant l'intégration Hive/HBase. |
| ZooKeeper quorum | Saisissez le nom ou l'URL du service ZooKeeper utilisé pour coordonner les transactions entre votre Studio Talend et votre base de données. Notez que, lorsque vous configurez ZooKeeper, vous pouvez avoir besoin de configurer explicitement la propriété *zookeeper.znode.parent* pour définir le chemin vers le nœud Znode racine contenant tous les Znodes créés et utilisés par votre base de données. Cochez la case la case Set ZooKeeper znode parent afin de définir cette propriété. |
| ZooKeeper client port | Saisissez le numéro du port d'écoute client du service ZooKeeper que vous utilisez. |
| Define the jars to register for HBase | Cochez cette case pour afficher la table Register jar for HBase, dans laquelle vous pouvez enregistrer tout fichier Jar manquant, requis pour HBase, par exemple, Hive Storage Handler, enregistré par défaut avec votre installation Hive. |
| Register jar for HBase | Cliquez sur le bouton [+] pour ajouter des lignes à la table, puis, dans la colonne Jar name, sélectionnez le fichier JAR à enregistrer. Dans la colonne Jar path, saisissez le chemin d'accès à ce JAR. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| Tez lib | Choisissez comment accéder aux bibliothèques de Tez :<br><br><ul> <li> <p> <span>Auto install</span>&nbsp;: lors de l'exécution, le Job charge et déploie les bibliothèques de Tez fournies par le <span>Studio Talend</span> dans le répertoire spécifié dans le champ <span>Install folder in HDFS</span>, par exemple, <em>/tmp/usr/tez</em>.</p> <p>Si vous avez configuré la propriété <em>tez.lib.uris</em> dans la table des propriétés, ce répertoire écrase la valeur de la propriété lors de l'exécution. Les autres propriétés configurées dans la table sont toujours prises en compte.</p> </li> <li> <p> <span>Use exist</span>&nbsp;: le Job accède aux bibliothèques de Tez déjà déployées dans le cluster Hadoop à utiliser. Vous devez saisir le chemin d'accès pointant vers ces bibliothèques dans le champ <span>Lib path (folder or file)</span>.</p> </li> <li> <p> <span>Lib jar</span>&nbsp;: cette table s'affiche lorsque vous avez sélectionné <span>Auto install</span> dans la liste <span>Tez lib</span> et que vous utilisez une distribution personnalisée (<span>Custom</span>). Dans cette table, vous devez ajouter les bibliothèques de Tez à charger.</p> </li> </ul> |
| Temporary path | Si vous ne souhaitez pas configurer le Jobtracker et le NameNode lorsque vous exécutez la requête select \* from your\_table\_name, vous devez paramétrer un chemin d'accès temporaire. Par exemple, */C:/select\_all* sous Windows. |
| Propagate QUERY's recordset | Saisissez votre requête en faisant particulièrement attention à l'ordre des champs afin qu'ils correspondent à la définition du schéma. Sélectionnez cette colonne dans la liste use column.<br><br>Note InformationsRemarque :<br><br>Cette option permet au composant d'avoir un schéma différent de celui du composant précédent. De plus, la colonne contenant le résultat de la requête doit être de type *Object*. Ce composant est généralement suivi par un composant tParseRecordSet. |
| Hadoop Properties | Le *Studio Talend* utilise une configuration par défaut pour son moteur, afin d'effectuer des opérations dans une distribution Hadoop. Si vous devez utiliser une configuration personnalisée dans une situation spécifique, renseignez dans cette table la ou les propriété(s) à personnaliser. Lors de l'exécution, la ou les propriété(s) personnalisée(s) va (vont) écraser celle(s) par défaut.<br><br><ul> <li> <p>Notez que, si vous utilisez les métadonnées stockées centralement dans le <span>Repository</span>, cette table hérite automatiquement des propriétés définies dans ces métadonnées et passe en lecture seule jusqu'à ce que, dans la liste <span>Property type</span>, vous passiez de <span>Repository</span> à <span>Built-in</span>.</p> </li> </ul><br><br>Pour plus d'informations concernant les propriétés requises par Hadoop et ses systèmes associés, tels que HDFS et Hive, consultez la documentation de la distribution Hadoop utilisée ou consultez la [documentation Apache Hadoop](http://hadoop.apache.org/docs) (en anglais) en sélectionnant la version de la documentation souhaitée. À titre d'exemple, les liens vers certaines propriétés sont listés ci-après :<br><br><ul> <li> <p>Généralement, les propriétés relatives à HDFS peuvent être trouvées dans le fichier <em>hdfs-default.xml</em> de votre distribution, par exemple dans <a href="http://hadoop.apache.org/docs/r2.6.0/hadoop-project-dist/hadoop-hdfs/hdfs-default.xml" target="_blank"> http://hadoop.apache.org/docs/r2.6.0/hadoop-project-dist/hadoop-hdfs/hdfs-default.xml</a>.</p> </li> <li> <p>Apache fournit également une page listant les <a href="https://cwiki.apache.org/confluence/display/Hive/Configuration+Properties" target="_blank">propriétés relatives à Hive</a> (en anglais).</p> </li> </ul> |
| Hive properties | Le *Studio Talend* utilise une configuration par défaut pour que son moteur effectue des opérations sur une base de données Hive. Si vous devez utiliser une configuration personnalisée dans une situation spécifique, renseignez dans cette table la ou les propriété(s) à personnaliser. Lors de l'exécution, la ou les propriété(s) personnalisée(s) va (vont) écraser celle(s) par défaut. Pour plus d'informations, consultez [Hive dedicated properties](https://cwiki.apache.org/confluence/display/Hive/AdminManual+Configuration) (en anglais).<br><br><ul> <li>Si vous devez utiliser Tez pour exécuter votre Job Hive, ajoutez <span>hive.execution.engine</span> à la colonne <span>Properties</span> et <span>Tez</span> à la valeur <span>Value</span>, en entourant ces chaînes de caractères de guillemets doubles.</li> <li> <p>Notez que, si vous utilisez les métadonnées stockées centralement dans le <span>Repository</span>, cette table hérite automatiquement des propriétés définies dans ces métadonnées et passe en lecture seule jusqu'à ce que, dans la liste <span>Property type</span>, vous passiez de <span>Repository</span> à <span>Built-in</span>.</p> </li> </ul> |
| Mapred job map memory mb et Mapred job reduce memory mb | Vous pouvez personnaliser les opérations map et reduce en cochant la case Set memory, pour configurer les allocations de mémoire pour ces opérations à effectuer par le système Hadoop.<br><br>Dans ce cas, vous devez saisir les valeurs que vous souhaitez utiliser pour la mémoire allouée aux opérations map et reduce dans les champs Mapred job map memory mb et Mapred job reduce memory mb, respectivement. Par défaut, les valeurs sont toutes les deux *1000*, ce qui est normalement adapté pour l'exécution de ces opérations. |
| Path separator in server | Laissez le champ Path separator in server tel quel, sauf si vous changez le séparateur utilisé par la machine hôte de votre distribution Hadoop pour sa variable PATH. En d'autres termes, changez le séparateur si celui-ci n'est pas le signe deux points (:). Dans ce cas, vous devez remplacer cette valeur par celle utilisée dans votre hôte. |
| tStatCatcher Statistics | Cochez cette case pour collecter les données de log au niveau des composants. |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | QUERY : requête en cours de traitement. Cette variable est une variable Flow et retourne une chaîne de caractères.<br><br>ERROR\_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.<br><br>Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.<br><br>Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.<br><br>Pour plus d'informations concernant les variables, consultez [Utiliser les contextes et les variables](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/contexts-and-variables). |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Ce composant offre la flexibilité des requêtes sur les bases de données et couvre toutes les possibilités de requêtes Hive QL.<br><br>Le tHiveRow peut capturer les valeurs Application\_ID et les écrire dans les logs du Job une fois que vous avez activé Log4j et configuré son niveau de sortie à Info pour votre Job utilisant le tHiveRow.<br><br><ul> <li> <p>Pour plus d'informations concernant la définition du niveau de sortie Log4j au niveau d'un Job individuel, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/customizing-log4j-output-level-at-runtime" target="_blank">Personnaliser le niveau de sortie de Log4j à l'exécution</a>.</p> </li> <li> <p>Pour plus d'informations concernant la configuration de Log4j au niveau du <span>Studio Talend</span> pour appliquer la configuration à tous les Jobs, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/studio-configure-log4j" target="_blank">Activer et configurer Log4j</a>.</p> </li> </ul><br><br>Si le Studio Talend utilisé pour vous connecter à une base de données Hive fonctionne sous Windows, vous devez créer manuellement un dossier appelé *tmp* à la racine du disque où le Studio Talend est installé. |
| Paramètres dynamiques | Cliquez sur le bouton [+] pour ajouter une ligne à la table. Dans le champ Code, saisissez une variable de contexte afin de sélectionner dynamiquement votre connexion à la base de données parmi celles prévues dans votre Job. Cette fonctionnalité est utile si vous devez accéder à plusieurs tables de bases de données ayant la même structure mais se trouvant dans différentes bases de données, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramètres de votre Job, par exemple lorsque votre Job doit être déployé et exécuté indépendamment d'un Studio Talend.<br><br>La table Dynamic settings est disponible uniquement lorsque la case Use an existing connection est cochée dans la vue Basic settings. Lorsqu'un paramètre dynamique est configuré, la liste Component List de la vue Basic settings devient inutilisable.<br><br>Pour des exemples d'utilisation de paramètres dynamiques, consultez [Lire des données dans des bases de données MySQL à l'aide de connexions dynamiques basées sur les variables de contexte](https://help.qlik.com/talend/r/fr-FR/8.0/components/defining-context-groups/reading-data-from-databases-through-context-based-dynamic-connections) et [Lire des données à partir de différentes bases de données MySQL à l'aide de paramètres de connexion chargés dynamiquement](https://help.qlik.com/talend/r/fr-FR/8.0/components/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters). Pour plus d'informations concernant les Paramètres dynamiques et les variables de contexte, consultez [Schéma dynamique](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/dynamic-schema) et [Créer un groupe de contextes et définir les variables de contexte](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/creating-context-group-and-define-context-variables-in-it). |
| Prérequis | La distribution Hadoop doit être correctement installée afin de garantir les interactions avec le *Studio Talend* . La liste suivante présente des informations d'exemple relatives à MapR.<br><br><ul> <li> <p>Assurez-vous d'avoir installé le client MapR sur la même machine que le <span>Studio Talend</span> et d'avoir ajouté la bibliothèque client de MapR dans la variable PATH de cette machine. D'après la documentation de MapR, la ou les bibliothèques du client MapR correspondant à chaque OS peuvent être trouvées dans <em>MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native</em>. Par exemple, pour Windows, la bibliothèque est <em>lib\MapRClient.dll</em> dans le fichier Jar du client MapR.</p> <p>Si vous n'ajoutez pas de librairie, il est possible que vous rencontriez l'erreur suivante&nbsp;: <span>no MapRClient in java.library.path</span>.</p> </li> <li> <p>Configurez l'argument <span>-Djava.library.path</span>, par exemple, dans la zone <span>Job Run VM arguments</span> de la vue <span>Run/Debug</span> de la boîte de dialogue <span>Preferences</span> dans le menu <span>Window</span>. Cet argument fournit au <span>Studio Talend</span> le chemin d'accès à la bibliothèque native du client MapR. Cela permet aux utilisateurs et utilisatrices en souscription d'utiliser entièrement l'aperçu des données (<span>Data viewer</span>) afin de visualiser localement dans le <span>Studio Talend</span> les données stockées dans MapR.</p> </li> </ul><br><br>Pour plus d'informations concernant l'installation d'une distribution Hadoop, consultez le manuel correspondant à la distribution Hadoop que vous utilisez. |