JDBC-Schritt

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

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

    Hinweis:
    • Dieser Schritt erfordert IntegrationHubAbonnement. Weitere Informationen finden Sie unter Rechtliche Zeitpläne – IntegrationHubÜbersicht . Nachdem das erforderliche Plugin aktiviert wurde, ist der Schritt unter Integrationen sichtbar.
    • Die JDBC-SchrittWird nur für ausgeführt ServiceNow® MID-ServerMit JDBC-SchrittFähigkeiten. Aktivieren Sie das Plugin, IntegrationHubStandardpaket-Installationsprogramm (com.glide.hub.integrations.standard) oder höher zur Verwendung der JDBC-Fähigkeit für MID-Server.

    Rollen und Verfügbarkeit

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

    Eingaben werden bereinigt

    Vermeiden Sie alle Anwendereingaben, 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 MID-ServerEigenschaft, mid.property.jdbc_operationsUnd geben Sie die SQL-Vorgänge durch Komma getrennt ein. Um mehr zu erfahren MID-ServerEigenschaften, siehe MID-Servereigenschaften .
    Hinweis:
    Mehrere SQL-Anweisungen sind nicht zulässig. Gespeicherte Verfahren mit Ausgabeparametern werden nicht unterstützt.

    Felder

    Feld Beschreibung
    Verbindungsdetails
    Verbindung Typ der zu verwendenden Verbindung.
    • Definieren Sie Die Verbindung Inline : Definieren Sie Verbindungsinformationen im Aktionsschritt.
    • Verwenden Sie Den Verbindungsalias : Definieren Sie Verbindungsinformationen mithilfe der Tabelle „Verbindungsalias“. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren.

    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. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. 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 Aliasse . Der Anmeldeinformationswert wird als Passwortdatenpille (zweifach verschlüsselt) im Datenbereich 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. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformationen konfiguriert werden. Wenn sich die Anmeldeinformationsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasse . Der Anmeldeinformationswert wird als Passwortdatenpille (zweifach verschlüsselt) im Datenbereich angezeigt. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    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.
    • Bestimmter MID-Server : Verwendet den von Ihnen ausgewählten MID-Server.
    • Bestimmter MID-Cluster : Verwendet den von Ihnen ausgewählten MID-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 Bestimmter MID-Cluster Ist aus der MID-Auswahlliste ausgewählt.
    Datenbanktyp Datenbanktyp für diese Verbindung. Die Auswahlmöglichkeiten sind:
    • MySQL
    • Oracle
    • SQL-Server
    • Anwenderdefiniert
    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-ServerWird verwendet, um eine Verbindung mit der angegebenen Datenbank herzustellen. Die URL wird automatisch erstellt, wenn Sie das Formular speichern, 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-Anwendung Anwendung, die MID-ServerMuss 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.
    Fähigkeiten 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 Maximale 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 Maximale 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 Test-JDBC-Schritt-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 standardmäßigen Wiederholungsrichtlinie. Diese Option gilt nicht, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    Wiederholungsrichtlinie Standardmäßige Wiederholungsrichtlinie, die zugeordnet ist Verbindungsalias . Wenn Überschreiben Sie die Standardrichtlinie für den Alias Ist ausgewählt, können Sie die standardmäßige Wiederholungsrichtlinie überschreiben und eine andere vorhandene Wiederholungsrichtlinie basierend auf Ihren Anforderungen 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 Action error evaluation.