Connecteurs

plug.svg

Généralités - Connecteurs

Le connecteur permet de définir le protocole de communication permettant d’atteindre des données. Les connecteurs sont gérés au niveau du module GenericsData Logo GenericsData de l’offre DataChain.

Principes

  • Le nombre de Connecteurs n’est pas limité.

  • Le connecteur représente le Niveau 1 de la chaîne de valeurs DataChain (cf. Principes Généraux).

Chaîne de valeurs

  • Nécessaire et Obligatoire.

  • Lié à un ou plusieurs dépôts.

  • Plusieurs connecteurs du même type peuvent être créés.

Métadonnées

Comme l’ensemble des éléments DataChain, un connecteur possède un panneau de métadonnées composé :

  • d’un libellé (Obligatoire)

  • d’une description

  • de n tags

  • d’un type de licence (Saisie libre)

Paramètres du connecteur

Les paramètres définissent l’ensemble des informations nécessaires à la mise en œuvre du protocole de communication.

En fonction du type de protocole choisi, les paramètres sont variables. La solution DataChain intègre de base les types de connecteurs standards.

  • Connecteur HDFS

  • Connecteur SFTP

  • Connecteur Base de données

    • Oracle

    • SqlServer

    • PostGres

    • MariaDb

    • MySql

    • MongoDb

    • Neo4J

  • Connecteur S3 (AWS)

  • Connecteur ElasticSearch

  • Connecteur Http/Https

  • …​

Création d’un Connecteur

La création d’un connecteur (comme l’ensemble de la gestion des connecteurs) se réalise à partir du Module GenericsData Logo GenericsData de DataChain.

Étape 1 : Accès à la gestion des connecteurs

Accès par la liste des connecteurs existants

  • Accès au module GenericsData Logo GenericsData

  • Barre de Menu Gauche

  • Choix de l’item Connecteurs plug.svg

  • Clic sur bouton ajouter_chart.svg

Accès par le raccourci Création nouveau Connecteur

  • Depuis le Module GenericsData Logo GenericsData.

  • Bandeau Haut.

  • Clic sur icône plus-square.svg

  • Menu Nouveau Connecteur.

Étape 2 : Création du connecteur

Saisie des métadonnées

Vue Mégadonnées

  • Chaque Connecteur possède un panneau de métadonnées. Attention La saisie d’un libellé est obligatoire.

Des zones de saisie optionnelles permettent d’apporter des informations complémentaires. Une icône peut ainsi être affectée au connecteur via les commandes présentes dans son panneau des métadonnées.

information Il est conseillé d’enregistrer le panneau des métadonnées dès la saisie effectuée. Utiliser le bouton enregistrer-bouton_light situé dans la partie droite du bandeau de l’écran connecteur.

Type de connecteur

  • Le choix du type de connecteur est obligatoire

  • Utiliser la zone de choix Type connecteur et sélectionner un connecteur (Base de données, SFTP, HDFS, Http/https, Elastics Search, S3, ..)

Les paramètres en fonction du type de connecteur*

Base de données Sql et NoSql

Pour les bases de données, deux modes de saisie des paramètres de connexion sont disponibles

Mode assisté (chaîne de connexion générée automatiquement)

  • Type de la base données (Obligatoire)

  • Utilisateur (Obligatoire)

  • Mot de passe (Obligatoire)

  • Hôte (Obligatoire)

  • Port (Obligatoire)

  • Nom de la base (Obligatoire)

  • Complément (Saisie libre)

  • Chaîne de connexion : cette zone est remplie automatiquement en fonction des renseignements saisis.

Un mode libre (chaîne de connexion à saisir manuellement)

  • Type de la base données (Obligatoire)

  • Utilisateur (Obligatoire)

  • Mot de passe (Obligatoire)

  • Chaîne de connexion : zone de saisie libre.

HDFS
  • Hôte (Obligatoire)

  • Port (Obligatoire)

