Propriétés du tMongoDBInput Standard - 6.5

MongoDB

author
Talend Documentation Team
EnrichVersion
6.5
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Open Studio for Big Data
Talend Real-Time Big Data Platform
task
Création et développement > Systèmes tiers > Composants Database > Composants MongoDB
Gouvernance de données > Systèmes tiers > Composants Database > Composants MongoDB
Qualité et préparation de données > Systèmes tiers > Composants Database > Composants MongoDB
EnrichPlatform
Studio Talend

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

Le composant tMongoDBInput Standard appartient aux familles Big Data et Databases.

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

Basic settings

Use 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.

DB Version

Sélectionnez dans la liste la version de la base de données que vous utilisez.

Cette option est disponible lorsque la case Use existing connection est décochée.

Use replica set address

Cochez cette case pour afficher la table Replica adddress.

Dans la table Replica address, vous pouvez configurer différents serveurs de la base de données MongoDB pour le failover.

Cette option est disponible lorsque la case Use existing connection n'est pas cochée.

Server et Port

Adresse IP et port d'écoute du serveur de la base de données.

Ces champs sont disponibles lorsque les cases Use existing connection et Use replica set address ne sont pas cochées.

Database

Nom de la base de données.

Use SSL connection

Cochez cette case pour activer la connexion chiffrée SSL ou TLS.

Utilisez le composant tSetKeystore dans le même Job afin de spécifier les informations de chiffrement.

Pour plus d'informations concernant le tSetKeystore, consultez tSetKeystore.

Notez que la connexion SSL est disponible uniquement à partir de la version 2.4 de MongoDB.

Set read preference

Cochez cette case et, dans la liste Read preference qui s'affiche, sélectionnez le membre auquel vous souhaitez adresser les opérations de lecture.

Si vous laissez décochée cette case, le Job utilise les préférences de lecture par défaut. Autrement dit, il utilise le membre primaire d'un Replica set.

Pour plus d'informations, consultez la documentation de MongoDB relative à la réplication et à ses préférences de lecture (Read preferences).

Required authentication

Cochez cette case pour activer l'authentification à la base de données.

Parmi les mécanismes listés dans la liste déroulante Authentication mechanism, le mécanisme NEGOTIATE est recommandé si vous n'utilisez pas Kerberos, car il sélectionne automatiquement le mécanisme d'authentification le plus adapté à la version de MongoDB que vous utilisez.

Pour plus d'informations sur les autres mécanismes de la liste, consultez MongoDB Authentication (en anglais) dans la documentation MongoDB.

Set Authentication database

Si le nom d'utilisateur à utiliser pour se connecter à MongoDB a été créé dans une base de données d'authentification MongoDB spécifique, cochez cette case pour saisir le nom de la base de données en question dans le champ Authentication database qui s'affiche.

Pour plus d'informations sur la base de données d'authentification MongoDB, consultez User Authentication database (en anglais).

Username et Password

Informations d'authentification de l'utilisateur à la base de données.

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.

Ces champs sont disponibles lorsque la case Required authentication est cochée.

Si le système de sécurité sélectionné dans la liste Authentication mechanism est Kerberos, saisissez les informations dans les champs suivants User principal, Realm et KDC server et non dans les champs Username et Password.

Collection

Nom de la collection dans la base de données MongoDB.

Schema et Edit Schema

Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) dans le Repository. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.

Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :

  • View schema : sélectionnez cette option afin de voir le schéma.

  • Change to built-in property : sélectionnez cette option pour passer le schéma en mode Built-In et effectuer des modifications locales.

  • Update repository connection : 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. Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur No et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre [Repository Content].

Si une colonne dans une base de données est un document JSON et que vous devez lire le document entier, saisissez un astérisque "*" dans la colonne DB column, sans guillemet.

Query

Spécifiez la condition de la requête. Ce champ est disponible uniquement lorsque vous avez sélectionné Find query dans la liste Query type.

Par exemple, saisissez "{id:4}" afin de récupérer l'enregistrement dont l'id est 4, dans la collection spécifiée dans le champ Collection.
Remarque :

