Créer une connexion JDBC

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 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 Tout > Informations d'identification et connexions > Connexions, cliquez sur Nouveau et sélectionnez Connexion JDBC.
    2. Remplissez le formulaire à l'aide des 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 Tout Nom unique de cette connexion JDBC. Par exemple, vous pouvez entrer JDBC MySQLProd.
      Information d'identification Tout Ajoutez des informations d’identification pour le fournisseur JDBC.
      Alias de connexion Tout 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 de requête Tout Temps écoulé maximal pendant lequel la requête JDBC est autorisée à s’exécuter sans réponse.
      Délai de connexion Tout

      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 n'a lieu pendant cette durée, la demande de connexion expire. Si une connexion réussie se produit, la connexion reste ouverte jusqu’à 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’obsolescence de la connexion.
      Actif Tout Cochez la case pour activer cette connexion.
      Domaine Tout Domaine pour cette table. Par défaut, la table Connexion JDBC [jdbc_connection] s’exécute dans le domaine global .
      Format Tout Type de base de données pour cette connexion. Par défaut, les choix possibles 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 utilisé par la base de données sélectionnée.
      Nom d'instance SQL Server Nom d’instance pour le SQL Server sélectionné
      URL de connexion Tout 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 Universal, 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 entrer le nom du pilote dans ce champ et télécharger le fichier JAR du pilote sur l’instance.
      Utiliser un Serveur MID Tout Cocher pour 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 Tout Option permettant de sélectionner le serveur MID ou la grappe MID spécifique.
      • Sélectionner automatiquement Serveur MID : sélectionne automatiquement Serveur MID.
      • Serveur MID spécifique : utilise le serveur MID que vous sélectionnez.
      • Grappe MID spécifique : utilise la grappe MID que vous sélectionnez.
      Ce champ est disponible lorsque l’option Utiliser Serveur MID est cochée.
      Remarque :
      Assurez-vous que l’enregistrement de Hub d'intégration connexion est référencé, et non un enregistrement de Orchestration connexion.
      Options Tout

      Options que Serveur MID doit prendre en charge pour être éligible à 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 MID Server 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 Tout

      Application que Serveur MID doit prendre 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, puis l’option Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID.

      Pour en savoir plus sur la façon dont un Serveur MID est sélectionné pendant l'exécution, consultez MID Server selection.

      Serveur MID Tout Spécifique Serveur MID sur lequel l’étape s’exécute. Ce champ n’est visible que lorsqu’un Serveur MID spécifique est sélectionné dans la liste de sélection MID.
      Grappe MID Tout Grappe MID spécifique que vous souhaitez utiliser. Ce champ est disponible lorsque l’option Utiliser Serveur MID est cochée et qu’une grappe MID spécifique est sélectionnée dans la liste de sélection MID.
    3. Cliquez sur Envoyer.