Passer au contenu principal

logoCorrectSize.png

Workday Adaptive Planning Knowledge Center

Configurer une source de données de base de données JDBC

Vous pouvez utiliser Adaptive Insights Integration pour extraire des informations depuis des bases de données compatibles à JDBC. La plupart des bases de données utilisées pour les applications comptables et financières sont compatibles à JDBC (connectivité à la base de données Java ). JDBC est une norme qui utilise le langage de programmation Java pour fournir la connectivité à un large éventail de bases de données.

 

Une source de données de base de données compatible à JDBC nécessite un pilote.  Le tableau ci-dessous donne des informations sur les pilotes JDBC courants.

 

Source JDBC

Aperçu

Fournisseur Jar

Classe de pilote

JDBC/Exemple d’URL

JDBC
Informations URL

Oracle

Introduction à la base de données Oracle

ojdbc6-11.2.0.3.jar

oracle.jdbc.
OracleDriver

jdbc:oracle: thin:@jyates-win-db: 1521:ANACONDA

Classe Ora­cleDriver

SQL Server

Microsoft SQL Server

jtds-1.3.1.jar

voir Sécurité intégrée pour Sources de données JDBC pour les détails sur l’emplacement des dll 

net.sourceforge
.jtds.jdbc.Driver

jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE; instance=
SQLEXPRESS

For­mats jTDS

MySql

MySQL Manuels­ de référence

mysql-connector-5.1.17.jar

com.mysql.jdbc
.Driver

jdbc:mysql://localhost: 3306/AGENT_TEST

Syn­taxe d’URL

h2

H2 Moteur de base de données

Look for h2*.jar in the Adaptive Data Agent Service Manager distribu­tion.

org.h2.Driver

jdbc:h2:/data/test

 

Antisèche H2

Les fichiers JAR vont dans le répertoire C:/Program Files/Adaptive Data Agent/Plugins sur la machine hébergeant le service Agent de données Adaptive. Après avoir ajouté un fichier JAR, vous devez vous rendre dans les services locaux et redémarrer le service Agent de données Adaptive .

Avant de pouvoir configurer une source de données à partir d’une base de données locale, vous devez avoir un Agent de données Adaptive créé qui indique à Adaptive Insights Integration comment  commu­niquer avec la base de données. Pour plus d’informations sur la création d’agents de données, voir  Utilisation Adaptive Agents de données.

Pour configurer une source de données de base de données JDBC, procédez comme suit :

  1. Accédez au concepteur de données en accédant à Intégration > Concepteur de données.

  2. À partir du dossier Source de données dans la bibliothèque des composants, située à droite de l’écran, cliquez sur Créer une nouvelle source de données.
    La boîte de dialogue Créer un nouveau apparaît.

  3. Sélectionnez la JDBC base de données comme type de source de données, entrez le nom de la base de données et sélectionnez l’agent que vous souhaitez utiliser pour cette source de données.

  4. Cliquez sur Créer.
    La zone centrale de l’écran affiche les paramètres de votre nouvelle source de données ainsi que d’autres informations, comme illustré ci-dessous.

  5. Entrez les informations de la source de données :

  • Classe de pilote: Entrez la classe de pilote pour la base de données. (Vous pouvez obtenir cette infor­mation auprès du fournisseur de base de données.)
  • URL: Saisissez l’URL de la base de données.
  • Nom d’utilisateur: Saisissez le nom d’utilisateur utilisé pour accéder à la base de données.
  • Mot de passe: Saisissez le mot de passe associé au nom d’utilisateur.
  • Filtre de schéma : Saisissez le nom du ou des schémas à partir desquels vous souhaitez importer des données. Si vous saisissez les noms de plusieurs schémas, saisissez les noms de schémas séparés par un point-virgule. Utilisez ce champ pour limiter le nombre de tables devant être actualisées dans Adaptive Insights Integration. Ce champ est facultatif.
  • Niveau de journal :  sélectionnez un niveau de journal dans la liste déroulante pour spécifier les détails de la journalisation pour cette source de données. Vos options sont :
    • Erreur : Consigne uniquement les erreurs graves.
    • Info : Consigne toutes les informations de base, telles que la date à laquelle la source de données a été mise à jour.
    • Verbeux :  fournit des informations très détaillées sur toutes les phases et actions. (Ce niveau est principalement utilisé pour le débogage ou l’audit, car il peut produire plus d’informations de journal que nécessaire, pour une utilisation normale.)
  1. Cliquez sur Enregistrer dans le menu Actions.

