# tFileStreamInputPositional

Ce composant écoute, dans un répertoire donné, les nouveaux fichiers, lit les données de ces fichiers ligne par ligne, une fois les fichiers créés puis extrait des champs selon un modèle spécifique.

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

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

Le composant tFileStreamInputPositional Spark Streaming appartient à la famille Fichier.

La version Streaming de ce composant est disponible dans Talend Real-Time Big Data Platform et dans Talend Data Fabric.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Define a storage configuration component | Sélectionnez le composant de configuration à utiliser pour fournir les informations de configuration pour la connexion au système de fichiers cible, comme HDFS.<br><br>Si vous laissez cette case décochée, le système de fichiers cible est le système local.<br><br>Le composant de configuration à utiliser doit se trouver dans le même Job. Par exemple, si vous avez ajouté un composant tHDFSConfiguration dans votre Job, vous pouvez le sélectionner pour écrire le résultat dans un système HDFS donné. |
| Property type | <ul> <li> <p>Peut être <span>Built-In</span> ou <span>Repository</span>. </p> </li> <li> <p> <span>Built-In</span>&nbsp;: aucune propriété n'est stockée de manière centrale.</p> </li> <li> <p> <span>Repository&nbsp;</span>: Sélectionnez le fichier dans lequel sont stockées les propriétés du composant.</p> <p>Les propriétés sont stockées centralement sous le nœud <span>Hadoop Cluster</span> de la vue <span>Repository</span>.</p> <p>Les champs suivants sont alors préremplis à l'aide des données collectées.</p> <p>Pour plus d'informations concernant le nœud <span>Hadoop Cluster</span>, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/managing-hadoop-metadata" target="_blank">Gérer les métadonnées Hadoop</a>.</p> </li> </ul> |
| Schema et Edit Schema | <ul> <li> <p>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é <kbd>line</kbd> lors du nommage des champs.</p> <p>Créez le schéma en cliquant sur le bouton <span>Edit Schema</span>. Si vous effectuez des modifications, le schéma passe automatiquement en type built-in. </p> </li> <li> <p> <span>Built-in</span>&nbsp;: le schéma est créé et conservé localement pour ce composant seulement.</p> </li> <li> <p> <span>Repository</span>&nbsp;: le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.</p> </li> </ul> |
| Folder/File | Parcourez votre système ou saisissez le chemin d'accès aux données à utiliser dans le système de fichiers.<br><br>Si le chemin d'accès défini pointe vers un dossier, ce composant lit tous les fichiers stockés dans le dossier, par exemple /user/talend/in. Si les sous-dossiers existent, ils sont automatiquement ignorés, sauf si vous définissez la propriété spark.hadoop.mapreduce.input.fileinputformat.input.dir.recursive à true dans la table Advanced properties, dans l'onglet Spark configuration.<br><br><ul> <li>Selon le système de fichiers à utiliser, configurez le composant de configuration placé dans votre Job, par exemple un <span>tHDFSConfiguration</span> pour HDFS, un <span>tS3Configuration</span> pour S3 et un <span>tAzureFSConfiguration</span> pour Azure Storage et Azure Data Lake Storage.</li> </ul><br><br>Si vous souhaitez spécifier plus d'un fichier ou répertoire dans ce champ, séparez chaque chemin d'accès par une virgule (,).<br><br>Si le fichier à lire est un fichier compressé, saisissez son nom et son extension, puis tFileInputPositional décompresse automatiquement le fichier lors de l'exécution. Les formats de compression, ainsi que les extensions correspondantes, sont :<br><br><ul> <li> <p>DEFLATE&nbsp;: <em>*.deflate</em> </p> </li> <li> <p>gzip&nbsp;: <em>*.gz</em> </p> </li> <li> <p>bzip2&nbsp;: <em>*.bz2</em> </p> </li> <li> <p>LZO&nbsp;: <em>*.lzo</em> </p> </li> </ul><br><br>Le bouton pour parcourir votre système ne fonctionne pas en mode Local de Spark. Si vous utilisez les autres modes Yarn de Spark supportés par le Studio Talend avec votre distribution, assurez-vous d'avoir correctement configuré la connexion dans un composant de connexion dans le même Job. Utilisez le composant de configuration relatif au système de fichiers à utiliser. |
| Die on error | Cochez cette case pour arrêter l'exécution du Job lorsqu'une erreur survient. |
| Row separator | Saisissez le séparateur utilisé pour identifier la fin d'une ligne. |
| Customize | Cochez cette case pour personnaliser le format de données du fichier positionnel et définir les colonnes de la table :<br><br>Column : sélectionnez la colonne que vous souhaitez personnaliser.<br><br>Size : saisissez la taille de la colonne.<br><br>Padding char : saisissez, entre guillemets doubles, le caractère de remplissage à supprimer du champ. Le caractère par défaut est un espace.<br><br>Alignment : sélectionnez le paramètre d'alignement approprié. |
| Pattern | Saisissez, entre guillemets doubles, les valeurs de longueur, séparées par une virgule, interprétées comme des chaînes de caractères. Assurez-vous que les valeurs saisies dans ce champ sont cohérentes avec le schéma défini. |
| Header | Saisissez le nombre de lignes à ignorer au début du fichier.<br><br>Par exemple, saisissez *0* pour ne pas ignorer de ligne dans les données sans en-tête et *1* pour les données dont l'en-tête se trouve dans la première ligne. |
| Skip empty rows | Cochez cette case pour ignorer les lignes vides. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| Custom Encoding | Il est possible de rencontrer des problèmes d'encodage lorsque vous traitez les données stockées. Dans ce cas, cochez cette case pour afficher la liste Encoding.<br><br>Sélectionnez l'encodage à partir de la liste ou sélectionnez Custom et définissez-le manuellement. |
| Advanced separator (for number) | Cochez cette case pour modifier le séparateur utilisé pour les nombres. Par défaut, le séparateur des milliers est une virgule (*,*) et le séparateur décimal est un point (*.*). |
| Trim columns | Cochez cette case pour supprimer les espaces en début et fin de toutes les colonnes. Lorsque cette case est cochée, la table Check column to trim est affichée, ce qui vous permet de sélectionner les colonnes desquelles vous souhaitez enlever les espaces en début et en fin de champ. |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Ce composant est utilisé en tant que composant de début et nécessite un lien de sortie.<br><br>Ce composant, ainsi que les composants Spark Streaming de la Palette à laquelle il appartient, s'affichent uniquement lorsque vous créez un Job Spark Streaming.<br><br>Notez que, dans cette documentation, sauf mention contraire, un scénario présente uniquement des Jobs Standard, c'est-à-dire des Jobs Talend traditionnels d'intégration de données. |
| Connexion à Spark | Dans l'onglet Spark Configuration de la vue Run, définissez la connexion à un cluster Spark donné pour le Job complet. De plus, puisque le Job attend ses fichiers .jar dépendants pour l'exécution, vous devez spécifier le répertoire du système de fichiers dans lequel ces fichiers .jar sont transférés afin que Spark puisse accéder à ces fichiers :<br><br><ul> <li> <div> <span>Yarn mode</span> (Yarn Client ou Yarn Cluster) :<ul> <li> <p>Lorsque vous utilisez Google Dataproc, spécifiez un bucket dans le champ <span>Google Storage staging bucket</span> de l'onglet <span>Spark configuration</span>.</p> </li> <li> <p>Lorsque vous utilisez HDInsight, spécifiez le blob à utiliser pour le déploiement du Job, dans la zone <span>Windows Azure Storage configuration</span> de l'onglet <span>Spark configuration</span>.</p> </li> <li>Lorsque vous utilisez Altus, spécifiez le bucket S3 ou le stockage Azure Data Lake Storage (aperçu technique) pour le déploiement du Job, dans l'onglet <span>Spark configuration</span>.</li> <li> <p>Lorsque vous utilisez des distributions sur site (on-premises), utilisez le composant de configuration correspondant au système de fichiers utilisé par votre cluster. Généralement, ce système est HDFS et vous devez utiliser le <a href="https://help.qlik.com/talend/r/fr-FR/8.0/components/hdfs/thdfsconfiguration">tHDFSConfiguration</a>.</p> </li> </ul> </div> </li> <li> <p> <span>Standalone mode</span>&nbsp;: utilisez le composant de configuration correspondant au système de fichiers que votre cluster utilise, comme le <a href="https://help.qlik.com/talend/r/fr-FR/8.0/components/hdfs/thdfsconfiguration-properties-for-apache-spark-batch">tHDFSConfiguration Apache Spark Batch</a> ou le <a href="https://help.qlik.com/talend/r/fr-FR/7.3/components/amazon-s3/ts3configuration-properties-for-apache-spark-batch">tS3Configuration Apache Spark Batch</a>.</p> <p>Si vous utilisez Databricks sans composant de configuration dans votre Job, vos données métier sont écrites directement dans DBFS (Databricks Filesystem).</p> </li> </ul><br><br>Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez définie. |