Source de données de type JDBC

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • Une source de données JDBC récupère ses données via un pilote JDBC, généralement un réseau de type 4.

    La connexion JDBC est disponible soit directement depuis l’instance ServiceNow (une configuration VPN requise), soit via un serveur MID dédié installé à l’intérieur de votre pare-feu qui peut accéder au port de base de données.

    Remarque :
    Les appels JDBC provenant du serveur MID ne sont jamais chiffrés. Limiter les droits disponibles à l’utilisateur du Serveur MID chaque fois qu’il effectue des appels JDBC à partir d’un Serveur MID.

    Formats de base de données pris en charge par la source de données JDBC

    Les sources de données JDBC prennent en charge plusieurs formats de base de données et ports.

    Tableau 1. Formats de base de données pris en charge
    Type de serveur SQL Port
    MySQL 3306
    Microsoft SQL Server 1433
    Oracle 1521
    Remarque :
    Les champs Oracle DATE sont chargés en tant que champs Date/Heure ServiceNow.

    Exigences relatives aux instructions SQL de la source de données JDBC

    Les requêtes JDBC qui exécutent des instructions SQL doivent spécifier un nom de colonne.

    Par exemple, cette requête spécifie le nom de colonne ServerID.
    SELECT DISTINCT 'server_name:' + CONVERT ( VARCHAR , lg .ResourceID ) AS 'ServerID' 
    ,LastHWScan
    ,Account0
    ,Category0
    Fromv_GS_WORKSTATION_STATUSsInner  JOIN
    v_GS_LocalGroupMembers0lg
    ON s .ResourceID  = lg .ResourceID
    WhereType0  = 'Local' AND Category0  = 'SystemAccount'

    Authentification intégrée SQL Server pour Windows

    Une source de données JDBC peut utiliser l’ID de pour que l’utilisateur du service Windows MID Server s’authentifie auprès de SQL Server.

    La case à cocher Utiliser l’authentification intégrée du formulaire Source de données détermine si la source de données JDBC utilise les informations d’identification de l’utilisateur du service de Serveur MID. Pour que ce champ apparaisse sur le formulaire Source de données, l’intégration doit répondre aux critères suivants :

    • Le Serveur MID doit être en cours d’exécution sur un ordinateur Windows avec SQL Server.
    • Le service Serveur MID doit utiliser les mêmes informations d’identification que SQL Server.
    • Le type de source de données est JDBC.
    • La source de données case Utiliser un serveur MID est cochée.
    • Le format de la source de données est SQLServer.
    Important :
    Si l’authentification intégrée est choisie et que vous intégrez avec Microsoft System Center Configuration Manager, le compte exécutant le service Serveur MID doit avoir des droits de lecture sur la base de données SCCM.
    Figure 1. Formulaire Source de données
    Formulaire Source de données
    Remarque :
    Le champ Dernière exécution de la source de données JDBC est sensible à la casse pour le serveur SQL.

    Ajout de pilotes JDBC pour les formats de base de données non pris en charge

    Pour étendre la source de données afin d’utiliser un pilote pour une base de données qui n’est pas fournie dans le système de base, procédez comme suit. Les connexions JDBC sont prises en charge pour les bases de données par défaut suivantes :

    Ajouter un nouveau choix de format JDBC

    Étendez les options disponibles du pilote JDBC en créant une nouvelle entrée de liste de choix pour spécifier le nom du package Java du pilote JDBC.

    Avant de commencer

    Rôle requis : import_admin

    Pourquoi et quand exécuter cette tâche

    Ajoutez une nouvelle entrée de liste de choix pour la nouvelle base de données dans le champ Format de la sys_data_source table.

    Procédure

    1. Accédez aux ensembles d’importation système > administration > sources de données.
    2. Cliquez sur Nouveau.
    3. Dans le formulaire Sources de données, cliquez avec le bouton droit sur l’étiquette du champ Format , puis sélectionnez Afficher une liste de choix dans le menu contextuel.
      Liste des sources JDBC
    4. Cliquez sur Nouveau dans la liste des choix.
    5. Fournissez les valeurs suivantes pour créer le nouveau choix de base de données.
      Regardez les pilotes existants pour des exemples.
      • Table: sys_data_source
      • Étiquette : Nom de la base de données qui apparaît comme option dans la liste de choix de format , par exemple : Teradata.
      • Valeur : nom du package et classe du pilote. Par exemple, la valeur de TeraData est com.ncr.teradata.TeraDriver.
        Remarque :
        Le package et la classe de pilotes doivent être fournis par le fournisseur de pilotes. Ces informations sont souvent disponibles dans la documentation du fournisseur, par exemple pour MariaDB ou Teradata.
      • Valeur dépendante : JDBC
      Liste de choix JDBC.
    6. Cliquez sur Envoyer.

      La nouvelle source de données apparaît maintenant dans la liste des formats JDBC disponibles.

    Ajouter des choix de formats JDBC Sybase ou DB2

    Étendez les options disponibles du pilote JDBC en activant les choix Sybase ou DB2.

    Avant de commencer

    Rôles requis : admin

    Important :
    Pour utiliser les pilotes JDBC Sybase ou DB2, vous devez installer manuellement le fichier JAR du pilote sur un serveur MID. Consultez KB0551236 pour plus d’informations.

    Pourquoi et quand exécuter cette tâche

    Activez les pilotes JDBC Sybase ou DB2 pour vous connecter à ces formats de base de données via un serveur MID. Cette procédure suppose que vous utilisez les pilotes Sybase ou DB2 suivants :
    Tableau 2. Pilotes
    Format Pilote Classe de pilote
    Sybase jconnect-jdbc com.sybase.jdbc3.jdbc.SybDriver
    DB2 db2jcc com.ibm.db2.jcc.DB2Driver

    Si vous utilisez une implémentation différente du pilote Sybase ou DB2, vous devez modifier la valeur de choix pour utiliser la classe de pilote de votre implémentation de pilote.

    Procédure

    1. Accédez aux ensembles d’importation système > administration > sources de données.
    2. Cliquez sur Nouveau.
    3. Dans le champ Type , sélectionnez JDBC.
    4. Cliquez avec le bouton droit sur l’étiquette du champ Format , puis sélectionnez Configurer les choix dans le menu contextuel.
    5. Déplacez les choix Sybase ou DB2 Universal de la colonne Disponible vers la colonne Sélectionné .
    6. Cliquez sur Enregistrer.

      La nouvelle source de données apparaît maintenant dans la liste des formats JDBC disponibles.

    Installer un pilote sur un serveur MID

    Vous pouvez installer un nouveau fichier JAR de pilote JDBC sur un serveur MID pour accéder à des formats de base de données qui ne sont pas pris en charge par défaut.

    Avant de commencer

    Rôle requis : agent_admin

    Procédure

    1. Accédez à Serveur MID > fichiers JAR.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs suivants :
      • Nom : nom unique et descriptif permettant d’identifier le fichier dans l’instance.
      • Version : numéro de version du fichier, le cas échéant.
      • Source : Emplacement du fichier JAR à des fins de référence. Les informations sources ne sont pas utilisées par le système.
      • Description : brève description du fichier JAR et de son objectif dans l’instance.
    4. Cliquez sur l’icône du presse-papier dans la bannière et joignez le fichier JAR à l’enregistrement.
      Joindre un fichier
    5. Cliquez sur Envoyer.
    6. Redémarrez le service Serveur MID.

      La plateforme met le fichier JAR à la disposition de tout serveur MID configuré pour communiquer avec l’instance.

    Créer une nouvelle source de données JDBC pour un format de base de données non pris en charge

    Ajoutez une nouvelle source de données JDBC en définissant un enregistrement de source de données.

    Avant de commencer

    Rôle requis : import_admin

    Procédure

    1. Accédez à la Tout > Ensembles de données à importations système > Administration > Sources de données et cliquez sur Nouveau.
    2. Dans le formulaire Source de données, sélectionnez JDBC dans la liste du champ Type .
    3. Sélectionnez la nouvelle source de données dans la liste de choix du champ Format .
      Source de données JDBC
    4. Configurer la mise en page du formulaire et ajouter le champ URL de connexion .
    5. Fournissez l’URL de connexion à la source de données JDBC, puis cliquez sur Soumettre.

      Aucune autre information de connexion n’est requise.

      Source de données JDBC