Configurer un connecteur SFTP

Dans ce cours, nous allons configurer un connecteur SFTP et importer un jeu de données depuis un serveur SFTP distant.

Le connecteur SFTP fonctionne en import seul : il permet de parcourir les fichiers d'un serveur SFTP et de les importer comme jeux de données.

1. Prérequis

Pour configurer ce connecteur, vous avez besoin d'un serveur SFTP et de ses informations de connexion :

  • l'adresse du serveur (hôte) ;
  • le port (par défaut 22) ;
  • un identifiant (login) ;
  • un mot de passe ou une clé SSH privée.

Dans ce cours, nous utilisons le serveur SFTP public de démonstration test.rebex.net (identifiant demo, mot de passe password).

2. Configuration du connecteur

Dans la configuration du connecteur, renseignez les champs suivants :

  1. le Titre du catalogue, pour l'identifier dans Data Fair ;
  2. l'Adresse de l'hôte du serveur SFTP ;
  3. le port (par défaut 22) ;
  4. l'Identifiant de connexion ;
  5. le Mode de connexion : Mot de passe ou clé SSH.
Configuration du connecteur SFTP
Les champs de configuration du connecteur SFTP

Selon le Mode de connexion [1] choisi, un dernier champ apparaît :

  • en mode Mot de passe, saisissez le mot de passe du compte sur le serveur distant ;
  • en mode clé SSH, collez dans le champ [2] le contenu de votre clé SSH privée (par exemple une clé au format OpenSSH : -----BEGIN OPENSSH PRIVATE KEY----- … -----END OPENSSH PRIVATE KEY-----).
Mode de connexion par clé SSH
Le mode « clé SSH » attend le contenu de votre clé privée

Une fois les champs renseignés, cliquez sur Créer. Les informations de connexion sont alors vérifiées : si elles sont incorrectes, la création est bloquée (message « Invalid configuration: Connection test failed »). Sinon, le catalogue est créé et prêt à être utilisé.

3. Import des données

Depuis votre catalogue, créez un nouvel import. Vous accédez alors à l'arborescence du serveur SFTP : naviguez dans les dossiers [1] jusqu'au fichier souhaité, sélectionnez-le [2], puis cliquez sur Suivant [3].

Sélection d'un fichier sur le serveur SFTP
Naviguez dans les dossiers puis sélectionnez le fichier à importer

L'étape Configuration de l'import propose des paramètres généraux communs à tous les connecteurs (jeu de données à mettre à jour, planification, etc.), décrits dans le cours général sur les connecteurs de catalogues. Le connecteur SFTP n'ayant pas de paramètre d'import spécifique, cliquez simplement sur Importer.

Import terminé
Le journal d’exécution confirme l’import et le jeu de données créé

Une fois l'import terminé [1], le journal d'exécution [2] récapitule les étapes réalisées. Vous pouvez alors ouvrir le jeu de données importé [3] directement dans Data Fair.

Si vous avez des remarques sur ce cours, n'hésitez pas à nous les communiquer.