Vous pouvez tester les informations de connexion dans la nouvelle source de données en cliquant sur Tester la conne­xion dans le menu Actions. Le système tente de se connecter à la base de données en utilisant les informa­tions des champs de la source de données. Si le système peut se connecter à la base de données, cliquez sur OK. En cas de problèmes de connexion, corrigez les erreurs et réessayez.

Lorsque vous pouvez vous connecter à la base de données, vous êtes prêt à importer la structure de données. Cela vous montre les tables et colonnes dans la base de données.

Seules les colonnes pour les types pris en charge apparaissent. “Types de co­lonne pris en charge,” répertorie les types de colonnes pris en charge pour les différents types de bases de données.

Pour importer la structure de la base de données JDBC, procédez comme suit :

  1. Cliquez sur Importer la structure dans le menu Actions. Les tableaux et colonnes apparaissent dans le menu Composants de données.

Les modes d’importation de données affectent la manière dont les données sont synchronisées. Le mode d’importation par défaut (tous les enregistrements remplacés) pour une source de données JDBC est le suivant :

  1. Toutes les lignes de stockage sont effacées.

  2. Les données JDBC sont importées.

  3. Les données de la source JDBC  renseignent la table de stockage.

  4. S’il existe un filtre SQL personnalisé, il est appliqué aux données à importer à partir du serveur de base de­données pour déterminer le sous-ensemble de données à importer.

Vous pouvez également choisir d’ajouter des informations importées, auquel cas les données importées sont ajoutées à la table de stockage existante, ou fusionner des informations importées, auquel cas les lignes existantes dans les données JDBC sont fusionnées avec les lignes dans la zone de stockage.

Ajout de tables à une source de données JDBC

Après avoir importé la structure de la base données, vous êtes prêt à spécifier les informations que vous souhaitez importer depuis la base de données. La section Tables à importer de l’écran vous permet de configurer les données importées de la base de données.

Pour spécifier les tables à importer de la base de données, procédez comme suit :

  1. Développer l’entrée de la source de données dans le menu Composants de données comme illustré ci-dessous.

  2. Chaque table de la base de données apparaît comme un élément distinct.

  1. Faites glisser et déposez les tables que vous souhaitez importer dans la section Tables à importer au centre de l’écran, comme illustré ci-dessous. Lorsque vous faites glisser chaque table vers la section Tables à importer , un onglet apparaît pour la table et les informations de la base de données apparaissent dans la section Tables à importer , ce qui vous permet de voir le type d’information que vous avez ajoutées. (Plusieurs exemples de table apparaissent ci-dessous.) Chaque onglet de la table a également un menu déroulant, auquel vous pouvez accéder en cliquant sur la flèche à côté de son nom.

 

Gestion des colonnes

Si une table avec lequel vous travaillez comporte un grand nombre de colonnes, vous pouvez utiliser Gérer les colonnes pour effectuer des modifications rapides concernant quelles les colonnes doivent être importées. La boîte de dialogue Gérer les colonnes affiche les colonnes d’une table afin que vous puissiez cocher ou décocher les colonnes pour l’importation.

Pour gérer les colonnes à importer, procédez comme suit :

  1. Cliquez sur la flèche sur l'onglet situé à droite du nom de la table.
    Un menu flottant comportant plusieurs options apparaît.

  2. Cliquez surGérer les colonnesdans le menu flottant.
    La boîte de dialogue Gérer les colonnes s’affiche.

 3. Cochez la case à côté d’une colonne pour l’importer. Lorsque vous cochez une colonne, la colonne apparaît également dans la fenêtre d’aperçu une fois que le contenu contextuel est sauvegardé. Décocher une colonne supprime la colonne de la fenêtre d’aperçu.

Vous ne pouvez pas modifier le statut d’importation sur des champs générés par le système, tels que isDe­leted. Vous pouvez également modifier le statut d’importation de colonnes individuelles en sélectionnant les propriétés de co­lonne et en définissant la propriété ou en faisant glisser et en déposant les colonnes dans le concepteur.

Personnalisation des tables

Pour chaque table, vous pouvez personnaliser la manière dont les données sont importées.

