Install

Commencez par télécharger le paquet « Microsoft SQL » disponible dans l'Apps Manager.

Une fois l'installation du paquet terminée, le nœud « mssql » sera disponible dans votre Data Flow Manager. Glissez-déposez le nœud dans votre flux.

Configuration

Double-cliquez sur le nœud pour l'ouvrir.

• Node name : Modifie le nom du nœud tel qu'il apparaît dans le Data Flows Manager. N'a aucun effet sur la requête ni sur la connexion.
• Connection : Utilisé pour créer une configuration de connexion vers le serveur MSSQL.
• Request Type : Permet de configurer la façon dont la requête est effectuée auprès du serveur. Davantage de documentation sur la configuration et le fonctionnement de ces types de requêtes est disponible dans la section d'aide (Help) du nœud (représentée par une icône de livre).

Le reste de la section de configuration générale (General Configuration) est déterminé par le type de requête (Request Type) sélectionné.

• Table Extract : Permet d'interroger une table spécifique de la base.
• Table : Nom de la table à interroger.
• Ordering column : La colonne par laquelle la table doit être triée. (Requis)
• Historical Extract : Si cette case est cochée, la requête commencera toujours l'extraction à partir de la première ligne de la table. Sinon, elle récupérera uniquement la dernière ligne.
• Custom SQL Request : Permet de soumettre une requête SQL personnalisée. Cependant, cette requête est statique et ne peut pas être modifiée.
• Triggered Request : La requête peut également être exécutée en transmettant au nœud un objet msg contenant un champ request. Cela permet de modifier dynamiquement la requête en utilisant des nœuds de fonction (JS function).

Exemple de configuration d'une requête déclenchée (Triggered Request) avec un nœud de fonction :

La documentation sur les requêtes MSSQL est disponible ici.

L'onglet suivant du nœud MSSQL est Request Configuration :

• Recover Lines : Permet à la requête de récupérer les x dernières lignes avant les nouvelles lignes. C'est utile si des champs sont susceptibles de changer après leur création.
• Max Lines : Définit un nombre maximum de lignes pouvant être demandées. Avec certaines configurations, cela divisera la requête en plusieurs sous-requêtes pour tout récupérer.
• Override-Timezone : Cela décale les dates reçues selon le fuseau horaire défini dans ce champ. La valeur par défaut est UTC, qui n'applique aucun décalage.

Pour connecter le nœud au serveur, assurez-vous que « Add new mssql-server… » est sélectionné dans le champ Connection de l'onglet de configuration générale, puis cliquez sur l'icône de crayon à côté pour commencer à créer une nouvelle configuration MSSQL.

• Node name : Détermine le nom de la configuration. (Optionnel)
• Host : L'adresse IP ou l'URL du serveur à interroger.
• Port : Le numéro de port utilisé par le serveur pour se connecter. 1433 est utilisé comme port par défaut du protocole.
• Timeout : Détermine le nombre de secondes pendant lesquelles le nœud attendra une réponse avant d'expirer (timeout).
• Username : Le nom d'utilisateur du compte de service utilisé pour accéder au serveur.
• Domain : Le domaine dans lequel réside l'utilisateur si un compte Windows est utilisé. (Optionnel)
• Password : Le mot de passe du compte de service utilisé pour accéder au serveur.
• Database : Le nom de la base de données à partir de laquelle les données seront extraites.
• Default as UTC : En l'absence d'information sur les fuseaux horaires des données de type date-heure, la lecture se fera par défaut en UTC. (Optionnel)
• TDS Version : TDS (Tabular Data Stream) est le protocole utilisé pour transférer des données entre une base de données et un client. Ce paramètre peut nécessiter d'être modifié si la base de données du client utilise une version de TDS antérieure à 2012. Une fois toutes les informations saisies, cliquez sur « Add » pour ajouter la configuration au nœud.

La configuration devrait être prête. Cliquez sur « Done » pour enregistrer la configuration du nœud, puis sur « Deploy » en haut à droite de la fenêtre pour sauvegarder vos modifications.

Si la connexion a été établie, le nœud devrait afficher un symbole de statut vert et indiquer « Connected ».
Si les requêtes qui lui sont adressées renvoient des données, le nœud affichera ce statut, et les sorties pourront être visualisées à l'aide d'un nœud debug :