Source de données de type JDBC

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 8 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 (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 la base de données.

    Remarque :
    Les appels JDBC provenant du serveur MID ne sont jamais chiffrés. Limiter les droits dont dispose 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
    Serveur Microsoft SQL 1433
    Oracle 1521
    Remarque :
    Les champs Oracle DATE sont chargés en tant que champs Date/heure ServiceNow.

    Source de données JDBC Exigences de l’instruction SQL

    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 de service de serveur MID. Pour que ce champ apparaisse sur le formulaire Source de données, l’intégration doit répondre à ces critères :

    • 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 celles requises par SQL Server.
    • Le type de source de données est JDBC.
    • La case à cocher Utiliser un serveur MID de la source de données est sélectionné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 les 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 base de données sur la source de données JDBC est sensible à la casse pour SQL Server.

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

    Utilisez la procédure suivante pour étendre la source de données afin qu’elle utilise un pilote pour une base de données qui n’est pas fournie dans le système de base. 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 la 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 trouver des exemples.
      • Table : sys_data_source
      • Étiquette : Nom de base de données qui apparaît en tant qu’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 pilote 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 format 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 au serveur MID > aux 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 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 Tous > Ensembles de données système à importer > 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. Configuration de la mise en page du formulaire et ajout du 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

    Créer un alias de connexion d’importation

    Créez un alias de connexion d’importation pour les enregistrements de source de données de type JDBC .

    Avant de commencer

    Rôle requis : import_admin

    Procédure

    1. Accédez à la Tous > Ensembles de données système à importer > Administration > Importez des alias de connexion..
    2. Sélectionnez Nouveau.
    3. Nommez l’alias.
    4. Sélectionnez le nom de l’alias pour ouvrir la page des connexions JDBC.
    5. Sur la page des connexions JDBC, sélectionnez Nouveau
    6. Remplissez le formulaire.
      Champ Description
      Nom Nom unique pour cette connexion JDBC.
      Utiliser un Serveur MID Serveur MID à utiliser pour se connecter à cette source de données.
      Format Sélectionnez l’un des formats suivants : MySQL, Oracle ou SQL Server.
      Nom d'instance Utilisé pour prendre en charge la connectivité de port dynamique avec SQL Server. Pour garantir la connectivité, fournissez le nom d’instance d’un serveur SQL qui reçoit un nouveau numéro de port dynamiquement après chaque redémarrage. Ce champ n’apparaît que lorsque SQLServer est sélectionné comme format de source de données.
      Serveur Nom du serveur à partir duquel les tables seront importées.
      Nom de base de données Nom de l’instance de base de données.
      Port de la base de données Numéro de port pour la base de données. Laissez ce champ vide lors de l’utilisation de la connectivité de port dynamique avec SQL Server.
      Utiliser l’authentification intégrée Sélectionnez cette option pour permettre à la connexion JDBC d’utiliser l’ID de l’utilisateur configuré pour le service Serveur MID Windows pour l’authentification SQL Server. Pour plus d’informations, reportez-vous à la section Source de données de type JDBC.
      Paramètres de l’URL de connexion Paramètres facultatifs à ajouter à la fin de l’URL générée pour cette source de données. Liste de paramètres séparés par des points-virgules.
      Paramètres de l’URL de connexion Paramètres facultatifs à ajouter à la fin de l’URL générée pour cette source de données. Liste de paramètres séparés par des points-virgules.
      URL de connexion Champ en lecture seule généré automatiquement par le système. Pour définir manuellement l’URL de connexion, sélectionnez l’option Définir manuellement l’URL de connexion .
      Définir manuellement l’URL de connexion Option permettant de définir manuellement l’URL de connexion.
      Importer l’alias de connexion Alias de connexion d’importation associé à la connexion JDBC.
      Utiliser le nom d’utilisateur et le mot de passe pour s’authentifier Option permettant de fournir le nom d’utilisateur et le mot de passe pour l’authentification.

      Lorsque cette option est désactivée, les propriétés de connexion sont utilisées pour l’authentification.
      Nom d'utilisateur Nom d’utilisateur pour l’authentification sur le serveur JDBC.
      Mot de passe Mot de passe pour l’authentification sur le serveur JDBC.
      Délai de connexion Nombre de secondes avant que le pool de cache de connexion du serveur MID ne se ferme et ne le retire du pool. Zéro (0) signifie qu’il n’y a pas de délai d’expiration.
      Délai d’expiration de requête Nombre de secondes pendant lesquelles le pilote JDBC attend l’achèvement d’une requête (SELECT). Zéro (0) signifie qu’il n’y a pas de délai d’expiration. En cas de dépassement du délai d’expiration, l’intégration considère que le résultat JDBC est inaccessible et lui affecte un état d’erreur
    7. Sélectionnez Soumettre.