Setting up a SQL connector

Introduction

Cette page contient les instructions sur la façon de créer un connecteur SQL et de le connecter à vos systèmes sources.

Prérequis

Il est supposé que les outils de développement décrits dans Configuration d'un environnement de test local sont installés.

Création d'un connecteur SQL

Si vous souhaitez créer un nouveau connecteur SQL, vous pouvez télécharger le modèle de connecteur qui contient la configuration de base d'un connecteur SQL.

Démarrer le référentiel

Il est conseillé de stocker votre connecteur dans un système de contrôle de version, par exemple GitHub.

Étape	Action
1	Créez un référentiel contenant le répertoire complet du connecteur. Ce répertoire doit avoir la même structure que le connecteur téléchargé (modèle).

Configurer l'extraction

Tout d'abord, les paramètres d'extraction doivent être définis pour pointer vers le système source et la base de données de transfert souhaités. Ces étapes de configuration doivent être effectuées une fois pour chaque environnement de développeur et pour l'environnement de production.

Étape 1 : Choisir la méthode d'extraction

Chaque connecteur est livré avec un ensemble de méthodes d'extraction spécifiques. L'une des méthodes d'extraction doit être configurée pour extraire les données source.

Méthode d’extraction	Description
Charger-depuis-un-fichier	• Configurer une tâche CData pour l'extracteur Load-from-file . Voir Extracteurs : chargement à partir d'un fichier. • Utilisez une requête personnalisée spécifique à ce connecteur, qui est fournie dans extractors/load-from-file/instructions.md .
Charger depuis la source	Pour charger des données d'entrée à partir d'un système source, utilisez les instructions spécifiques situées dans extractors/load-from-source/instructions.md . L'extracteur de chargement à partir de la source n'est disponible que dans les connecteurs conçus pour des systèmes sources spécifiques, par exemple un connecteur Purchase-to-pay pour SAP.

Étape 2 : Limiter les données sources

Assurez-vous de définir les filtres appropriés pour votre extracteur, afin de charger uniquement les données nécessaires à votre analyse. Par exemple, limitez les données aux 6 derniers mois ou à un service spécifique qui vous intéresse.

Des instructions spécifiques sur le filtrage des données d'entrée peuvent être trouvées dans instructions.md de l'extracteur.

Étape 3 : Configurer le script d'extraction

Si le connecteur utilise CData Sync pour l'extraction des données, le script extract_cdata.ps1 doit pointer vers la tâche correcte. Suivez ces étapes pour configurer le script d'extraction.

Étape	Action
1	Dans le répertoire scripts/ , renommez config_template.json en config.json . config.json est ignoré par Git, de sorte que les environnements de développement et de production peuvent utiliser des configurations d'extraction différentes.
2	Dans config.json , remplacez le texte JOB_NAME_CREATED_IN_CDATA par la tâche CData qui vient d'être créée.

Si le connecteur n'utilise pas CData Sync pour extraire les données, utilisez les instructions spécifiques fournies dans instructions.md .

Configurer la transformation

Pour effectuer la transformation sur la bonne base de données intermédiaire, profiles.yml doit avoir une référence à votre base de données intermédiaire pour ce connecteur. Ces étapes de configuration doivent être effectuées une fois pour chaque environnement de développeur et pour l'environnement de production. Suivez ces étapes pour configurer la transformation.

Étape	Action
1	Copiez le contenu de transformations/profiles.yml de votre connecteur.
2	Collez le contenu dans votre profiles.yml personnel pour les ajouter. Le profiles.yml personnel doit être situé en dehors du répertoire du connecteur.
3	Modifiez le contenu pour qu'il pointe vers votre base de données intermédiaire.

Configurer le chargement

Pour effectuer la génération de cache à l'aide du script load.ps1, il doit être pointé vers l'environnement Process Mining sur lequel la version d'application correspondante est active. Suivez ces étapes pour configurer le script d'extraction.

L'étape 1 peut être omise si elle a déjà été effectuée lors de la configuration de l'extraction.

Étape	Action
1	Dans le répertoire scripts/ , renommez config_template.json en config.json . config.json est ignoré par Git, de sorte que les environnements de développement et de production peuvent utiliser des configurations d'extraction différentes.
2	Dans config.json , remplacez le texte PROCESS_MINING_ENVIRONMENT par l'environnement sur lequel la version est active.

Prochaines étapes

Lorsque le connecteur SQL est correctement configuré, il peut être exécuté. Voir Exécution d'un connecteur SQL.