Installation

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

Une fois l'installation du paquet terminée, le nœud « mysql » 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.

• Database : Utilisé pour créer une configuration de connexion vers le serveur MySQL.
• 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.

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

• Host : L'adresse IP ou l'URL du serveur à interroger.
• Port : Le numéro de port utilisé par le serveur pour se connecter. 3306 est utilisé comme port par défaut du protocole.
• User : Le nom d'utilisateur du compte de service pour accéder au serveur.
• Password : Le mot de passe du compte de service pour accéder au serveur.
• Database : Le nom de la base de données.
• Timezone : Spécifie le fuseau horaire des données extraites. (Optionnel)

Gardez à l'esprit cette restriction (disponible dans la section d'aide du nœud) concernant le nœud mysql lors de la création du compte de service pour la connexion :

Une fois tous les champs remplis, la configuration devrait être prête. Cliquez sur « Done » pour enregistrer, puis sur « Deploy » en haut à droite pour sauvegarder vos modifications.

Interrogation du nœud

La documentation spécifiant comment interroger le nœud mysql figure dans la section d'aide du nœud.

La propriété msg.topic est utilisée pour véhiculer la requête vers le nœud, et le nœud renvoie les résultats dans msg.payload.

Pour générer la requête dans msg.topic, un nœud de fonction (function node) sera nécessaire. Insérez un nœud de fonction avant le nœud mysql. Un nœud inject sera également requis pour déclencher le flux à un intervalle régulier (configurable à l'intérieur du nœud inject). Un nœud debug sera enfin requis pour visualiser la réception des données. Ajoutez les nœuds et connectez-les comme illustré :

Voici un exemple de ce à quoi pourrait ressembler le code dans le nœud de fonction :

Comme cela est fait en code JavaScript, vous pouvez également ajouter du code pour rendre la requête dynamique, par exemple pour interroger des plages de temps glissantes.

Une fois le nœud inject déclenché, le nœud mysql devrait afficher un symbole vert et renvoyer les messages de données dans la fenêtre debug, en supposant que tout a été configuré correctement.