À la différence des instructions de requête requises dans le logiciel client MongoDB, la requête fait ici référence au contenu dans find(). Ainsi la requête est {id:4} alors qu'elle devrait être db.blog.find({id:4}) dans le client MongoDB.

Aggregation stages

Créez un pipeline d'agrégation en ajoutant les étapes à travers lesquelles vous souhaitez que les documents passent, pour obtenir des résultats agrégés à partir de ces documents. Cette table est disponible uniquement lorsque vous avez sélectionné Aggregation pipeline query dans la liste Query type.

Une seule étape est autorisée par ligne, dans la table Aggregation stages. Toutes les étapes sont exécutées une par une, dans l'ordre dans lequel vous les avez placées dans la table.

Par exemple, si vous souhaitez agréger les documents relatifs à vos clients, à l'aide des étapes $match et $group, vous devez ajouter deux lignes à la table Aggregation stages et définir deux étapes, comme suit :
"{$match : {status : 'A'}}"
"{$group : {_id : '$cust_id', total : {$sum : '$amount'}}}"

Dans cette agrégation, les documents clients ayant un statut A sont sélectionnés. Parmi les clients sélectionnés, ceux utilisant le même ID client sont groupés et la somme des valeurs des champs amount du même client est effectuée.

Pour une liste complète des étapes que vous pouvez utiliser et les opérateurs associés, consultez Aggregation pipeline operators (en anglais).

Pour plus d'informations concernant le pipeline d'agrégation MongoDB, consultez Aggregation pipeline (en anglais).

Mapping

Chaque colonne du schéma défini pour ce composant représente un champ des documents à lire. Dans cette table, vous devez spécifier les nœuds parents de ces champs, s'il y en a.

Par exemple, dans le document se présentant comme suit :
{
               _id: ObjectId("5099803df3f4948bd2f98391"),
               person: { first: "Joe", last: "Walker" }
            }
Les champs first et last ont un nœud père person mais le champ _id ne contient aucun nœud père. Cela fait, la table Mapping doit ressembler à ceci :
Column     Parent node path
_id
first       "person"
last        "person"

Sort by

Spécifiez la colonne et choisissez l'ordre pour l'opération de tri.

Ce champ est disponible uniquement lorsque vous avez sélectionné Find query dans la liste Query type.

Limit

Saisissez le nombre maximal de documents à récupérer.

Ce champ est disponible uniquement lorsque vous avez sélectionné Find query dans la liste Query type.

Advanced settings

tStatCatcher Statistics

Cochez cette case pour collecter les données de log au niveau du composant.

No query timeout

Cochez cette case pour empêcher les serveurs MongoDB de fermer les curseurs inactifs après 10 minutes d'inactivité de ces curseurs. Dans cette situation, un curseur inactif reste ouvert jusqu'à ce que les résultats de ce curseur soient épuisés ou que vous fermiez manuellement le curseur à l'aide de la méthode cursor.close().

Un curseur, dans MongoDB, est un pointeur vers l'ensemble de résultats de la requête. Par défaut, c'est-à-dire lorsque la case est décochée, un serveur MongoDB ferme automatiquement les curseurs inactifs après une période d'inactivité donnée, pour éviter les utilisations excessives de mémoire. Pour plus d'informations concernant les curseurs MongoDB, consultez https://docs.mongodb.org/manual/core/cursors/ (en anglais).

Enable external sort

Puisque les étapes des pipelines d'agrégation ont une limite d'utilisation de mémoire maximum (100 mégaoctets) et qu'une étape dépassant cette limite produit des erreurs, lors du traitement de jeux de données volumineux, cochez cette case pour éviter que les étapes d'agrégation dépassent cette limite.

Pour plus d'informations concernant ce tri externe, consultez Large sort operation with external sort (en anglais).

Global Variables

Global Variables

NB_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier.

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.

Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.

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.

Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend .

Utilisation

Règle d'utilisation

Le composant tMongoDBInput est un composant de début et vous permet de récupérer des documents d'une collection, dans la base de données MongoDB et de les transférer au composant suivant, pour affichage ou stockage.