Étape JDBC

Remarque :

Cette étape nécessite un abonnement Hub d'intégration. Pour plus d’informations, consultez Calendriers juridiques - Vue d’ensemble du concentrateur d’intégration. Une fois le module d’extension requis activé, l’étape est visible sous Intégrations.
L’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 le programme d’installation du 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é pour un utilisateur malveillant d’exécuter 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 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 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 Serveur MID les propriétés, consultez Propriétés du serveur MID.

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 l’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 Présentation des informations d’identification, des connexions et des 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 admin 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 (2 sens cryptés) sur le panneau de données. Ce champ est disponible lorsque l’option Utiliser l’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 admin 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 (2 sens cryptés) 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 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 Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
Grappe MID	Pilule de données pour la grappe MID que vous souhaitez utiliser. Ce champ est disponible lorsque Définir l’inline de la connexion est sélectionné dans la liste Connexion et que 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 Définir l’inline de la connexion est sélectionnée dans la liste Connexion et Personnalisé est sélectionnée dans la liste Type de base de données.
URL de connexion	URL utilisée Serveur MID 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 Définir l’inline de la connexion est sélectionnée dans la liste Connexion et Personnalisé est sélectionnée dans la liste Type de base de données.
Application MID	Demande qu’ils doivent 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 maximal écoulé, 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	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	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 1 000.
Taille maximale de la charge utile (Ko)	Taille maximale de charge utile admissible, en Ko, à retourner à 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 Étape de test 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 de l’étape pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation de l’erreur d’action.