Se connecter à une base de données SQL

Last modified by Aurelie Bertrand on 2024/04/10 11:58

DigDash Enterprise vous permet de récupérer des informations provenant de bases de données (MySQL, SQL Server, PostgreSQL, Oracle, DB2, DB2(AS400), Sybase, H2...).

💡 Dans le cas d'une requête SQL simple, vous pouvez utiliser l'assistant base de données qui ne nécessite pas de connaissance particulière dans la rédaction de requêtes SQL. Consultez le paragraphe Se connecter à une base de données SQL via l'assistant.

Pour vous connecter à une base de données SQL :

  1.  Dans la boite Création d'un nouveau modèle de données, cliquez sur le bouton DB (SQL) de la section Base de données.
    Bouton_SQL
    ➡ La boîte de dialogue Charger les données à partir d'une base de données s'affiche.Boite_SQL
  2.  Sélectionnez tout d'abord le mode de connexion souhaité :
  • Mode Connexion manuelle
    La connexion sera visible dans la source de données uniquement

    1. Dans le champ URL de la base données:
      • Sélectionnez le pilote JDBC dans la liste déroulante : Oracle, SQL Server, MySQL,
      • Saisissez l'adresse de votre base de données en utilisant la syntaxe requise par le pilote.
        Exemple de syntaxe utilisée pour mysql :
        jdbc:mysql://[host][,failoverhost...][:port]/[database][?propertyName1][=propertyValue1][&propertyName2][=propertyValue2]...

        (le numéro de port par défaut étant 3306).
    2. Dans le champ Utilisateur, entrez le nom de l'utilisateur à utiliser lors de la connexion à la base de données.
    3. Dans le champ Mot de passe, entrez le mot de passe à utiliser lors de la connexion à la base de données.
    4. Cliquez sur Connexion pour obtenir le statut de la connexion (connexion réussie ou échec de la connexion). En cas d'échec, modifier les paramètres de connexion.
       
  • Mode Connexion nommée
    La connexion sera visible dans le gestionnaire de connexions aux bases de données et utilisable par l'ensemble des sources de données. 
    1. Cliquez sur Sélectionner : le Gestionnaire des connexions aux bases de données s'affiche.
    2. Vous pouvez :
      • Sélectionner une connexion existante dans la liste. Cliquez alors sur OK.
      • Créer une nouvelle connexion comme décrit sur la page Ajouter une connexion nommée.
  1. Dans le champ Requête SQL, renseignez la requête SQL manuellement ou via l'assistant SQL. Consultez la page Rédaction de la requête SQL pour plus de détails . 
  2. Cliquez sur le bouton Prévisualisation pour afficher un aperçu du résultat.
    Consultez la page Configurer la source de données pour plus de détails sur les propriétés des colonnes.
  3. Une fois le résultat satisfaisant, cliquez sur Suivant pour configurer le modèle de données.

Vous pouvez sauvegarder la requête saisie pour une utilisation ultérieure. Pour cela :

  1. Cliquez sur le bouton Favoris en dessous de votre requête SQL.
  2. Sélectionnez Ajouter aux favoris puis saisissez le nom que vous souhaitez donner à cette requête. 

Se connecter à une base de données SQL via l'assistant

Pour vous connecter à une base de données SQL via l'assistant :

  1. Dans la boite Création d'un nouveau modèle de données, cliquez sur le bouton DB (Assistant) de la section Base de données.
    Bouton_assistant_DB
    ➡ La boîte de dialogue Base de données s'affiche.
  2. Sélectionnez une base de données dans la liste déroulante Connexion ou cliquez sur le bouton Sélectionner pour en créer une nouvelle dans le Gestionnaire des connexions aux bases de données. Consultez la page Ajouter une connexion nommée pour plus de détails.
  3. Dans l'onglet Requête, créez une requête via l'Assistant :
    • Cochez la table à utiliser dans le panneau de gauche.
      ➡ Les colonnes correspondantes s'affichent dans le panneau droite.
    • Vous pouvez retirer des colonnes en décochant les cases correspondantes.
    • Vous pouvez définir des règles sur des colonnes : sélectionnez la colonne puis cliquez sur le bouton Bouton_reglesen haut à droite des colonnes et définissez la règle. La règle est ajoutée dans le tableau en-dessous des colonnes.
      Requête_assistant
  4. Dans l'onglet Résultat, prévisualisez le résultat de la requête définie. Consultez la page Configurer la source de données pour plus de détails sur les propriétés des colonnes.
  5. Une fois le résultat satisfaisant, cliquez sur Suivant pour configurer le modèle de données.