Créer une connexion JDBC

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 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 d’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, SQLServer 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 de concepteur d’activité et prennent en charge le stockage des informations d’identification externe, tel 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 qui sont 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.
      Informations d'identification Tout Ajouter 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 d'expiration de requête Tout Durée maximale écoulée pendant laquelle 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 une connexion JDBC réussie. Si aucune connexion réussie n'a lieu pendant cette durée, la demande de connexion expire. Laissez ce champ vide pour utiliser la valeur de délai de connexion par défaut du système.
      Actif Tout Cochez la case pour en faire une connexion active.
      Domaine Tout Domaine de 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. 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 chargeant le fichier JAR du pilote JDBC approprié dans 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 L’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 l’URL de connexion manuellement afin que le serveur MID sache comment créer 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 charger le fichier JAR du pilote dans l’instance.
      Utiliser un MID Server Tout Cochez cette case pour utiliser un MID Server pour cette action ou cette 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 un serveur MID : sélectionne automatiquement le 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 un 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.
      Aptitudes 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 celle qui Serveur MID est sélectionnée lors de l’exécution. Pour en savoir plus sur la façon dont un est sélectionné pendant l’exécution, reportez-vous à la section Sélection d’unServeur MID serveur MID. Ce champ n’est visible que lorsque l’option Sélectionner automatiquement le 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 MID Server est sélectionnée.

      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 Sélection de MID.
      Grappe MID Tout La grappe MID spécifique que vous souhaitez utiliser. Ce champ est disponible lorsque l’option Utiliser un serveur MID est cochée et qu’une grappe MID spécifique est sélectionnée dans la liste Sélection MID.
    3. Cliquez sur Envoyer.