Étape JDBC

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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, consultez Legal schedules - IntegrationHub overview (Calendriers juridiques - Vue d'ensemble d'IntegrationHub). Une fois le module d’extension requis activé, l’étape est visible sous Intégrations.
    • Le s’exécute Étape JDBC uniquement sur un ServiceNow® Serveur MID avec Étape JDBC des options. Activez le module d’extension, Hub d'intégration Standard Pack Installer (com.glide.hub.integrations.standard) ou une version ultérieure pour utiliser l’option JDBC pour le Serveur MID.

    Rôles et disponibilité

    L’est Étape JDBC disponible en tant qu’étape d’action Concepteur d'action . 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 empêcher un utilisateur malveillant d’exécuter des instructions SQL malveillantes susceptibles d’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 apparaît automatiquement lorsqu’une pastille de données est déposée dans l’entrée d’instruction SQL.

    Liste d’inclusion des opérations SQL

    Par défaut, vous pouvez exécuter les opérations SQL suivantes.
    • SELECT
    • INSÉRER
    • METTRE À JOUR
    • DELETE
    • AFFICHER
    • DÉCRIRE
    Pour activer uniquement certaines de ces opérations SQL que le Étape JDBC peut effectuer, créez une Serveur MID propriété mid.property.jdbc_operations et saisissez les opérations SQL en les séparant par une virgule. Pour en savoir plus sur Serveur MID les propriétés, consultez Propriétés du MID Server.

    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 un 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, aux connexions et aux 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 flow_designer ou administrateur 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 est affichée sous la forme d’une pastille de données Mot de passe (2 voies cryptées) sur le panneau de données. Ce champ est disponible lorsque l’option Utiliser des alias de connexion est sélectionnée dans la liste Connexion.
    Alias d’informations d’identification Alias d’informations d’identification utilisé par le système pour exécuter l’étape d’action. Les utilisateurs disposant du rôle flow_designer ou administrateur 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 est affichée sous la forme d’une pastille de données Mot de passe (2 voies cryptées) 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 MID Server ou la grappe MID spécifique.
    • Sélectionner automatiquement un MID Server : sélectionne automatiquement le MID Server.
    • MID Server spécifique : utilise le MID Server 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 Connexion et qu’une grappe MID spécifique est sélectionnée dans la liste 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 les options Définir l’inline de la connexion sont sélectionnées dans la liste Connexion et Personnalisé dans la liste Type de base de données.
    URL de connexion URL utilisée pour se Serveur MID 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 les options Définir l’inline de la connexion sont sélectionnées dans la liste Connexion et Personnalisé dans la liste Type de base de données.
    Application MID Demande que le doit prendre en charge 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 MIDfichier . 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, pendant lequel l’activité attend lors de 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.
    Délai d’expiration de requête Temps maximal écoulé, en secondes, pendant lequel 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 SQL que l’étape exécute.
    Remarque :
    Lorsque vous utilisez des pastilles de données dans des instructions SQL d’étapes, nettoyez-les d’abord à l’aide d’une étape de script de prétraitement. Pour plus d’informations, reportez-vous à la section Assainissement 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 1000.
    Taille maximale de la charge utile (Ko) Taille maximale de charge utile autorisée, en Ko, à renvoyer à partir de l’instruction SQL. La taille de la charge utile par défaut 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 n’est pas applicable 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.

    Champs d’évaluation des erreurs d’action

    Champ Description
    En cas d'échec de cette étape 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 de l’étape pour une condition d’erreur d’action personnalisée, reportez-vous à Action error evaluation.