Run command

UiPath.Database.Activities.ExecuteNonQuery

Beschreibung

Führt eine SQL-Anweisung für eine Datenbank aus. Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der Zeilen, die vom Befehl betroffen sind. Für alle anderen Typen von Anweisungen ist der Rückgabewert -1.

Hinweis: Das Database-Aktivitätspack ist jetzt mit .NET 6 Windows kompatibel.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Plattformübergreifende Konfiguration

• Vorhandene Verbindung – Eine bereits geöffnete Datenbankverbindung, die von der Aktivität Verbinden mit Datenbank abgerufen wurde.
• Befehlstyp – Gibt an, wie eine Befehlszeichenfolge interpretiert wird. Die folgenden Optionen sind verfügbar:
  • Text – Führt den SQL-Befehl aus.
  • Gespeicherte Prozedur (Gespeicherte Prozedur) – Ruft den im SQL-Befehl angegebenen Prozedurnamen auf.
  • Tabelle direkt – ruft alle Datensätze aus einer Tabelle auf.
• SQL-Befehl – Ein SQL-Befehl, der ausgeführt werden soll. Diese Eigenschaft muss entsprechend der Auswahl in der Befehlstyp-Eigenschaft ausgefüllt werden.

Erweiterte Optionen

Sonstige

• Parameter (Parameters) - Ein Katalog an benannten Parametern, die an den SQL-Befehl gebunden sind. Die Bindung erfolgt durch Angabe der Anweisung @parameterName im SQL-Befehl. Zur Laufzeit wird „parameterName“ durch seinen Wert aus dem Wörterbuch ersetzt.
• Timeout – Gibt an, wie lange (in Millisekunden) darauf gewartet wird, dass die Aktivität die Aufgabe ausführt, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30.000 Millisekunden (30 Sekunden). Der Timeoutwert muss größer oder gleich 0 sein.
• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt.

Ausgabe

• Anzahl betroffener Zeilen – Das Ergebnis der Ausführung des SQL-Befehls.

Windows, Windows – Legacy-Konfiguration

Eigenschaften-Panel

Allgemein

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft Bei Fehler Fortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur String-Variablen.
• Timeout – Gibt an, wie lange (in Millisekunden) auf die Ausführung des SQL-Befehls gewartet wird, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden) und muss größer oder gleich 0 sein. Dieses Feld unterstützt nur Int32 -Variablen.
  Hinweis: Die in diesem Feld angegebene Zeitdauer beinhaltet nicht die Antwortzeit für den Abruf der Abfrageergebnisse. Dies bedeutet, dass die Gesamtausführungszeit der Aktivität möglicherweise länger ist als die tatsächliche Abfrageausführungszeit, für die die TimeoutMS- Eigenschaft gilt.

Verbindungskonfiguration

• VerbindungsZeichenfolge (ConnectionString) - Die Verbindungszeichenfolge zum Aufbau der Datenbankverbindung. Dieses Feld unterstützt nur String-Variablen.
• Vorhandene Verbindung – Eine bereits geöffnete Datenbankverbindung. Wenn eine solche Verbindung bereitgestellt ist, werden die Verbindungszeichenfolge- und SecureConnectionString- Eigenschaften ignoriert. Dieses Feld unterstützt nur DatabaseConnection -Variablen.
• AnbieterName (ProviderName) - Der Name des Datenbankanbieters, der für den Zugriff auf die Datenbank verwendet wird. Dieses Feld unterstützt nur String-Variablen.
• Sichere Verbindungszeichenfolge – Die Verbindungszeichenfolge zum Aufbau einer Datenbankverbindung als sichere Zeichenfolge. Dieses Feld unterstützt nur SecureString -Variablen.

Eingabe

• Parameter (Parameters) - Ein Katalog an benannten Parametern, die an den SQL-Befehl gebunden sind. Die Bindung erfolgt durch Angabe der Anweisung @parameterName im SQL-Befehl. Zur Laufzeit wird „parameterName“ durch seinen Wert aus dem Wörterbuch ersetzt.
• SQL-Befehl – Ein SQL-Befehl, der ausgeführt werden soll. Dieses Feld muss entsprechend der Auswahl in der Befehlstyp-Eigenschaft ausgefüllt werden. Dieses Feld unterstützt nur String -Variablen.

Sonstiges

• Befehlstyp – Gibt an, wie eine Befehlszeichenfolge interpretiert wird. Die folgenden Optionen sind verfügbar:

  • Text (Text) - Führt die im SQL-Parameter angegebene Abfrage aus.
  • StoredProcedure – Ruft den Prozedurnamen auf, der im SQL-Parameter angegeben ist.
  • TabelleDirekt – ruft alle Datensätze aus einer Tabelle auf.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Betroffene Datensätze – Das Ergebnis der Ausführung des SQL-Befehls. Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der Zeilen, die vom Befehl betroffen sind. Für alle anderen Typen von Anweisungen ist der Rückgabewert -1. Dieses Feld unterstützt nur Int32 -Variablen.