Pour personnaliser les paramètres de table, procédez comme suit :

  1. Cliquez sur la flèche sur l'onglet situé à droite du nom de la table.
    Un menu flottant comportant plusieurs options apparaît.

  2. Cliquez sur Paramètres de table dans le menu flottant.
    La boîte de dialogue Paramètres de la table s’affiche, comme illustré ci-dessous.

 3. Saisissez les paramètres de la table :

  • Mode d'importation des données: Sélectionnez l’une des options dans la liste déroulante.
    • Tous les enregistrements sont remplacés à chaque exécution d'une importation de données
      Il s’agit de la valeur par défaut. Remplace les données dans la table de stockage par les données importées de la source.
    • Cache distant utilisé pour identifier et envoyer les enregistrements modifiés dans l'importation
      Seuls les enregistrements de base de données qui ont changé ou sont nouveaux sont importés. Les enregistrements modifiés écrasent les enregistrements existants dans la zone de stockage. De nouveaux enregistrements sont ajoutés à la fin des informations dans la zone de stockage.
    • Tous les enregistrements qui rentrent dans la période transmise
      Tous les enregistrements de la période que vous spécifiez sont importés. Les enregistrements dans la table de stockage correspondant aux périodes importées sont supprimés avant d’ importer les dernières données de la source.
  • Filtre d'importation des données: Utilisez cette option pour saisir une expression SQL qui filtre ou formate les informations en cours d’importation. Le filtre SQL est appliqué avant que les données ne soient extraites de la base de données afin de réduire la quantité de données devant être importées, ce qui vous donne un niveau de contrôle supplémentaire concernant quelles données sont introduites dans la zone de stockage. Cliquez sur le champ pour afficher la boîte de dialogue Modifier le filtre SQL, montrée précédemment. (Le filtre que vous saisissez ici est appliqué aux données réelles de la base de données plutôt qu’aux données de prévisualisation dans la zone de stockage.) Toutes les sources de données ne prennent pas en charge le même niveau de capacité de fil­trage SQL.
  1. Cliquez sur Appliquer pour appliquer les paramètres.
  2. Répétez les étapes 1 à 3 pour chaque table.

Si une table de base de données comporte des clés définies, ces informations sont également intégrées dans la table de stockage.. Vous pouvez passer en revue ces informations et modifier si nécessaire.

  1. Cliquez sur Enregistrer pour enregistrer les paramètres dans la source de données.

Paramétrage des options de colonne

Lors de l’utilisation de la section Tables à importer , vous pouvez voir un aperçu des données telles qu’elles se trouvent dans la source de données ou dans la zone de stockage après qu’elles aient été importées. Vous pouvez modifier les options de chaque colonne en passant la souris sur son titre, puis en cliquant sur le menu déroulant à côté de son nom. Ces options sont :

  • Trier dans l’ordre croissant: Triez la table entière en fonction de cette colonne dans l’ordre croissant.
  • Trier dans l’ordre décroissant: Triez la table entière en fonction de cette colonne dans l’ordre décroissant.
  • Paramètres de colonne : Cette boîte de dialogue permet de modifier les propriétés de la colonne dans la table de stockage.
    • Nom : Nom de la colonne, affiché dans l’en-tête.
    • Type de colonne : Type de données utilisées dans la colonne.
    • Convertir le type de colonne : Sélectionnez le nouveau type dans ce menu déroulant.
  • Exclure la colonne de l’importation : Sélectionnez cette option pour supprimer cette colonne des données importées.
  • Supprimer la colonne personnalisée : Sélectionnez cette option pour supprimer la colonne. (Disponible pour les co­lonnes personnalisées uniquement.)

Téléchargement des données d’une table de stockage

Vous pouvez télécharger des données à partir d’une table de stockage unique.

Pour télécharger des données à partir d’une table de stockage unique, procédez comme suit :

  1. Cliquez sur la flèche bas dans une en-tête de table dans la section Tables à importer.

  2. Sélectionnez Télécharger les données.

  3. À l’invite “Cette opération enverra un courriel avec une URL pour télécharger les données,” cliquez sur Envoyer. Adaptive Insights Integration envoie alors un courriel contenant une URL, à l’adresse de messagerie associée au concepteur de données.

  4. Ouvrez le courriel et cliquez sur l’URL. Les données sont téléchargées au format.csv.

Utilisation du filtre avancé

Sous le menu déroulant Source , vous pouvez cliquer sur Filtre avancé pour révéler des options pour fil­trer les données dans la zone de prévisualisation Tables à importer. Le filtre avancé fournit des outils pour afficher et parcourir un sous-ensemble de données dans une table de stockage ou directement depuis la source distante (si vous sélectionnez JDBC Base de données dans le menu déroulant Source). En modifiant les propriétés du fil­tre, vous pouvez modifier la vue des données affichées dans la fenêtre de prévisualisation sans mo­difier les données dans la zone de stockage.

