tMaxDBRow

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 tMaxDBRow est le composant spécifique à ce type de base de données. Il exécute des requêtes SQL 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 vous aide à rapidement et aisément écrire vos requêtes.

Propriétés du tMaxDBRow Standard

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

Le composant tMaxDBRow Standard appartient à la famille Bases de données.

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

Basic settings

Propriétés	Description
Property type	Peut-être Built-In ou Repository. Built-In : propriétés utilisées ponctuellement. Repository : sélectionnez le référentiel dans lequel sont stockées les propriétés. Les champs suivants sont automatiquement renseignés à l'aide des données récupérées.
Host	Adresse IP du serveur de base de données.
Port	Numéro du port d'écoute du serveur de base de données.
Database	Nom de la base de données.
Username et Password	Données d'authentification de l’utilisateur ou l'utilisatrice de 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.
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. Built-in : le schéma est créé et stocké localement pour ce composant seulement. Pour plus d'informations concernant les schémas des composants dans l'onglet Basic settings (Paramètres simples), consultez Onglet Basic settings. Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé. Pour plus d'informations concernant les schémas des composants dans l'onglet Basic settings (Paramètres simples), consultez Onglet Basic settings. 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 uniquement 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.
Table Name	Saisissez le nom de la table.
Query type	La requête peut être Built-in pour un Job spécifique, ou, si la requête est fréquemment utilisée, elle peut être stockée dans le Repository, afin de simplifier sa réutilisation. Built-In : renseignez manuellement l'instruction de requête ou créez-la graphiquement en utilisant SQLBuilder. Repository : sélectionnez la requête de votre choix, stockée dans le référentiel. Le champ Query est automatiquement renseigné.
Query	Saisissez votre requête de base de données en faisant attention à ce que l'ordre des champs corresponde à celui défini dans le schéma.
Guess Query	Cliquez sur le bouton Guess Query afin de générer la requête correspondant au schéma de votre table dans le champ Query.
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 > Rejects.

Advanced settings

Propriétés	Description
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.
Use PreparedStatement	Cochez cette case pour utiliser une instance PreparedStatement afin de requêter votre base de données. Dans la table Set PreparedStatement Parameter, configurez les paramètres représentés par "?" dans l'instruction SQL du champ Query dans l'onglet Basic settings. Parameter Index : saisissez la position du paramètre dans l'instruction SQL. Parameter Type : saisissez le type de paramètre. Parameter Value : saisissez la valeur de paramètre. Note InformationsRemarque : Cette option est très utile si vous devez effectuer de nombreuses fois la même requête. Elle permet un gain de performance.
Commit every	Nombre de lignes à inclure dans le lot avant de commencer l'écriture dans la base. Cette option garantit la qualité de la transaction (cependant pas de rollback) et surtout une meilleure performance d'exécution.
tStat Catcher Statistics	Cochez cette case afin de collecter les données au niveau du composant.

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. 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 Utiliser les contextes et les variables.

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.

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 Utiliser les contextes et les 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 des requêtes SQL.
Limitation	Ce composant requiert l'installation des fichiers .jar associés.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici