DSEDataSourceExplorer
DSE 1.0.1

Manuel utilisateur

Ce guide décrit le flux d’utilisation complet de Data Source Explorer (DSE).

Utilisez-le lorsque vous voulez une référence détaillée couvrant :

1. Rôle de l’application

DSE est une application de bureau orientée opérateur, conçue pour découvrir des sources de données, inspecter leur structure, préparer des définitions d’extraction ou de mapping, puis générer des artefacts de sortie réutilisables.

Le flux habituel est le suivant :

  1. choisir une cible et lancer Discover
  2. inspecter l’arborescence des sources découvertes
  3. revoir ou modifier la connexion
  4. tester la connectivité
  5. charger tables / collections / buckets / autres objets
  6. examiner la structure et l’aperçu des données
  7. construire un Schema Catalog / Data Catalog utile
  8. composer des cibles de sortie lorsque des objets de destination sont nécessaires
  9. générer des déployables pour une ou plusieurs cibles d’exécution
  10. revoir les fichiers générés et, si besoin, produire le schéma graphique

2. Organisation de la fenêtre principale

Zone de commandes en haut

Elle permet de :

Arborescence de navigation à gauche

La zone gauche affiche l’environnement découvert. Selon le contexte, vous pouvez voir :

Zone de travail à droite

Elle affiche :

3. Démarrer une session

  1. Lancez l’application.
  2. Sélectionnez la langue de l’interface si nécessaire.
  3. Dans la zone cible, saisissez la machine, l’hôte, l’environnement ou le chemin de découverte à inspecter.
  4. Choisissez le type de découverte si plusieurs modes sont proposés.
  5. Cliquez sur Discover.

Bonnes pratiques

4. Découvrir et explorer les sources

Après la découverte, examinez attentivement l’arborescence de gauche.

Points à vérifier :

Flux recommandé

  1. développez l’arborescence niveau par niveau
  2. sélectionnez une source d’intérêt
  3. lisez le résumé à droite
  4. décidez si vous devez ouvrir les détails, modifier la connexion, retirer le scope ou poursuivre vers le chargement des objets

5. Revoir les détails et modifier la connexion

Pour la source sélectionnée, DSE peut proposer des actions comme :

Open details

Affiche un résumé technique en lecture seule du nœud ou de la connexion sélectionnée.

Edit connection

À utiliser lorsque :

Séquence recommandée :

  1. modifiez uniquement les champs nécessaires
  2. enregistrez la connexion
  3. lancez immédiatement Test connection
  4. poursuivez ensuite avec le chargement des objets ou la génération des déployables

6. Tester la connexion

Utilisez Test connection avant toute opération importante.

Un bon test confirme que :

Si le test échoue :

7. Charger les objets et inspecter la structure

Après un test réussi, cliquez sur Load tables ou sur la commande équivalente.

Selon le type de source, cela peut charger :

Comment inspecter les objets

  1. sélectionnez un objet dans la liste
  2. consultez Table info ou l’onglet équivalent
  3. ouvrez Preview pour voir des lignes ou documents d’exemple
  4. utilisez Row details pour examiner un enregistrement précis
  5. consultez Catalog Schema et Data Catalog pour transformer la structure en définition réutilisable

8. Construire le Schema Catalog et le Data Catalog

Schema Catalog

Utilisez cette zone pour définir la vue structurelle des objets source pertinents pour l’extraction ou le déploiement.

Data Catalog

Utilisez cette zone pour enrichir ou revoir les champs et objets sélectionnés dans une perspective plus réutilisable et orientée utilisateur.

Bonnes pratiques

9. Générer directement les Output Data

Utilisez Output Data lorsque vous souhaitez produire des artefacts de données à partir du catalogue sélectionné.

Cas d’usage :

Types de sortie courants :

Avant un run important :

10. Composer les cibles de sortie

Utilisez Compose targets lorsque vous avez besoin de mappings orientés destination, et pas seulement d’exploration de source.

Dans le compositeur, vous travaillez généralement avec trois niveaux :

  1. lignes/champs source disponibles à gauche
  2. une ou plusieurs cibles au centre
  3. les objets cible et les mappings de champs à droite

