Propriétés du tMSSqlConnection Standard
Ces propriétés sont utilisées pour configurer le tMSSqlConnection s'exécutant dans le framework de Jobs Standard.
Le composant tMSSqlConnection Standard appartient aux familles Bases de données et ELT.
Le composant de ce framework est disponible dans tous les produits Talend.
Basic settings
Base de données |
Sélectionnez le type de base de données dans la liste et cliquez sur Apply (Appliquer). |
Property type | Peut-être Built-In ou Repository.
|
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. |
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. |
Schema | Saisissez le nom du schéma de la base de données. |
Base de données |
Saisissez le nom de la base de données. |
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. |
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. |
Use or register a shared DB Connection |
Cochez cette case afin de partager votre connexion à la base de données ou récupérer une connexion partagée par un Job parent ou enfant. Dans le champ Shared DB Connection Name qui s'affiche, saisissez un nom pour la connexion à la base de données partagée. Cela vous permet de partager une connexion à une base de données (à l'exception du paramètre de schéma de la base de données) à plusieurs composants de connexion, à différents niveaux de Jobs, enfants ou parents. Cette option est incompatible avec les options Use dynamic Job et Use an independent process to run subJob du composant tRunJob. Utiliser une connexion partagée avec un tRunJob ayant l'une de ces options activée fera échouer votre Job. Cette case est indisponible lorsque la case Specify a data source alias est cochée. |
Specify a data source alias |
Cochez cette case et spécifiez l'alias de la source de données créée du côté de Talend Runtimepour utiliser le pool de connexions partagées défini dans la configuration des données source. Cette option fonctionne uniquement lorsque vous déployez et exécutez votre Job dans Talend Runtime . Cette case n'est pas visible lorsque la case Use or register a shared DB Connection est cochée. |
Data source alias |
Saisissez l'alias de la source de données créée du côté Talend Runtime. Ce champ est disponible uniquement lorsque la case Specify a data source alias est cochée. |
Advanced settings
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. |
Enable always encrypted (Column encryption) | Sélectionnez cette option pour utiliser la fonctionnalité Microsoft Always encrypted (Chiffrement permanent) afin de chiffrer et protéger vos données. Pour utiliser cette option, vous devez avoir précédemment stocké vos secrets avec Azure Key Vault :
Certaines limitations concernant les opérations et les instructions de requêtes s'appliquent à cette fonctionnalité. Pour la liste exhaustive des limitations, consultez la documentation Microsoft SQL Server. |
Auto Commit |
Cochez cette case afin de commiter automatiquement toute modification dans la base de données lorsque la transaction est terminée. Lorsque cette case est cochée, vous ne pouvez pas utiliser les composants de commit correspondant pour commiter les modifications dans la base de données. De la même manière, lorsque vous utilisez un composant de commit, cette case doit être décochée. Par défaut, la fonctionnalité d'auto-commit est désactivée et les modifications doivent être commitées de manière explicite à l'aide du composant correspondant de commit. Notez que la fonctionnalité d'auto-commit permet de commiter chaque instruction SQL comme transaction unique immédiatement après son exécution et que le composant de commit ne commite pas jusqu'à ce que toutes les instructions soient exécutées. Pour cette raison, si vous avez besoin de plus d'espace pour gérer vos transactions dans un Job, il est recommandé d'utiliser un composant Commit. |
Partager l'insertion d'identité dans des tables multiples |
Cochez cette case pour partager IDENTITY_INSERT à plusieurs tables Microsoft SQL acceptant des données issues de la même connexion à la base de données. Cette option permet d'éviter des erreurs causées par le réglage de IDENTITY_INSERT sur ON (ou OFF) de manière répétée en cours d'écriture de tables Microsoft SQL via une connexion à une base de données. Il est nécessaire de cocher cette option lorsque le composant est utilisé en combinaison avec plusieurs composants tMSSqlOutput ayant l'option Turn on Identity insert activée dans l'onglet Basic settings. Notez que l'activation de cette option peut réduire la performance d'exécution. |
tStatCatcher Statistics | Cochez cette case pour collecter les métadonnées de process du Job, aussi bien au niveau du Job qu'au niveau de chaque composant. |
Utilisation
Règle d'utilisation | Ce composant est généralement utilisé avec d'autres composants tMSSql*, notamment les composants tMSSqlCommit et tMSSqlRollback. |
Limitation |
Du fait d'une incompatibilité de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans l'onglet Component. Vous pouvez également trouver les JAR manquants et les ajouter dans l'onglet Modules de la perspective Integration de votre Studio Talend. Pour plus d'informations, consultez la page Installation de modules externes. |