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

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.

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

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.

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 :
  • Application Client ID : saisissez l'ID client pour l'application enregistrée. Cette information se trouve dans les détails de votre application, dans Azure Active Directory > App registrations > Essentials.
  • Application Client Secret : saisissez le mot de passe du client pour l'application enregistrée. Cette information se trouve dans les détails de votre application, dans Azure Active Directory > App registrations > Certificates and secrets.

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.

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.