JDBC-Schritt

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Erstellen Sie eine wiederverwendbare Aktion, um SQL-Befehle an eine relationale Datenbank zu senden.

    Hinweis:
    • Dieser Schritt erfordert ein IntegrationHub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht. Nachdem das erforderliche Plugin aktiviert wurde, wird der Schritt unter Integrationen angezeigt.
    • JDBC-Schritt wird nur auf einem ServiceNow® MID-Server mit JDBC-Schritt -Fähigkeiten ausgeführt. Aktivieren Sie das Plugin IntegrationHub Standard Pack Installer (com.glide.hub.integrations.standard) oder höher, um die JDBC-Fähigkeit für MID-Serverzu verwenden.

    Rollen und Verfügbarkeit

    JDBC-Schritt ist als Aktionsschritt Aktionsdesigner ] verfügbar. Benutzer mit der Rolle „action_designer“ können eine benutzerdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.

    Eingaben werden bereinigt

    Schließen Sie alle Benutzereingaben mit Escape-Zeichen, um zu verhindern, dass ein böswilliger Benutzer schädliche SQL-Anweisungen ausführt, die zu einer SQL-Injektion in Ihrer Zieldatenbank führen können. Wenn Sie Datenpillen in JDBC-Schritt SQL-Anweisungen verwenden, bereinigen Sie sie zuerst mit SQL-Transformationsfunktionen bereinigen. Diese Transformationsfunktionskategorie wird automatisch angezeigt, wenn eine Datenpille in der Eingabe „SQL-Anweisung“ abgelegt wird.

    Aufnahmeliste für SQL-Vorgänge

    Standardmäßig können Sie die folgenden SQL-Vorgänge ausführen.
    • SELECT
    • EINFÜGEN
    • AKTUALISIEREN
    • LÖSCHEN
    • ANZEIGEN
    • BESCHREIBEN
    Um nur einige dieser SQL-Vorgänge zu aktivieren, die JDBC-Schritt ausführen kann, erstellen Sie eine MID-Server -Eigenschaft, mid.property.jdbc_operations, und geben Sie die SQL-Vorgänge durch Kommas getrennt ein. Weitere Informationen zu MID-Server -Eigenschaften finden Sie unter MID Server-Eigenschaften.

    Felder

    Feld Beschreibung
    Verbindungsdetails
    Verbindung Art der zu verwendenden Verbindung.
    • Verbindung Inline definieren: Definieren Sie die Verbindungsinformationen innerhalb des Aktionsschritts.
    • Verbindungs-Alias verwenden: Definieren Sie die Verbindungsinformationen mithilfe der Tabelle „Verbindungsalias“. Wenn Sie einen Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Verbindungsinformationen ändern.

    Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Einführung in Anmeldeinformationen, Verbindungen und Aliasse.
    Verbindungsalias Datensatz des Alias für Verbindungen und Anmeldeinformationen, den das System zum Ausführen des Aktionsschritts verwendet. Benutzer mit der Rolle „flow_designer“ oder „admin“ können einen zugeordneten Verbindungsdatensatz erstellen oder auswählen. Wenn Sie einen Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Verbindungsinformationen ändern. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Wert der Anmeldeinformationen wird als Datenpille Passwort (2-fach verschlüsselt) im Datenbereich angezeigt. Dieses Feld ist verfügbar, wenn in der Liste Verbindung die Option Verbindungsalias verwenden ausgewählt wird.
    Anmeldeinformationsalias Anmeldeinformationsalias, den das System zum Ausführen des Aktionsschritts verwendet. Benutzer mit der Rolle „flow_designer“ oder „admin“ können einen zugeordneten Verbindungsdatensatz erstellen oder auswählen. Wenn Sie einen Alias verwenden, müssen Sie nicht mehr mehrere Anmeldeinformationen konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Anmeldeinformationen ändern. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Wert der Anmeldeinformationen wird als Datenpille Passwort (2-fach verschlüsselt) im Datenbereich angezeigt. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    MID-Auswahl Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
    • MID Server automatischauswählen: Wählt den MID Server automatisch aus.
    • Spezifischer MID Server: Verwendet den von Ihnen ausgewählten MID Server.
    • Spezifischer MID-Cluster: Verwendet den von Ihnen ausgewählten MID-Cluster.
    Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    MID-Cluster Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird und Spezifischer MID-Cluster aus der MID-Auswahlliste ausgewählt wird.
    Datenbanktyp Datenbanktyp für diese Verbindung. Die Auswahlmöglichkeiten sind:
    • MySQL
    • Oracle
    • SQL Server
    • Benutzerdefiniert
    Die Standardauswahl ist Benutzerdefiniert. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    JDBC-Treiber Treiber, der für diese Verbindung verwendet werden soll, wenn es sich nicht um einen Standarddatenbanktyp wie DB2 Universal und Sybase handelt. Der Typ der Datenbank ist Benutzerdefiniert. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung und Benutzerdefiniert aus der Liste Datenbanktyp ausgewählt wird.
    Verbindungs-URL URL, die MID-Server verwendet, um eine Verbindung zur angegebenen Datenbank herzustellen. Die URL wird beim Speichern des Formulars automatisch erstellt und ist für die Standarddatenbanken schreibgeschützt. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung und Benutzerdefiniert aus der Liste Datenbanktyp ausgewählt wird.
    MID-Applikation Anwendung, die MID-Server unterstützen muss, um für die Auswahl in Frage zu kommen. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    Funktionen Fähigkeit von MID-Server. Wählen SieJDBC aus. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    Verbindungszeitüberschreitung Maximale verstrichene Zeit in Sekunden, die die Aktivität warten soll, während versucht wird, eine Verbindung zur Zieldatenbank herzustellen. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    Zeitüberschreitung bei Abfrage Maximale verstrichene Zeit in Sekunden, in der die Abfrage ohne Antwort ausgeführt werden darf. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    JDBC-Konfiguration
    SQL-Anweisung SQL-Anweisung, die der Schritt ausführt.
    Hinweis:
    Wenn Sie Datenpillen in Schritt-SQL-Anweisungen verwenden, bereinigen Sie sie zuerst mit einem Vorverarbeitungs- Skriptschritt. Weitere Informationen finden Sie unter Eingaben mit Escape-Funktionen bereinigen.
    Maximale Zeilen Maximale Anzahl von Zeilen, die von der SQL-Anweisung zurückgegeben werden sollen. Der Standardwert ist 1000.
    Maximale Nutzlastgröße (KB) Maximal zulässige Nutzlastgröße in KB, die von der SQL-Anweisung zurückgegeben werden soll. Die Standardnutzlastgröße beträgt 5120 KB. Die maximale Nutzlastgröße beträgt 10 MB.
    JDBC-Testschritt Testen Sie den JDBC-Schritt. Zeigen Sie Testergebnisse direkt im Fenster „JDBC-Testschritt“ an. Weitere Informationen finden Sie unter JDBC-Testschritt.
    Wiederholungsrichtlinie
    Wiederholungsrichtlinie aktivieren Option zum Aktivieren der Wiederholungsrichtlinie. Weitere Informationen finden Sie unter Wiederholungsrichtlinie.
    Standardrichtlinie für Alias überschreiben Option zum Überschreiben der Standardwiederholungsrichtlinie. Diese Option ist nicht anwendbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    Wiederholungsrichtlinie Standardwiederholungsrichtlinie, die dem Verbindungsalias zugeordnet ist. Wenn Standardrichtlinie für Alias überschreiben ausgewählt ist, können Sie die Standardwiederholungsrichtlinie überschreiben und eine andere vorhandene Neuversuchsrichtlinie basierend auf Ihrer Anforderung auswählen.

    Felder für Aktionsfehlerauswertung

    Feld Beschreibung
    Wenn dieser Schritt fehlschlägt Option, um mit der Ausführung des nächsten Schritts fortzufahren oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine Fehlerbedingung für eine benutzerdefinierte Aktion finden Sie unter Aktionsfehlerbewertung.