Étape JDBC

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Créez une action réutilisable pour envoyer des commandes SQL à une base de données relationnelle.

    Remarque :
    • Cette étape nécessite un abonnement Hub d'intégration. Pour plus d’informations, voir Calendriers juridiques : Hub d'intégration présentation. Une fois le module d’extension requis activé, l’étape est visible sous Intégrations.
    • Le s’exécute Étape JDBC uniquement sur un avec Étape JDBC des ServiceNow® Serveur MID capacités. Activez le module d’extension, Hub d'intégration le programme d’installation de pack standard (com.glide.hub.integrations.standard) ou une version ultérieure pour utiliser l’aptitude JDBC pour le Serveur MID.

    Rôles et disponibilité

    Le Étape JDBC est disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.

    Entrées d’assainissement

    Échappez toutes les entrées utilisateur pour éliminer la possibilité qu’un utilisateur malveillant exécute des instructions SQL malveillantes pouvant entraîner une injection SQL sur votre base de données cible. Lorsque vous utilisez des pastilles de données dans Étape JDBC des instructions SQL, nettoyez-les d’abord à l’aide des fonctions de transformation Sanitize SQL. Cette catégorie de fonction de transformation s’affiche automatiquement lorsqu’une pastille de données est déposée dans l’entrée SQL Statement.

    Liste d’inclusion des opérations SQL

    Par défaut, vous pouvez exécuter les opérations SQL suivantes.
    • CHOISIR
    • INSÉRER
    • METTRE À JOUR
    • DELETE
    • AFFICHER
    • DÉCRIRE
    Pour activer uniquement certaines de ces opérations SQL qu’il Étape JDBC peut effectuer, créez une propriété mid.property.jdbc_operations et entrez les opérations SQL, séparées par une Serveur MID virgule. Pour en savoir plus sur les Serveur MID propriétés, consultez Propriétés du serveur MID.
    Remarque :
    Plusieurs instructions SQL ne sont pas autorisées. Les procédures stockées avec des paramètres de sortie ne sont pas prises en charge.

    Champs

    Champ Description
    Détails de la connexion
    Connexion Type de connexion à utiliser.
    • Définir l’inline de la connexion : Définissez les informations de connexion dans l'étape d'action.
    • Utiliser des alias de connexion : Définissez les informations de connexion à l'aide de la table Alias de connexion. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n'avez pas besoin de mettre à jour votre action personnalisée.

    Pour en savoir plus sur les connexions et les informations d’identification, consultez Introduction aux informations d’identification, connexions et alias.
    Alias de connexion Enregistrement d’alias de connexion et d’informations d’identification que le système utilise pour exécuter l’étape d’action. Les utilisateurs disposant du rôle d’administrateur ou de flow_designer peuvent créer ou sélectionner un enregistrement de connexion associé. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Informations d’identification, connexions et alias. La valeur d’informations d’identification s’affiche sous la forme d’une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Ce champ est disponible lorsque l’option Utiliser alias de connexion est sélectionnée dans la liste Connexion.
    Alias d’informations d’identification Alias d’informations d’identification que le système utilise pour exécuter l’étape d’action. Les utilisateurs disposant du rôle d’administrateur ou de flow_designer peuvent créer ou sélectionner un enregistrement de connexion associé. L’utilisation d’un alias élimine la nécessité de configurer plusieurs informations d’identification lors de l’utilisation d’une action dans plusieurs environnements. De même, si les informations d’identification changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Informations d’identification, connexions et alias. La valeur d’informations d’identification s’affiche sous la forme d’une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Sélection de MID 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 Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Grappe MID Pastille de données pour la grappe MID que vous souhaitez utiliser. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste de connexion et que la grappe MID spécifique est sélectionnée dans la liste de sélection MID.
    Type de base de données Type de base de données pour cette connexion. Les choix possibles sont les suivants :
    • MySQL
    • Oracle
    • SQL Server
    • Personnalisé
    Le choix par défaut est Personnalisé. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Pilote JDBC Pilote à utiliser pour cette connexion lorsqu’il ne s’agit pas d’un type de base de données par défaut tel que DB2 Universal et Sybase. Le type de base de données est personnalisé. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et lorsque l’option Personnalisé est sélectionnée dans la liste Type de base de données.
    URL de connexion URL qu’il 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. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et lorsque l’option Personnalisé est sélectionnée dans la liste Type de base de données.
    Application MID Demande que le doit soutenir pour être éligible à la Serveur MID sélection. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Options Aptitude du Serveur MID. SélectionnezJDBC. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Délai de connexion Temps écoulé maximal, en secondes, pour l’activité pendant la tentative de connexion à la base de données cible. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    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.
    Délai d'expiration de requête Durée maximale écoulée, en secondes, pendant laquelle la requête est autorisée à s’exécuter sans réponse. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Configuration JDBC
    Requête SQL Requête SQL exécutée par l’étape.
    Remarque :
    Lorsque vous utilisez des pastilles de données dans des instructions SQL d’étape, nettoyez-les d’abord à l’aide d’une étape de script de prétraitement. Pour plus d’informations, consultez Nettoyage des entrées à l’aide des fonctions d’échappement.
    Nombre maximal de lignes Nombre maximal de lignes à renvoyer à partir de l’instruction SQL. La valeur par défaut est 1 000.
    Taille maximale de la charge utile (Ko) Taille maximale de charge utile admissible, en Ko, à renvoyer à partir de l’instruction SQL. La taille par défaut de la charge utile est de 5 120 Ko. La taille maximale de la charge utile est de 10 Mo.
    Tester l'étape JDBC Testez l’étape JDBC. Affichez les résultats des tests directement dans la fenêtre Tester l’étape JDBC. Pour plus d'informations, consultez Tester l’étape JDBC.
    Politique des nouveaux essais
    Activer la politique des nouveaux essais Option permettant d'activer la politique des nouveaux essais. Pour plus d'informations, reportez-vous à Politique des nouveaux essais.
    Remplacer la politique des nouveaux essais pour l’alias Option permettant de remplacer la politique des nouveaux essais par défaut. Cette option ne s’applique pas lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
    Politique des nouveaux essais Politique des nouveaux essais par défaut associée à l'alias de connexion. Si l'option Remplacer la politique des nouveaux essais pour l'alias est sélectionnée, vous pouvez remplacer la politique des nouveaux essais par défaut et sélectionner une autre politique existante des nouveaux essais en fonction de vos besoins.

    Évaluation de l’erreur d’action

    En cas d'échec de cette étape
    Type de données : Choice

    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état ou le message d’une étape pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation de l’erreur d’action.