Support Center
Explorez, Analysez & Documentez votre Code

Extraire et analyser un modèle de données via des fichiers DDL

Lorsque l'accès direct à la base de données est impossible — pour des raisons de sécurité, de réseau ou d'infrastructure — le modèle de données peut néanmoins être analysé dans Visual Expert à partir de fichiers DDL (Data Definition Language).

Ces fichiers, générés par un DBA ou exportés depuis le SGBD, contiennent les définitions structurelles des objets de base de données : tables, vues, index… En les important dans Visual Expert, l'outil reconstruit le schéma et l'intègre à l'analyse du projet, permettant de documenter les structures de données et leurs relations sans connexion directe à la base.

Comment importer des fichiers DDL dans Visual Expert

1. Générer les fichiers DDL

Créez des fichiers texte contenant les instructions DDL qui définissent la structure de la base de données. Ces fichiers incluent généralement des instructions telles que :

  • CREATE TABLE
  • CREATE INDEX
  • CREATE VIEW
  • D’autres définitions d’objets de base de données

Ces scripts peuvent déjà exister dans les ressources du projet. Dans le cas contraire, un administrateur de base de données (DBA) peut les générer directement depuis la base.

2. Stocker les fichiers DDL dans un dossier

Une fois les scripts générés, placez tous les fichiers DDL dans un dossier accessible par Visual Expert. Ce dossier servira de source pour la lecture et l'analyse des définitions des objets de base de données.

3. Ajouter une nouvelle source dans le projet Visual Expert

Ajoutez le dossier contenant les fichiers DDL comme nouvelle source de code dans votre projet Visual Expert.

  • Ouvrez Project Settings dans Visual Expert.
  • Accédez à la section Source code.
  • Cliquez sur Add Source.
  • Sélectionnez le langage du code à analyser.
  • Sélectionnez le dossier contenant les fichiers DDL.

Pour plus de détail sur comment ajouter des sources :

4. Sélectionner le type de source approprié

Lors de l’ajout de la source, choisissez le type en fonction de la base utilisée :

  • Pour Oracle ou PostgreSQL, ajoutez une source Oracle.
  • Pour toutes les autres bases, ajoutez une source SQL Server.

Cela permet à Visual Expert d’interpréter correctement les définitions contenues dans les fichiers DDL.

5. Déclarer la dépendance avec le code source de l'application

Pour que Visual Expert établisse le lien entre les objets de base de données et l'application, vous devez déclarer une dépendance entre le code source et la source DDL.

  • Ouvrez Project Settings.
  • Accédez à l’onglet Application Dependencies.
  • Déclarez une dépendance entre le projet et la nouvelle source contenant les objets de la base de données.

Pour plus d’informations : Définir les dépendances inter-applications.

Une fois ces étapes terminées, lancez l'analyse du projet pour que Visual Expert interprète les fichiers DDL et intègre les objets dans l'analyse et la documentation.

Important

  • Vérifier la complétude des DDL
    Les fichiers doivent contenir les définitions des principaux objets (tables, vues, index) pour reconstruire correctement le modèle de données.
  • Utiliser des scripts SQL valides
    Assurez-vous que les fichiers ne contiennent pas d’instructions incomplètes ou incompatibles.
  • Organiser les scripts
    Si plusieurs fichiers sont utilisés, structurez-les correctement dans un dossier.
  • Déclarer correctement les dépendances
    Cela est essentiel pour permettre à Visual Expert d’identifier les interactions entre le code et la base.
  • Vérifier les résultats
    Après l’analyse, contrôlez que les objets ont été correctement importés.

 

Autres articles sur l'analyse du code :

Articles recommandés