JDBC-Schritt

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 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 Zeitpläne für Rechtsabteilung – IntegrationHubÜbersicht . Nachdem das erforderliche Plugin aktiviert wurde, ist der Schritt unter Integrationen sichtbar.
    • Die JDBC-SchrittWird nur für ausgeführt ServiceNow® MID-Server Mit JDBC-SchrittFähigkeiten. Aktivieren Sie das Plugin, IntegrationHub Standard-Paket-Installationsprogramm (com.glide.hub.integrations.standard) oder höher, um die JDBC-Fähigkeit für zu verwenden MID-Server.

    Rollen und Verfügbarkeit

    Die JDBC-SchrittIst als verfügbar Workflow-Studio Aktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.

    Eingaben werden bereinigt

    Alle Anwendereingaben mit Escape-Zeichen versehen, um zu verhindern, dass ein böswilliger Anwender schädliche SQL-Anweisungen ausführt, die zu SQL-Injection in Ihrer Zieldatenbank führen können. Wenn Sie Datenpillen in verwenden JDBC-SchrittSQL-Anweisungen, bereinigen Sie sie zuerst mit Bereinigen Sie SQL-Transformationsfunktionen . Diese Transformationsfunktionskategorie wird automatisch angezeigt, wenn eine Datenpille in die SQL-Anweisungseingabe abgelegt wird.

    Aufnahmeliste für SQL-Vorgänge

    Standardmäßig können Sie die folgenden SQL-Vorgänge ausführen.
    • WÄHLEN SIE AUS
    • EINFÜGEN
    • AKTUALISIEREN
    • LÖSCHEN
    • ANZEIGEN
    • BESCHREIBEN
    Um nur einige dieser SQL-Vorgänge zu aktivieren, die JDBC-SchrittKann ausführen, erstellen Sie MID-Server Eigenschaft, mid.property.jdbc_operationsUnd geben Sie die SQL-Vorgänge durch Komma getrennt ein. Um mehr über zu erfahren MID-Server Eigenschaften, siehe MID-Server-Eigenschaften .
    Hinweis:
    Mehrere SQL-Anweisungen sind nicht zulässig. Gespeicherte Verfahren 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 in Anmeldeinformationen, Verbindungen und Aliasse .
    Verbindungsalias Alias-Datensatz für Verbindungen und Anmeldeinformationen, den das System zur Ausführung des Aktionsschritts verwendet. Anwender 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. Wenn sich die Verbindungsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Anmeldeinformationswert wird im Datenbereich als Passwortdatenpille (zweifach verschlüsselt) angezeigt. Dieses Feld ist verfügbar, wenn Verwenden Sie Den Verbindungsalias Ist aus der Verbindungsliste ausgewählt.
    Anmeldeinformationsalias Anmeldeinformationsalias, den das System zur Ausführung des Aktionsschritts verwendet. Anwender 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. 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 Anmeldeinformationswert wird im Datenbereich als Passwortdatenpille (zweifach verschlüsselt) angezeigt. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    MID-Auswahl Option zum Auswählen eines bestimmten MID-Servers oder MID-Clusters. Wählen Sie eine der folgenden Optionen aus.
    • Wählen Sie DEN MID-Server automatisch aus : Ihr ServiceNowInstanz wählt aus MID-ServerOhne manuelle Eingabe.
    • Spezifischer MID-Server : Ihr ServiceNowInstanz verwendet MID-ServerDie Sie angeben.
    • Spezifischer MID-Cluster : Ihr ServiceNowInstanz verwendet den von Ihnen angegebenen MID-Cluster.

      Ein MID-Cluster ist eine Gruppe von MID-Servern, die Ihren aktivieren ServiceNowInstanz zur Verarbeitung mehrerer Integrationen und zur Verbesserung der Integrationsgeschwindigkeit. Weitere Informationen finden Sie unter Configure a MID Server cluster.

    Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    MID-Cluster Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste und ausgewählt Spezifischer MID-Cluster Ist aus der MID-Auswahlliste ausgewählt.
    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 Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    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 Datenbanktyp ist Anwenderdefiniert . Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste und ausgewählt Anwenderdefiniert Ist aus der Liste Datenbanktyp ausgewählt.
    Verbindungs-URL URL, die die ist MID-Server Verwendet, um eine Verbindung mit der 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 Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste und ausgewählt Anwenderdefiniert Ist aus der Liste Datenbanktyp ausgewählt.
    MID-Applikation Anwendung, die MID-Server Muss unterstützen, um für die Auswahl berechtigt zu sein. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    Funktionen Fähigkeit von MID-Server. Wählen Sie Aus JDBC . Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    Verbindungszeitüberschreitung Maximal verstrichene Zeit in Sekunden, bis die Aktivität beim Versuch, eine Verbindung zur Zieldatenbank herzustellen, wartet. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    Hinweis:
    Vermeiden Sie das Festlegen von Verbindungszeitüberschreitung Wert auf Null, da dies zu einer veralteten Verbindung führen kann.
    Zeitüberschreitung bei Abfrage Maximal verstrichene Zeit in Sekunden, die die Abfrage ohne Antwort ausgeführt werden darf. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    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 einer Vorverarbeitung Skriptschritt . Weitere Informationen finden Sie unter Bereinigen von Eingaben mithilfe der Escape-Funktionen .
    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 standardmäßige Nutzlastgröße ist 5120 KB . Die maximale Nutzlastgröße beträgt 10 MB .
    JDBC-Testschritt Testen Sie den JDBC-Schritt. Zeigen Sie Testergebnisse direkt im JDBC-Testschritt-Fenster an. Weitere Informationen finden Sie unter JDBC-Schritt testen.
    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 gilt nicht, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    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.

    Auswertung des Aktionsfehlers

    Wenn dieser Schritt fehlschlägt
    Datentyp: Choice

    Option, um den nächsten Schritt fortzusetzen oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine anwenderdefinierte Aktionsfehlerbedingung finden Sie unter Aktionsfehlerauswertung.