Portail de support Workiva

Avec le connecteur Microsoft® SQL Server®, vous pouvez utiliser les commandes dans une chaîne pour effectuer des opérations en langage de requête structuré (SQL) dans les bases de données Microsoft SQL Server, y compris des solutions telles que Microsoft Dynamics® Great Plains® (GP) ou Yardi® Private Cloud. Par exemple, avec ce connecteur, vous pouvez :

• Exécuter des commandes SQL, y compris une instruction CREATE ou UPDATE ou une requête SELECT.
• Récupérer les détails d'une table dans SQL Server
• Insérer des enregistrements dans une base de données SQL Server

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Exigences

Pour permettre la connexion à la base de données SQL Server, le connecteur utilise la connectivité de base de données Java (JDBC), sécurisée par une authentification de base par nom d'utilisateur et mot de passe. Pour configurer le connecteur, vous aurez besoin de :

• Un utilisateur d'intégration désigné créé dans SQL Server pour le connecteur
• Nom d'utilisateur et mot de passe de l'utilisateur d'intégration
• L'URL de la connexion JDBC, par exemple jdbc:sqlserver://localhost:1433;[options]
• Pour se connecter à une base de données SQL Server sur site, un GroundRunner pour la connexion

Versions prises en charge

Le connecteur Microsoft® SQL Server® est compatible avec les versions suivantes de la base de données :

• Base de données SQL Azure
• Azure Synapse Analytics
• Instance gérée Azure SQL
• Serveur SQL 2022
• SQL Server 2019
• SQL Server 2017
• SQL Server 2016
• SQL Server 2014

Configurer le connecteur Microsoft SQL Server

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Microsoft SQL Server et le programme d'exécution à utiliser avec la connexion.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. Sous Properties, entrez les détails du connecteur :
   
   

   Propriété	Détails
   Nom d’utilisateur	Saisissez le nom d'utilisateur de l'utilisateur d'intégration SQL Server du connecteur.
   Mot de passe	Saisissez le mot de passe pour la propriété Username.
   URL de connexion	Saisissez l'URL de la connexion JDBC, par exemple jdbc:sqlserver://<server>:<port>. Pour inclure des propriétés optionnelles pour la connexion, ajoutez-les après un point-virgule, comme jdbc:sqlserver://localhost:1433;<options>. Par exemple, pour se connecter à une base de données à l'aide de la sécurité intégrée Active Directory® : ;databasename=<database>;integratedSecurity=True;authenticationScheme=NTLM Note : Par défaut, le port est 1433; cependant, cela peut être différent dans votre environnement.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256. Pour des raisons de sécurité, évitez d'inclure les informations d'identification de l'utilisateur en tant que propriétés facultatives dans la propriété Connection URL.

5. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande Get Table Definition du connecteur et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si la connexion au serveur SQL échoue :

• Vérifiez les informations d'authentification de l'utilisateur d'intégration.
• Vérifiez l'URL de la connexion JDBC, y compris le serveur et le port.
• Si vous vous connectez à une base de données sur site, vérifiez le GroundRunner sélectionné pour le connecteur.

Si la connexion ne parvient pas à exécuter une commande, vérifiez que ses entrées, telles que la syntaxe SQL ou la table, sont valides.