cSQL

Ce composant lit depuis et écrit dans toute base de données via une connexion SQL à l'aide d'une requête.

Pour plus d'informations, consultez la documentation Apache Camel https://camel.apache.org/components/latest/ (en anglais).

Remarque : Ce composant est disponible uniquement si vous avez installé la mise à jour mensuelle R2022-11 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

Propriétés du cSQL Standard

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

Le composant cSQL Standard appartient à la famille Connectivity.

Basic settings

Propriétés	Description
Datasource	Sélectionnez le composant établissant la connexion à la base de données à réutiliser par ce composant.
Output Type	Sélectionnez le type des données de sortie. SelectOne : interpréter la sortie comme un seul objet Java. SelectList : interpréter la sortie comme une liste de maps. StreamList : utiliser un itérateur pour diffuser la sortie.
Use batch mode	Cochez cette case pour exécuter l'instruction en mode batch (par lots).
Use SQL statement from message body	Cochez cette case si votre instruction de requête est spécifiée dans le corps du message.
Type	Sélectionnez le type de source de la requête SQL. Cette option n'est pas disponible si l'option Use SQL statement from message body est activée. Built-In : l'instruction de la requête sera saisie directement dans le composant. Repository : l'instruction de la requête sera sélectionnée depuis un fichier de ressource existant dans le référentiel. File Path : l'instruction de la requête sera sélectionnée depuis le système de fichiers local.
Requête	Cette option est disponible lorsque l'option Built-In est sélectionnée dans la liste Type. Spécifiez une instruction de requête de base de données en faisant attention à ce que l'ordre des champs corresponde à celui défini dans le schéma. Si vous avez installé la version mensuelle R2025-12 du Studio Talend ou une plus récente fournie par Talend, vous pouvez utiliser plusieurs lignes et formater l'instruction SQL comme vous le souhaitez. Vous pouvez également cliquer sur le bouton [...] près de la zone de code Query, pour ouvrir le SQL Builder et y créer une requête. Pour plus d'informations, consultez Créer une requête à l'aide de SQLBuilder.
Ressource	Cette option est disponible lorsque l'option Repository est sélectionnée dans la liste Type. Sélectionnez le fichier d'instruction de la requête de ressource dans le référentiel. Sélectionnez la version de l'instruction de la requête dans le champ Version si plusieurs versions de l'instruction de la requête sont disponibles.
Resource File	Cette option est disponible lorsque l'option File Path est sélectionnée dans la liste Type. Saisissez le chemin d'accès au fichier d'instruction de requête dans votre système de fichiers local.

Advanced settings

Propriétés	Description
Return generated keys from Inserts	Cochez cette case pour récupérer les clés générées lors de l'insertion de données dans une table configurée avec une clé qui s'auto-incrémente à l'aide du cSQL. Les clés générées sont contenues dans l'en-tête du message CamelSqlGeneratedKeyRows. Pour plus d'informations concernant les en-têtes de messages supportés par le cSQL, consultez Message Headers (en anglais). Pour spécifier les colonnes générées à récupérer, cliquez sur le bouton [+] autant de fois que nécessaire pour ajouter des lignes à la table Expected keys et saisissez le nom des colonnes. Note InformationsRemarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle R2025-12 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
URI Options	Configurez les arguments facultatifs dans la table correspondante. Cliquez sur le bouton [+] autant de fois que nécessaire afin d'ajouter les arguments au tableau. Dans le champ Name, vous pouvez sélectionner l'option URI dans la liste déroulante ou saisir un nom d'option qui n'est pas disponible dans la liste. Cliquez dans le champ Value correspondant et saisissez une valeur. Consultez le site https://camel.apache.org/components/latest/sql-component.html (en anglais) pour connaître les options d'URI disponibles.

Propriétés

Description

Return generated keys from Inserts

Cochez cette case pour récupérer les clés générées lors de l'insertion de données dans une table configurée avec une clé qui s'auto-incrémente à l'aide du cSQL. Les clés générées sont contenues dans l'en-tête du message CamelSqlGeneratedKeyRows. Pour plus d'informations concernant les en-têtes de messages supportés par le cSQL, consultez Message Headers (en anglais).

Pour spécifier les colonnes générées à récupérer, cliquez sur le bouton [+] autant de fois que nécessaire pour ajouter des lignes à la table Expected keys et saisissez le nom des colonnes.

Remarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle R2025-12 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

URI Options

Configurez les arguments facultatifs dans la table correspondante. Cliquez sur le bouton [+] autant de fois que nécessaire afin d'ajouter les arguments au tableau. Dans le champ Name, vous pouvez sélectionner l'option URI dans la liste déroulante ou saisir un nom d'option qui n'est pas disponible dans la liste. Cliquez dans le champ Value correspondant et saisissez une valeur. Consultez le site https://camel.apache.org/components/latest/sql-component.html (en anglais) pour connaître les options d'URI disponibles.

Utilisation

Conseils d'utilisation	Description
Règle d'utilisation	Le cSQL peut être utilisé en tant que composant de début, composant intermédiaire ou composant de fin dans une Route. Il doit être utilisé avec le composant cSQLConnection, afin d'ouvrir une connexion à la base de données. Pour plus d'informations concernant le cSQLConnection, consultez cSQLConnection.
Limitation	n/a

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