Run query

UiPath.Database.Activities.ExecuteQuery

Beschreibung

Führt eine Abfrage in einer Datenbank aus und gibt das Abfrageergebnis als DataTable zurück.

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, die aus den Aktivitäten „Connect“ oder „Start Transaction“ abgerufen wurde. Wenn eine solche Verbindung bereitgestellt ist, werden die Eigenschaften ConnectionString und SecureConnectionString 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 – Führt die im SQL-Parameter angegebene Abfrage aus.
  • StoredProcedure – Ruft den Prozedurnamen auf, der im SQL-Parameter angegeben ist.
  • TableDirect – 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

• Datentabelle – Die Ausgabe des SQL-Befehls, eingeschlossen in eine DataTable-Variable.
  Hinweis: Wenn Sie eine Tabelle mit Spalten mit dem Datentyp Date abfragen, haben die entsprechenden Spalten in der Ausgabe DataTable den Datentyp DateTime .

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 Abfragezeichenfolge 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

• Datentabelle – Die Ausgabe des SQL-Befehls, eingeschlossen in eine DataTable-Variable.