Accéder au contenu principal Passer au contenu complémentaire

Propriétés du tMSSqlOutputBulkExec Standard

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

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

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

Note InformationsRemarque : Ce composant est une version spécifique d'un connecteur à une base de données dynamique. Les propriétés associées aux paramètres de la base de données dépendent du type de base de données sélectionné. Pour plus d'informations concernant les connecteurs dynamiques de bases de données, consultez Composants génériques de bases de données.
Note InformationsRemarque : Lorsque vous construisez un Job en tant que bundle OSGI pour ESB, les pilotes jtds et mssql-jdbc de MS SQL Server utilisés par les composants SQL Server ne sont pas inclus dans l'artefact du build. Pour exécuter l'artefact dans Talend Runtime, vous devez déployer les pilotes manuellement en copiant les pilotes dans le dossier <TalendRuntimePath>/lib et en redémarrant Talend Runtime.

Basic settings

Base de données

Sélectionnez le type de base de données dans la liste et cliquez sur Apply (Appliquer).

Action

Sélectionnez l'opération que vous voulez effectuer :

Bulk Insert Bulk update

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.

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.

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.
  1. au niveau du Job parent, enregistrer la connexion à la base de données à partager dans la vue Basic settings du composant de connexion créant cette connexion à la base de données.
  2. au niveau du Job enfant, utiliser un composant de connexion dédié afin de lire cette connexion enregistrée.

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.

JDBC Provider

Sélectionnez le fournisseur du pilote JDBC à utiliser, Microsoft (recommandé, par défaut) ou Open source JTDS.

Lorsque Microsoft est sélectionné, vous devez télécharger le pilote Microsoft JDBC pour SQL Server sur le Centre de téléchargement de Microsoft. Vous devez ensuite décompresser le fichier zip téléchargé, choisir un fichier .jar dans le dossier décompressé, selon votre version de JRE, renommer le fichier .jar en mssql-jdbc.jar et l'installer manuellement. Pour plus d'informations relatives au choix du fichier .jar, consultez la configuration système requise sur le Centre de téléchargement Microsoft.

Notez que les builds OSGi n'incluent pas le pilote open source jTDS JDBC. Si vous devez construire votre Job contenant ce composant, en tant que bundle OSGi, utilisez le pilote Microsoft JDBC officiel. Sinon, ce composant fonctionne uniquement avec Datasource avec le pilote jTDS JDBC correctement installé dans Talend Runtime.

Host

Saisissez l'adresse IP ou le nom d'hôte du serveur de la base de données ou de l'instance Azure Synapse Analytics à utiliser.

Si le service SQL Server Browser est en cours d'exécution sur la machine où se situe le serveur, vous pouvez vous connecter à une instance nommée via un port TCP dynamique et fournir le nom d'hôte et le nom d'instance dans ce champ, au format {host_name}\{instance_name}. Dans ce cas, laissez le champ Port vide. Consultez Service SQL Server Browser pour plus d'informations.

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale permettent un fonctionnement optimal. Le serveur de la base de données doit être installé sur la même machine que le Studio Talend ou sur la machine sur laquelle est déployé le Job contenant un tMSSqlOutputBulkExec.

Port

Saisissez le numéro du port d'écoute du serveur de la base de données ou de l'instance Azure Synapse Analytics à utiliser.

Si le service SQL Server Browser est en cours d'exécution sur la machine où se situe le serveur, vous pouvez vous connecter à une instance nommée via un port TCP dynamique en fournissant le nom d'hôte et le nom d'instance dans le champ Host et en laissant ce champ vide. Consultez Service SQL Server Browser pour plus d'informations.

DB name

Nom de la base de données.

Schema

Nom exact du schéma.

Username et Password Saisissez les informations d'authentification.

Pour saisir le mot de passe, cliquez sur le bouton [...] près du champ Password, saisissez le mot de passe entre guillemets doubles dans la boîte de dialogue et cliquez sur OK.

Vous pouvez utiliser Type 2 integrated authentication sous Windows en ajoutant integratedSecurity=true dans Additional JDBC Parameters et en laissant ces deux champs vides. Consultez la section Connexion avec une authentification intégrée sous Windows dans la page Création de l’URL de connexion, pour plus d'informations.