Flux type

  1. créez une cible de destination
  2. choisissez le preset ou le type de système cible
  3. créez un ou plusieurs objets cible
  4. sélectionnez les lignes/champs source
  5. ajoutez-les à l’objet cible sélectionné
  6. relisez la grille de mappings
  7. corrigez les avertissements de validation
  8. enregistrez la définition de cible

Conseils de validation

Corrigez avant l’enregistrement :

11. Générer des déployables

Utilisez Generate deployables pour produire un runner portable ou des artefacts associés à partir du catalogue et/ou de cibles enregistrées.

Modes d’entrée

DSE prend en charge deux approches :

Avec les cibles enregistrées activées, vous pouvez ajouter des cibles depuis la liste, constituer un ensemble multi-cible, basculer entre les chips et supprimer une cible du job courant.

Section Destination instance

Elle configure la manière dont le déployable se connectera à la destination ou interprétera la définition de cible.

Champs à relire :

Plates-formes et runtimes

Choisissez une ou plusieurs plates-formes, puis un ou plusieurs runtime identifiers compatibles.

Output options

Choisissez les fichiers que le runner doit produire, par exemple :

Vérifiez aussi :

Panneau de readiness

Avant de générer, lisez la zone de préflight/readiness.

Elle doit indiquer s’il manque encore :

Générer

Quand tout est prêt :

  1. vérifiez les cibles et chips sélectionnés
  2. vérifiez les valeurs de destination
  3. vérifiez plates-formes, runtimes, formats et dossier
  4. cliquez sur Generate

12. Persistance de la configuration de job

Quand vous quittez Generate deployables, l’application peut demander si vous voulez conserver la configuration.

Si vous la conservez

La prochaine ouverture peut restaurer :

Si vous ne la conservez pas

La configuration temporaire est supprimée.

13. Revoir les déployables générés

Après génération, DSE affiche une vue de synthèse.

Utilisez-la pour :

14. Revoir les résultats d’exécution

La fenêtre de résultats est la surface de validation post-run.

Elle peut fournir :

Flux recommandé

  1. ouvrez la fenêtre de résultats
  2. sélectionnez chaque fichier au moins une fois
  3. inspectez les onglets ou le texte
  4. vérifiez les nombres de lignes et les noms de colonnes
  5. ouvrez le fichier sur disque si une validation externe est nécessaire

15. Générer le schéma graphique

Dans la fenêtre de résultats, utilisez Generate schema pour construire un graphe visuel du run.

Le graphe peut relier :

C’est utile pour :

Pendant la construction, l’indicateur de progression doit montrer qu’une activité est en cours.

Save graph

Utilisez Save graph pour exporter le schéma dans un format pris en charge, comme :

16. Workspaces

Utilisez le menu Workspace pour gérer des sessions réutilisables.

Actions courantes :

Recommandation

17. Plugins, Logs et Help

Plugins

Ouvrez Plugins pour revoir les fournisseurs/extensions disponibles. Si un type de source manque ou se comporte différemment, vérifiez d’abord l’état du plugin.

Logs

Ouvrez Logs dès que vous avez besoin de détails techniques sur la découverte, la connexion, la génération ou l’exécution.

Help

Ouvrez Help pour la documentation consultable. Appuyez sur F1 pour l’aide contextuelle.

18. Séquence d’exploitation recommandée

  1. ouvrez ou créez un workspace
  2. découvrez le périmètre visé
  3. sélectionnez une source et revoyez ses détails
  4. modifiez la connexion si nécessaire
  5. testez la connexion
  6. chargez les objets
  7. inspectez l’aperçu et la structure
  8. construisez le catalogue
  9. composez les cibles si le run exige un mapping explicite
  10. ouvrez generate deployables
  11. choisissez des cibles enregistrées ou l’entrée par catalogue
  12. relisez destination, plates-formes, runtimes, formats et dossier
  13. générez le déployable
  14. ouvrez le résumé puis les résultats
  15. examinez les fichiers et aperçus
  16. générez et enregistrez le schéma graphique si une documentation est nécessaire
  17. enregistrez le workspace

19. Checklist de dépannage

Discovery renvoie trop ou pas assez

Test connection échoue

Les objets n’apparaissent pas après chargement

La génération est bloquée

Les résultats semblent incomplets

20. Recommandations finales

Pour une expérience fiable :

← PrécédentSuivant →