Source de données de type JDBC

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 à partir de l’instance ServiceNow (configuration VPN requise), soit via un MID Server 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 MID Server ne sont jamais chiffrés. Limitez les droits disponibles pour l’utilisateur du MID Server lorsqu’il passe des appels JDBC à partir d’un MID Server.

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 bases 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 DATE Oracle sont chargés en tant que champs Date/heure ServiceNow.

Exigences relatives aux instructions SQL de 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 de SQL Server pour Windows

Une source de données JDBC peut utiliser l’ID de l’utilisateur du service Windows MID Server pour s’authentifier 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 MID Server 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 la source de données 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

Remarque :

Le champ Dernière base de données exécutée 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

Utilisez la procédure suivante 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. 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 de pilote JDBC disponibles 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 au champ Format de la sys_data_source table.

Procédure

1. Accédez aux jeux 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 Formater et sélectionnez Afficher la liste de choix dans le menu contextuel.

   

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 en tant qu’option dans la liste de choix 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 du pilote doivent être fournis par le fournisseur du pilote. Ces informations sont souvent disponibles dans la documentation du fournisseur, par exemple pour MariaDB ou Teradata.
   • Valeur dépendante : 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 de pilote JDBC disponibles 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 MID Server. Cette procédure suppose que vous utilisez les pilotes Sybase ou DB2 suivants :

Tableau 2. Pilotes

Format	Pilote	Classe du conducteur
Sybase	jconnect-jdbc	com.sybase.jdbc3.jdbc.SybDriver
DB2	db2jcc	com.ibm.db2.jcc.DB2Driver

Si vous utilisez une autre implémentation du pilote Sybase ou DB2, vous devez modifier le choix Valeur pour utiliser la classe de pilote de votre implémentation de pilote.

Procédure

1. Accédez aux jeux 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 à 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 aux 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 : un 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 sa fonction dans l’instance.
4. Cliquez sur l’icône du trombone dans la bannière et joignez le fichier JAR à l’enregistrement.

   

5. Cliquez sur Envoyer.
6. Redémarrez le service MID Server.

   La plate-forme met le fichier JAR à la disposition de n’importe quel MID Server 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 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 .

   

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.