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

• BeiFehler fortfahren – 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 Truefestgelegt ist, wird die Ausführung des Projekts unabhängig von einem Fehler 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 – 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 (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

• 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 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-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 betroffener Zeilen – Das Ergebnis der Ausführung des SQL-Befehls.