SFTP
  • Hôte (Obligatoire)

  • Port (Obligatoire)

  • Si SSH

    • Clé publique (obligatoire)

    • Phrase secrète (obligatoire)

  • Si pas de SSH

    • Utilisateur (Obligatoire)

    • Mot de passe

Http/Https
  • Hôte (Obligatoire)

  • Port (Obligatoire)

  • Sécurisé (https)

    • ElasticSearch

  • Hôte (Obligatoire)

  • Port (Obligatoire)

S3 (AWS)
  • Clef d’accès AWS (Obligatoire)

  • Clef secrète AWS (Obligatoire)

  • Point de terminaison AWS (Obligatoire)

Test de la connexion Une fois les informations saisies, un bouton tester.svg permet de réaliser un test de connexion et valide (ou invalide) les paramètres du protocole.

  • Enregistrement du connecteur

    • Pour enregistrer l’ensemble des informations du connecteur, cliquer sur le bouton enregistrer-bouton_light.svg.

    • Le bouton retour-bouton_light.svg permet d’accéder à la liste des connecteurs existants.

Explorateur de fichier

L’explorateur est disponible pour les connecteurs HDFS, MiNio, S3 et SFTP.

Il permet de visualiser l’ensemble des répertoires contenant les fichiers distants.

Pour explorer les fichiers distants, cliquer sur "Explorer". Explorer

Édition d’un connecteur

  • Accès au module GenericsData Logo GenericsData

  • Barre de Menu Gauche

  • Choix du Menu Connecteurs connecteur-flat.svg

  • Recherche dans la liste du connecteur ciblé

Les listes des éléments de l’offre DataChain possèdent des fonctions de filtre et de recherche sur colonnes. Utiliser ces fonctions pour rechercher le connecteur ciblé.

  • Clic sur le libellé du connecteur choisi ou sur l’icône edit en bout de ligne.

Suppression d’un connecteur DataChain

  • Accès au module GenericsData Logo GenericsData

  • Barre de Menu Gauche

  • Choix du Menu Connecteurs plug.svg

  • Recherche dans la liste du connecteur ciblé

Les listes des éléments possèdent des fonctions de filtre et de recherche sur colonnes. Utiliser ces fonctions pour rechercher le connecteur ciblé.

  • Option 1 : Utiliser le bouton l’icône suppression en bout de ligne et confirmer l’action.

  • Option 2

    • Cliquer sur le libellé du connecteur choisi ou sur l’icône edit en bout de ligne.

    • Une fois la page d’édition du connecteur affichée, cliquer sur le bouton Supprimer puis confirmer l’action.

Attention Lors de la suppression d’un connecteur, un contrôle d’impact est effectué. Si le connecteur est consommé (utilisé dans un dépôt comme paramètre ou dans un modèle d’export), alors la suppression est impossible. Un message indiquera à l’utilisateur, les dépôts ou les modèles d’exports consommant le connecteur.

Cas particulier du Connecteur Local

DataChain embarque un connecteur dans son déploiement de base. Il permet d’intégrer des données sans avoir besoin de créer un connecteur.

Attention Noter que dans le cas de l’utilisation d’un connecteur local, les données seront physiquement stockées dans le contexte DataChain. Noter aussi que le connecteur local, n’est pas disponible ni visible dans la liste des connecteurs.

Attention Au niveau du paramétrage d’un dépôt, il est alors possible de choisir soit un connecteur paramétré, soit le mode connecteur local

Quick Reference

Création d’un Connecteur

Étapes Objectif Action Repères

1

Accès à la liste des Connecteurs. Menu Connecteur

Menu Gauche GenericsData Logo GenericsData

plug Connecteur

2

Création d’un nouveau connecteur

Cliquer sur bouton Nouveau

ajouter_chart.svg

3

Saisie des métadonnées

Saisir un libellé (Obligatoire)

Volet métadonnées

4

Choix d’un type de connecteur

Liste des connecteurs disponibles

5

Saisie des informations liées au type de connecteur

Volet paramètres (différent selon le type de connecteur)

tester

6

Enregistrement

Bouton Enregistrer

enregistrer-bouton_light