Table

Nom de la table à écrire.

Notez qu'une seule table peut être écrite à la fois et la table doit exister pour que l'opération d'Insert soit autorisée.

Action on table

Sur la table définie, vous pouvez effectuer l'une des opérations suivantes :

None : aucune opération n'est effectuée.

Drop and create table : la table est supprimée et de nouveau créée.

Create table : la table n'existe pas et est créée.

Create table if not exists : la table est créée si elle n'existe pas.

Truncate table : le contenu de la table est supprimé. Vous ne pouvez pas annuler cette opération.

Clear table : le contenu de la table est supprimé. Vous pouvez annuler cette opération.

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 conservé localement pour ce composant seulement.

Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.

Lorsque le schéma à réutiliser contient des valeurs par défaut de type Integer ou Function, assurez-vous que ces valeurs par défaut ne sont pas entourées de guillemets. Si elles le sont, supprimez manuellement les guillemets.

Pour plus d'informations, consultez Récupérer les schémas de table.

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.

File Name

Nom du fichier à générer et à charger.

Note InformationsRemarque : Ce fichier peut se trouver sur la même machine que celle où se situe le serveur de la base de données ou sur une autre. Si le fichier se situe sur la même machine que le serveur de la base de données, renseignez le chemin d'accès au fichier en respectant le format attendu dans le champ. Si le fichier se trouve sur une autre machine, renseignez le nom UNC (Universal Naming Convention) (c'est-à-dire \\{Servername}\{Sharename}\{Path}\{Filename}) du fichier dans ce champ. Dans le second cas, vous avez besoin de l'autorisation pour lire le fichier et y écrire. Consultez Import en bloc dans SQL Server à partir d’un fichier de données distant pour plus d'informations.

Append

Cochez cette option pour ajouter des nouvelles lignes à la fin du fichier.

Advanced settings

Additional JDBC Parameters

Définissez des propriétés de connexion supplémentaires pour la connexion à la base de données que vous créez. Les propriétés sont séparées par un point-virgule et chaque propriété est une paire clé-valeur. Par exemple, encrypt=true;trustServerCertificate=false; hostNameInCertificate=*.database.windows.net;loginTimeout=30; pour une connexion à la base de données Azure SQL.

Ce champ n'est pas disponible si la case Use an existing connection est cochée.

Authenticate using Azure Active Directory

Cochez cette option pour utiliser l'authentification Azure Active Directory lors de l'établissement de la connexion. Consultez Utiliser Authentification Microsoft Entra pour des informations associées.

Cette option est disponible uniquement lorsque l'option Microsoft est sélectionnée dans la liste déroulante JDBC Provider dans la vue Basic settings.

Field separator

Caractère, chaîne de caractères, ou expression régulière à utiliser pour séparer les champs.

Row Separator

Chaîne (ex : &quot;\n&quot;sous Unix) utilisée pour séparer les lignes.

Première ligne

Saisissez le numéro de la ligne sur laquelle l'action doit démarrer.

Include Header

Cochez cette case pour inclure l'en-tête des colonnes dans le fichier.

Page de code

Pages de code OEM utilisées pour mapper un jeu de caractères spécifique à des valeurs numériques de code.

Type de fichier de données

Sélectionnez le type de données à gérer.

Encoding

Sélectionnez l'encodage à partir de la liste ou sélectionnez Custom et définissez-le manuellement. Ce champ doit obligatoirement être renseigné.

tStatCatcher Statistics

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

Utilisation

Règle d'utilisation

Ce composant est généralement utilisé lorsque les données à charger dans la base n'exigent aucune transformation particulière.

Dynamic settings

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.

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.

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 et Lire des données à partir de différentes bases de données MySQL à l'aide de paramètres de connexion chargés dynamiquement. Pour plus d'informations concernant les Paramètres dynamiques et les variables de contexte, consultez Schéma dynamique et Créer un groupe de contextes et définir les variables de contexte.

Limitation

Le serveur de la base de données doit être installé sur la même machine que le Studio Talend ou que le Job contenant un tMSSqlOutputBulkExec afin que le composant fonctionne correctement.

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 – dites-nous comment nous améliorer !