Créer une connexion JDBC

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 5 minutes de lecture
  • La connexion JDBC fournit les informations que les actions ou activités JDBC personnalisées utilisent pour se connecter à diverses bases de données cibles.

    Avant de commencer

    Vous devez disposer d’un fichier JAR approprié, qu’il soit fourni avec l’instance ou dans un fichier JAR personnalisé.
    Remarque :
    L’instance ServiceNow fournit des fichiers mysql-connector-java-5.1.21.jar, sql-server-jdbc-4.0.jar et ojdbc6.jar dans le cadre de la version actuelle, qui prend en charge les bases de données MySQL, SQL Server et Oracle. D’autres bases de données, telles que Sybase ou DB2 Universal, doivent utiliser un fichier JAR personnalisé qui doit être téléchargé sur l’instance avant de définir la connexion JDBC.

    Rôle requis : connection_admin

    Pourquoi et quand exécuter cette tâche

    Les informations d’identification JDBC sont récupérées séparément par le modèle du concepteur d’activité et prennent en charge le stockage des informations d’identification externes, telles que CyberArk.

    Procédure

    1. Accédez à la Tous > Informations d’identification et connexions > Connexions, cliquez sur Nouveau et sélectionnez Connexion JDBC.
    2. Remplissez le formulaire en utilisant les champs de la table.
      La sélection de base de données dans le champ Format détermine les champs disponibles.
      Tableau 1. Champs de connexion JDBC
      Champ Format de base de données Description
      Nom Tous Nom unique de cette connexion JDBC. Par exemple, vous pouvez entrer JDBC MySQLProd.
      Informations d'identification Tous Ajoutez des informations d’identification pour le fournisseur JDBC.
      Alias de connexion Tous Sélectionnez l’enregistrement d’alias à associer à cette connexion. L’utilisation d’un alias vous permet de mettre à jour l’enregistrement de connexion sans avoir à reconfigurer les actions ou les activités qui utilisent l’alias.
      Délai d’expiration de requête Tous Durée maximale écoulée pendant laquelle la requête JDBC est autorisée à s’exécuter sans réponse.
      Délai de connexion Tous

      Nombre de secondes pendant lesquelles le système attend avant de fermer une connexion JDBC ou une demande de connexion.

      Par exemple, si la valeur du délai de connexion est de 10 secondes, le système attend 10 secondes pour que la connexion aboutisse. Si aucune connexion réussie ne se produit pendant ce temps, la demande de connexion expire. Si une connexion réussie, la connexion reste ouverte jusqu’à ce qu’il y ait une période d’inactivité de 10 secondes. Une fois que la connexion a été inactive pendant 10 secondes, la connexion est fermée.

      Remarque :
      Évitez de définir la valeur du délai de connexion sur zéro, car cela pourrait entraîner l’expiration de la connexion.
      Actives Tous Cochez la case pour activer cette connexion.
      Domaine Tous Domaine de cette table. Par défaut, la table Connexion JDBC [jdbc_connection] s’exécute dans le domaine global .
      Format Tous Type de base de données pour cette connexion. Les choix par défaut sont les suivants :
      • MySQL
      • Oracle
      • SQL Server
      • Aucun
      Vous pouvez ajouter Sybase ou DB2 Universal à la liste de choix en téléchargeant le fichier JAR du pilote JDBC approprié sur l’instance. Orchestration reconnaît automatiquement ces pilotes lorsqu’ils sont chargés dans le système et les ajoute à cette liste.
      Hôte Oracle, MySQL, SQL Server Nom d’hôte ou adresse IP du serveur de base de données.
      SID Oracle Oracle Identificateur de site de base de données Oracle. La valeur par défaut est orcl.
      Port Oracle Oracle Port utilisé par la base de données Oracle. La valeur par défaut est 1521.
      Nom de base de données MySQL, SQL Server Nom de la base de données.
      Port MySQL, SQL Server Port que la base de données sélectionnée utilise.
      Nom d'instance SQL Server Nom d’instance pour le SQL Server sélectionné
      URL de connexion Tous URL que le serveur MID utilise pour se connecter à la base de données spécifiée. L’URL est créée automatiquement lorsque vous enregistrez le formulaire et est en lecture seule pour les bases de données par défaut.
      Remarque :
      Si le format sélectionné n’est pas l’une des bases de données par défaut, vous devez créer manuellement l’URL de connexion afin que le serveur MID sache comment établir la connexion.
      Pilote JDBC Aucun, DB2 universel, Sybase Pilote JDBC à utiliser pour cette connexion lorsqu’il ne s’agit pas d’une base de données par défaut.
      Remarque :
      Si vous ajoutez une base de données Sybase ou DB2 Universal, vous devez saisir le nom du pilote dans ce champ et télécharger le fichier JAR du pilote dans l’instance.
      Utiliser un serveur MID Tous Choisissez d’utiliser un Serveur MID pour cette action ou activité. Si cette option est sélectionnée, définissez les champs dans la section Configuration avancée de Serveur MID .
      Sélection de MID Tous Option permettant de sélectionner un serveur MID ou une grappe MID spécifique. Choisissez l’une des options suivantes.
      • Sélection automatique d’un serveur MID : votre ServiceNow instance sélectionne l’sans Serveur MID entrée manuelle.
      • Serveur MID spécifique : votre ServiceNow instance utilise ce Serveur MID que vous spécifiez.
      • Grappe MID spécifique : votre ServiceNow instance utilise la grappe MID que vous spécifiez.

        Une grappe MID est un groupe de serveurs MID qui permet à votre ServiceNow instance de gérer plusieurs intégrations et d’améliorer la vitesse d’intégration. Pour plus d'informations, consultez Configure a MID Server cluster.

      Ce champ est disponible lorsque l’option Utiliser serveur MID est cochée.
      Remarque :
      Assurez-vous que l’enregistrement de Centre d'intégration connexion est référencé, et non un enregistrement de Orchestration connexion.
      Options Tous

      Les options doivent prendre Serveur MID en charge pour être éligibles à la sélection. Le système exécute l’action ou l’activité à partir d’un Serveur MID qui prend en charge les options sélectionnées. S’affiche uniquement si l’option Utiliser un serveur MID est sélectionnée.

      Les options requises déterminent celles qui Serveur MID sont sélectionnées lors de l’exécution. Pour en savoir plus sur la façon dont a Serveur MID est sélectionné pendant l’exécution, voir Sélection du serveur MID. Ce champ n’est visible que lorsque l’option Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID.

      Application MID Tous

      La demande doit Serveur MID être prise en charge pour être éligible à la sélection. Le système exécute l’action à partir d’un Serveur MID qui prend en charge l’application sélectionnée. S’affiche uniquement si l’option Utiliser un serveur MID est sélectionnée.

      Pour en savoir plus sur la sélection de a pendant l’exécution Serveur MID , reportez-vous à la section MID Server selection.

      Serveur MID Tous Spécifique Serveur MID sur lequel l’étape s’exécute. Ce champ n’est visible que si le serveur MID spécifique est sélectionné dans la liste Sélection MID.
      Grappe MID Tous Grappe MID spécifique que vous souhaitez utiliser. Ce champ est disponible lorsque l’option Utiliser serveur MID est sélectionnée et que la grappe MID spécifique est sélectionnée dans la liste de sélection MID.
    3. Cliquez sur Envoyer.