La zone de prévisualisation est spécifiquement destinée à prévisualiser une petite partie des données de la zone de stockage (ou la base de données JDBC ). Vous pouvez explorer les données disponibles à partir de la source de données JDBC  et vérifiez que vous obtenez les données que vous attendez en examinant la zone de stockage. Vous pouvez également utiliser cela pour affiner le filtre d’importation de données que vous souhaitez utiliser. (Les filtres définis dans la fonction de pré­visualisation n’affectent pas les données réelles dans la zone de stockage.)

Les options du filtre avancé sont les suivantes :

  • Lignes distinctes : Cochez cette case pour masquer les lignes dupliquées.
  • Lignes max. : Limitez le nombre de lignes affichées dans la zone de prévisualisation en saisissant un nombre dans la zone de texte.
  • Colonnes : Cochez ou décochez les colonnes dans ce menu déroulant pour afficher ou masquer des colonnes.

Supprimer une colonne de cette liste ne supprime pas la colonne de la liste d’importation.

  • Filtre SQL: Cliquez sur la grande zone de texte pour afficher la boîte de dialogue Modifier le filtre SQL (montrée auparavant), où vous pouvez entrer un filtre SQL pour limiter les lignes prévisualisées. Cliquez sur Appliquer pour vérifier automatiquement la syntaxe SQL du filtre. (En cas d’erreur, l’erreur est indiquée dans l’expression.) L’expression que vous avez saisie apparaît dans le champ Filtre avancé . Pour obtenir une aide détaillée sur la syntaxe SQL, vous pouvez cliquer sur aide en ligne dans la section Notes.

Cliquez sur Supprimer le filtre (à côté du menu déroulant Source) pour effacer tous les para­mètres de filtre avancé.

Dans le cadre du processus de personnalisation de table, vous pouvez également créer des tables de jointure et des colonnes personnalisées à l’aide d’expressions SQL.

Importation de données d’une base de données JDBC

Lorsque vous avez configuré et enregistré votre source de données JDBC , vous pouvez importer des données.

Pour importer des données d’une base de données JDBC d, procédez comme suit :

  1. Cliquez sur Importer des données dans le menu Actions.
    Les données sélectionnées sont filtrées par des expressions SQL et chargées dans la zone de stockage. Vous pouvez prévisualiser les données dans la zone de stockage

Les informations restent dans la zone de stockage jusqu’à ce que vous les effaciez manuellement, ou jusqu’à ce qu’un chargement de données ultérieur les efface conformément au mode d’importation.

Pour effacer les données de la zone de stockage, procédez comme suit :

  1. Cliquez sur Effacer les tables de stockage  dans le menu Actions.
    La zone de stockage pour toutes les tables de la source de données est effacée.

Pour supprimer des caractères spécifiés des flux de texte d’entrée dans des sources de données JDBC  :

Se référer à Supprimer des caractères spécifiés des flux de texte d’entrée dans JDBC et Microsoft Dynamics GP  

Schémas exclus de sources de données JDBC

Les sources de données  JDBC qui se connectent à Oracle ou MS SQL Server excluent explicitement certains schémas qui ne sont pas liés aux données financières.

Schémas exclus de sources de données JDBC Oracle

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Schémas exclus de sources de données JBDC MS SQL Server

INFORMATION_SCHEMA, SYS

Conseils de dépannage

Il existe quelques problèmes relatifs aux sources de données que vous pouvez rencontrer avec des solutions qui ne sont pas immédiatement apparentes.

Lorsque vous importez la structure d’une base de données et que la base de données comporte plus de 1 000 tables, vous obtenez une erreur vous demandant de filtrer la liste de tables. Vous pouvez surmonter cette erreur en effectuant l'une des actions suivantes :

  • Modification de la source de données JDBC et saisie d’un filtre de schéma.
  • Modification des autorisations associées à l'identifiant de connexion que vous utilisez pour accéder au serveur, ainsi moins de tables sont accessibles pour cet identifiant de connexion.

Lorsque vous importez la structure d’une base de données Oracle, les schémas suivants ne sont pas importés comme partie de la structure : CTXSYS, MDSYS, SYSTEM, SYS, et XDB. Ce sont les schémas de systèmes Oracle et ne sont pas nécessaires à des fins d’intégration des données.

Lorsque vous importez la structure d’une base de données MS SQL, les schémas suivants ne sont pas importés comme partie de la structure : INFORMATION_SCHEMA et sys. Ce sont les schémas de systèmes MS SQL et ne sont pas nécessaires à des fins d’intégration des données.

  • Cet article vous a été utile ?