Freigeben über

Query Database

  • Artikel

Die Aktivität „Query Database“ fragt eine Datenbank ab und gibt die resultierenden Zeilen als veröffentlichte Daten zurück. Die Aktivität unterstützt die folgenden Datenbanktypen:

  • Access

  • ODBC

  • Oracle

  • SQL Server

Die Aktivität „Query Database“ kann verwendet werden, um eine Datenbank nach einer detaillierten Beschreibung eines Fehlercodes abzufragen, der auf einem der Systeme im Rechenzentrum aufgetreten ist. Diese Beschreibung wird dann per E-Mail an einen Admin gesendet.

Konfigurieren der Abfragedatenbankaktivität

Bevor Sie die Abfragedatenbankaktivität konfigurieren, müssen Sie Folgendes ermitteln:

  • Die Datenbank, mit der Sie eine Verbindung herstellen

  • Die SQL-Abfrage, die Sie ausführen

Verwenden Sie die folgenden Informationen, um die Aktivität „Query Database“ zu konfigurieren:

Details

Einstellungen Konfigurationsanweisungen
Abfrage Geben Sie die SQL-Abfrage in das Abfragefeld ein.

Warnung

Die Aktivität „Query Database“ unterstützt keine Abfragen, die Daten als XML zurückgeben, wie etwa Abfragen, die die Klausel FOR XML in SQL Server verwenden.

Verbindung

Einstellungen Konfigurationsanweisungen
Datenbanktyp Wählen Sie den Datenbanktyp aus der Dropdownliste aus. Folgende Optionen stehen dafür zur Verfügung:

- Zugriff
– ODBC
- Oracle
- SQL Server

Wichtig

Wenn Orchestrator auf einem nicht-englischen Betriebssystem installiert ist und Sie die Verbindung für den Datenbanktyp auf SQL Server festlegen, kann der Server-Eingabewert nicht localhost sein. Sie müssen den tatsächlichen Computernamen verwenden.

Konfigurationsanweisungen für jeden Datenbanktyp auf der Registerkarte Verbindung sind in den folgenden Tabellen aufgeführt.

Access-Verbindungen

Einstellungen Konfigurationsanweisungen
Datei Geben Sie den Namen der Access-Datenbankdatei ein, auf die Sie zugreifen möchten.
Arbeitsgruppendatei Geben Sie den Namen der Access-Arbeitsgruppendatei ein, die dieser Datenbank zugeordnet ist.
Benutzername Geben Sie den Benutzernamen für die Arbeitsgruppendatei ein.
Kennwort Geben Sie das Kennwort für die Arbeitsgruppendatei ein.
DB-Kennwort Geben Sie das Kennwort für die Access-Datenbank ein.

ODBC-Verbindungen

Einstellungen Konfigurationsanweisungen
DSN Geben Sie einen Datenquellennamen ein.
Benutzername Geben Sie den Benutzernamen für diese Datenbank ein.
Kennwort Geben Sie das Kennwort für diese Datenbank ein.

Oracle-Verbindungen

Einstellungen Konfigurationsanweisungen
Dienstname Geben Sie den Dienstnamen ein.
Benutzername Geben Sie den Benutzernamen für diese Datenbank ein.
Kennwort Geben Sie das Kennwort für diese Datenbank ein.

SQL Server-Verbindungen

Hinweis

MSOLEDB19 Treiber wird verwendet, um verschlüsselte Verbindungen mit sql Server herzustellen (standardmäßig). Wenn das SQL Server-Zertifikat auf dem Orchestrator-Computer nicht vertrauenswürdig ist, geben Sie "Server=<serverName>" ein. Trust Server Certificate=True für jede Konfiguration. Weitere Informationen zum Installieren eines SQL Server-Zertifikats.

Einstellungen Konfigurationsanweisungen
Authentifizierung Wählen Sie entweder Windows-Authentifizierung oder SQL Server-Authentifizierung aus.
Server Geben Sie den Namen des SQL-Servers ein, auf den Sie zugreifen möchten.
Anfangskatalog Geben Sie den Namen des Anfangskatalogs ein.

Wenn Sie die Option SQL Server-Authentifizierung ausgewählt haben, geben Sie in die Felder Benutzername und Kennwort den Benutzernamen und das Kennwort für den Zugriff auf den SQL Server ein.

Timeout

Einstellungen Konfigurationsanweisungen
Timeout Geben Sie ein, wie lange die Aktivität „Datenbank abfragen“ auf den Abschluss des Datenbankvorgangs wartet.

Wenn Sie diesen Wert auf 0 festlegen, bedeutet dies auch, dass die Wartezeit unbegrenzt ist.

Sicherheit von Anmeldeinformationen

Einstellungen Konfigurationsanweisungen
Sicherheit des dem Dienst zugewiesenen Kontos verwenden Wählen Sie diese Option aus, wenn Sie die Aktivität „Query Database“ unter Verwendung desselben Kontos ausführen möchten, das der Runbook-Server verwendet.
Dieses Konto Verwenden Sie diese Option, um ein anderes Konto anzugeben. Geben Sie den Benutzernamen und das Kennwort ein. Hinweis: Wenn Sie einen ungültigen Benutzernamen oder ein ungültiges Passwort angeben, wird für die Ausführung der Aktivität das dem Runbook-Server zugewiesene Konto verwendet.

Veröffentlichte Daten

In der folgenden Tabelle sind die veröffentlichten Daten aufgeführt.

Artikel Beschreibung
Numerischer Rückgabewert der Abfrage Wenn eine Abfrage verwendet wird, die einen numerischen Wert zurückgibt, ist dies der Wert. Zum Beispiel: "Select COUNT(*) where FirstName=John"
Datenbankabfrage Die Datenbankabfrage, die an die Datenbank gesendet wurde.
Anfangskatalog Der Anfangskatalog, der beim Herstellen einer Verbindung mit der Datenbank verwendet wurde. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option SQL Server ausgewählt wurde.
Datenbankserver Der Name des Datenbankservers. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option SQL Server ausgewählt wurde.
Datenbankbenutzer Der Name des Benutzers, mit dem die Verbindung zum Datenbankserver hergestellt wird.
ODBC-DSN Der Name des ODBC-DSN. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option ODBC ausgewählt wurde.
Oracle Service Name Der Name des Diensts. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option Oracle ausgewählt wurde.
Access-Datei Die Access-Datenbankdatei, die abgefragt wurde. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option Access ausgewählt wurde.
Access-Arbeitsgruppeninformationsdatei Die Access-Arbeitsgruppendatei, die der Access-Datenbankdatei zugeordnet ist. Diese veröffentlichten Daten sind nur verfügbar, wenn auf der Registerkarte Verbindung die Option Access ausgewählt wurde.
Für jede veröffentlichte Zeile
Vollständige Zeile als Zeichenfolge mit durch Trennzeichen getrennten Feldern ; Die gesamte Zeile, die mit jedem Feld in der Zeile veröffentlicht wurde, getrennt durch ein Semikolon (;)). Verwenden Sie die Feld-Datenbearbeitungsfunktion, um die Werte eines Feldes innerhalb der Zeile zu erhalten.