JDBC-Schritt

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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 Workflow-Studio -Aktionsschritt verfügbar. Benutzer mit der Rolle „action_designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.

    Eingaben werden bereinigt

    Escapen Sie alle Anwendereingaben, um zu verhindern, dass ein böswilliger Anwender schädliche SQL-Anweisungen ausführt, die zu einer SQL-Einschleusung 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 für die SQL-Anweisung abgelegt wird.

    Aufnahmeliste für SQL-Vorgänge

    Standardmäßig können Sie die folgenden SQL-Vorgänge ausführen.
    • AUSWÄHLEN
    • EINFÜGEN
    • AKTUALISIEREN
    • LÖSCHEN
    • ANZEIGEN
    • BESCHREIBEN
    Um nur einige der SQL-Vorgänge zu aktivieren, die von JDBC-Schritt ausgeführt werden können, erstellen Sie eine MID-Server -Eigenschaft, mid.property.jdbc_operations, und geben Sie die SQL-Vorgänge durch Kommas getrennt ein. Weitere Informationen zu den Eigenschaften MID-Server finden Sie unter MID-Server-Eigenschaften.
    Hinweis:
    Mehrere SQL-Anweisungen sind nicht zulässig. Gespeicherte Vorgehensweisen mit Ausgabeparametern werden nicht unterstützt.

    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 zu Anmeldeinformationen, Verbindungen und Aliassen.
    Verbindungsalias Aliasdatensatz 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 zugehörigen 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 anwenderdefinierte 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 (zweifach verschlüsselt) im Datenbereich angezeigt. Dieses Feld ist verfügbar, wenn Verbindungsalias verwenden aus der Verbindungsliste 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 zugehörigen 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. Auch wenn sich die Anmeldeinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Wert der Anmeldeinformationen wird als Datenpille Passwort (zweifach verschlüsselt) im Datenbereich angezeigt. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste ausgewählt wird.
    MID-Auswahl Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
    • MID-Server automatisch auswählen: Wählt den MID-Server automatisch aus.
    • Spezifischer MID-Server: Verwendet den ausgewählten MID-Server.
    • Spezifischer MID-Cluster: Verwendet den ausgewählten MID-Cluster.
    Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste 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 in der Verbindungsliste und Spezifischer MID-Cluster in der MID-Auswahlliste ausgewählt werden.
    Datenbanktyp Datenbanktyp für diese Verbindung. Die Auswahlmöglichkeiten sind:
    • MySQL
    • Oracle
    • SQL Server
    • Benutzerdefiniert
    Die Standardauswahl ist Anwenderdefiniert. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste ausgewählt wird.
    JDBC-Treiber Für diese Verbindung zu verwendender Treiber, wenn es sich nicht um einen Standarddatenbanktyp wie DB2 Universal und Sybase handelt. Der Datenbanktyp ist Anwenderdefiniert. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren in der Verbindungsliste und Anwenderdefiniert in der Liste Datenbanktyp ausgewählt wird.
    Verbindungs-URL URL, die von MID-Server zum Herstellen einer Verbindung mit der angegebenen Datenbank verwendet wird. 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 in der Verbindungsliste und Anwenderdefiniert in der Liste Datenbanktyp ausgewählt wird.
    MID-Applikation Anwendung, die der MID-Server unterstützen muss, um ausgewählt zu werden. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste ausgewählt wird.
    Funktionen Fähigkeit des MID-Server. Wählen SieJDBCaus. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste ausgewählt wird.
    Verbindungszeitüberschreitung Maximale verstrichene Zeit in Sekunden, die die Aktivität warten muss, während versucht wird, eine Verbindung zur Zieldatenbank herzustellen. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste ausgewählt wird.
    Hinweis:
    Vermeiden Sie es, den Wert für die Verbindungszeitüberschreitung auf Null zu setzen, da dies zu einer veralteten Verbindung führen kann.
    Zeitüberschreitung bei Abfrage Maximale verstrichene Zeit in Sekunden, die die Abfrage ohne Antwort ausgeführt werden darf. Dieses Feld ist verfügbar, wenn Verbindung inline definieren aus der Verbindungsliste 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 Vorverarbeitungsskriptschritt. 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 „Verbindung inline definieren“ in der Liste „Verbindung“ ausgewählt ist.
    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.

    Fehlerbewertung der Aktion

    Wenn dieser Schritt fehlschlägt
    Datentyp: Choice

    Option, um den nächsten Schritt auszuführen oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Nachricht für eine anwenderdefinierte Aktionsfehlerbedingung finden Sie unter Fehlerbewertung der Aktion.