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.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Verbindung konfigurieren… – Wählen Sie eine vorhandene Datenbankverbindung aus oder fügen Sie mit dem Verbindungsassistenten eine neue hinzu.
• SQL-Abfrage – Ein auszuführender SQL-Befehl. Dieses Feld muss entsprechend der Auswahl in der Eigenschaft Befehlstyp ausgefüllt werden. Dieses Feld unterstützt nur String-Variablen.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• DisplayName - The display name of the activity. This field supports only String variables.
• 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 Dauer umfasst nicht die Antwortzeit für das Abrufen des Abfrageergebnisses. Das bedeutet, dass die gesamte Ausführungszeit der Aktivität möglicherweise größer ist als die tatsächliche Ausführungszeit der Abfrage, auf die die Eigenschaft AuszeitMS (TimeoutMS) angewendet wird.

Verbindungskonfiguration

• Verbindungszeichenfolge – 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 – Ein Wörterbuch benannter Parameter, 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-Abfrage – Ein auszuführender SQL-Befehl. Dieses Feld muss entsprechend der Auswahl in der Eigenschaft Befehlstyp 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 - Executes the query given in the SQL parameter.
  • StoredProcedure - Invokes the procedure name specified in the SQL parameter.
  • TableDirect - Invokes all records from a table.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Anzahl der betroffenen Zeilen – 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.

Plattformübergreifende Konfiguration

• Vorhandene Verbindung – Eine bereits geöffnete Datenbankverbindung, die von der Aktivität „Connect to database“ 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 – Ruft den im SQL-Befehl angegebenen Prozedurnamen auf.
  • Tabelle direkt – Ruft alle Datensätze aus einer Tabelle auf.
• SQL-Abfrage – Ein auszuführender SQL-Befehl. Diese Eigenschaft muss gemäß der Auswahl in der Eigenschaft Befehlstyp ausgefüllt werden.

Erweiterte Optionen

Sonstige

• Parameter – Ein Wörterbuch benannter Parameter, 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 der betroffenen Zeilen – Das Ergebnis der Ausführung des SQL-Befehls.