Verwendung der Aktion „Verbinden“ für Datenbanken

Verwenden Sie die Aktion Verbinden, um eine Verbindung mit einem Datenbankserver herzustellen, den Sie zum Automatisieren von datenbankbezogenen Aufgaben verwenden möchten. Diese Aktion unterstützt Microsoft Access-, Microsoft SQL Server-, MySQL-, Oracle-, PostgreSQL-Server- und SQLite-Datenbankserver sowie die Verwendung von CSV-, Microsoft Excel- und TXT-Dateien als Datenbanken.

Wichtig: Wenn Ihre derzeitige Office-Installation eine der folgenden ist:
  • Microsoft 365 Apps für Unternehmen
  • Office 2016, 2019 oder 2021 (Verbraucher-Version 2009 oder höher)

Dann müssen Sie die Microsoft Access Database Engine nicht als zusätzliche Komponente in Ihrem System installieren.

Wenn Sie jedoch sowohl Microsoft 365 Apps als auch die Microsoft Access Database Engine auf Ihrem System installiert haben, können Sie die Microsoft Access Database Engine deinstallieren und Microsoft 365 Apps reparieren.

Microsoft empfiehlt, den Microsoft Access Database Engine-Treiber nicht separat zu installieren, da sowohl die Microsoft Access Database Engine 2016 als auch Microsoft 365 Apps die gleiche Hauptversionskennung (16.0) verwenden. Weitere Informationen über die Installationsanforderungen für den Microsoft Access Database Engine-Treiber finden Sie unter Unable to use the Access ODBC or OLEDB provider
Anmerkung: Der SQL Server-Treiber ist nicht von der Microsoft Office-Installation abhängig. Nur die Version des Excel-Treibers ist von der Microsoft Office-Version abhängig.

Geben Sie die Details eines Datenbankservers an und ordnen Sie ihm einen Sitzungsnamen zu. Verwenden Sie den in dieser Aktion festgelegten Sitzungsnamen auch in anderen Aktionen, damit Sie die Details des Datenbankservers in diesen Aktionen nicht erneut angeben müssen.

Prozedur

Führen Sie die folgenden Schritten aus, um eine Verbindung mit einem Datenbankserver herzustellen:

  1. Doppelklicken oder ziehen Sie die Aktion Verbinden aus dem Datenbank-Paket in der Aktionen-Palette.
  2. Wählen Sie die Verbindungsoption Standard oder Nutzerdefiniert aus.
    Wenn Sie den Verbindungsmodus Nutzerdefiniert wählen und die Aktion Lesen aus mit ANSI-Kodierung verwenden, um die abgerufenen Daten in einer CSV-Datei zu speichern, werden Sie feststellen, dass die abgerufenen Datensätze aus der Oracle-Datenbank verzerrte Zeichen enthalten.

    Weitere Informationen zu diesem Thema finden Sie unter Fullwidth hyphen is garbled when exporting data to csv by Database: Read from action with encoding ANSI (A-people login required)

    • Wenn Sie die Option Standard wählen, können Sie die Verbindungszeichenfolge für jede Datenbank, die JDBC-Verbindungszeichenfolgen und einen 64-Bit-Treiber unterstützt, direkt eingeben. Eine Liste der unterstützten Datenbanken finden Sie unter Matrix zur Unterstützung von Datenbankservern.
      Anmerkung: Wenn Sie die Option Standard wählen, um eine Verbindung zu Excel herzustellen und nicht-lateinische Zeichen in einer Excel-Datei zu verwenden, müssen Sie zur Unterstützung der Unicode-Zeichen die UTF-8-Kodierung verwenden.

      Wenn Sie Ihre Datenbank und das freigegebene Repository am sekundären Standort konfiguriert haben, verwenden Sie die JDBC-Verbindung, um eine Verbindung zur Replikat-Datenbank herzustellen. Beispiel: jdbc:sqlserver://AGL-ADDRESS:1433;databaseName=DB_NAME;user=username;password=password;applicationIntent=ReadOnly

      Sie können eine Verbindung mit der Snowflake-Datenbank über ODBC-Treiber herstellen. Weitere Informationen zum Herunterladen des ODBC-Treibers finden Sie unter Snowflake using ODBC Driver

      Sie können die Verbindungszeichenfolge eingeben, um eine Verbindung zur Datenbank herzustellen. Beispiel: Driver={SnowflakeDSIIDriver};Server={account}.aws.snowflakecomputing.com;Database=DB_NAME;uid=username;pwd=password;

      Verwenden Sie diese Option, um eine Verbindung zu einer Excel-, CSV- oder TXT-Datei herzustellen. Einzelheiten finden Sie unter Connection Strings by database type.

      Anmerkung: Um über ODBC auf eine Datenbank zuzugreifen, müssen Sie zunächst einen 32-Bit-ODBC-Treiber auf Ihrem Gerät installieren.

      Parameter: Sie können die Anmeldedatenwerte aus dem Anmeldedaten-Locker verwenden, ohne die Anmeldedaten (Nutzername oder Passwort) im Klartext in der Verbindungszeichenfolge zu veröffentlichen. Dazu müssen Sie zunächst die Anmeldedaten in der Anmeldedaten-Zuordnung zuordnen und den Parameternamen in der Verbindungszeichenfolge in doppelten geschweiften Klammern verwenden.

      Wenn der Parametername zum Beispiel db_username lautet und der Parameterwert aus dem Anmeldedatenwert ausgewählt wird, lautet die Verbindungszeichenfolge mit drei Parametern “Provider=SQLOLEDB.1;Initial Catalog=master;Password={{db_credentials}};Persist Security Info=True;User ID={{db_username}};Data Source={{db_datasource}}”

      Führen Sie die folgenden Schritte aus, um das Passwort aus dem Anmeldedaten-Locker zu verwenden:
      1. Klicken Sie auf „Parameter hinzufügen“.
      2. Geben Sie den Parameternamen ein.
      3. Wählen Sie in Parameterwert Anmeldedaten, um einen im Anmeldedatentresor verfügbaren Wert zu verwenden, Variable, um eine Anmeldedatenvariable zu verwenden oder Unsichere Zeichenfolge, um den Wert manuell einzugeben, den Sie verwenden möchten.
      4. Klicken Sie auf Hinzufügen.

      Um eine Automatisierung mit besserer Sicherheit zu gewährleisten, verwenden Sie eine Credential Vault-Variable für die Verbindungszeichenfolge.

      Wählen Sie die Option ODBC-64-Bit-Treiber für Verbindung verwenden, um eine Verbindung zur Datenbank herzustellen.
      Anmerkung:
      • Vergewissern Sie sich, dass der 64-Bit-ODBC-Treiber auf dem System installiert ist, damit Sie auf eine beliebige Datenbank zugreifen und Operationen mithilfe von Datenbank-Aktionen durchführen können.
      • Die folgende Aktion bietet keine Unterstützung für die 32-Bit- oder 64-Bit-ODBC-Treiber, da die aufgeführten Aktionen für Datenbanktransaktionen bestimmt sind, die nach dem Herstellen einer Verbindung mit der Datenbank ausgeführt werden:
        • Datenbanktransaktion beginnen
        • Datenbanktransaktion beenden
        • Gespeicherte Prozedur verwalten
      • Wenn Sie Excel als Datenbank verwenden, können Sie mit 64-Bit-Treibern mehr Zeilen verarbeiten als mit 32-Bit-Treibern.
    • Wenn Sie die Option Nutzerdefiniert auswählen, wählen Sie den Datenbanktyp aus den verfügbaren Optionen aus und füllen Sie die folgenden Felder basierend auf der Auswahl aus:
      Datenbanktyp Optionen
      Microsoft SQL Server, PostgreSQL-Server
      • Servername: Geben Sie den Namen des Datenbankservers ein, mit dem Sie eine Verbindung herstellen möchten.
      • Datenbankname: Geben Sie den Datenbanknamen ein.
      • Nutzername: Geben Sie den Nutzernamen ein, den Sie für den Zugriff auf den Datenbankserver verwenden möchten. Um einen sicheren Nutzernamen zu gewährleisten, wählen Sie eine Credential Vault-Variable aus. Geben Sie andernfalls einen Wert ein.
      • Passwort: Geben Sie das Passwort für den von Ihnen angegebenen Nutzernamen ein. Um ein sicheres Kennwort zu gewährleisten, wählen Sie eine Credential Vault-Variable aus. Geben Sie andernfalls einen Wert ein.
      • Instanzname: Geben Sie einen Namen für diese Verbindungsinstanz ein.
      • Feld Zeitlimit in Sekunden (optional): Geben Sie die Zeitdauer von 1–9999 an, die vom System gewartet werden soll, bevor ein Bot beendet wird.

        Das Zeitlimit für die Automatisierung läuft ab und die Automatisierung schlägt fehl, wenn die Datenbankverbindung nicht innerhalb der angegebenen Zeit hergestellt wird. Wenn Sie im Feld Zeitlimit in Sekunden (optional) keinen Wert eingeben, wird das in der Treiberbibliothek angegebene Standardzeitlimit verwendet.

        Anmerkung: Microsoft SQL Server unterstützt nur diese Option.
      Herstellen einer Verbindung zu Microsoft SQL Server mit Windows-Authentifizierung
      MySQL Geben Sie die gleichen Optionen wie beim Microsoft SQL Server-Datenbanktyp ein. Geben Sie außerdem die Portnummer ein. Die Standard-Portnummer ist 3306.
      Microsoft Access, SQLite Wählen Sie den Datenbankdateipfad aus folgenden Optionen aus:
      • Bots-Ordner
      • Lokales Gerät
      • Vorhandene Dateivariable
      Oracle
      • Servername (optional): Geben Sie den Namen des Oracle-Servers ein, mit dem Sie eine Verbindung herstellen möchten.
      • Optional: Wählen Sie eine Option, um die zu verwendende Oracle-Instanz anzugeben:
        • System-ID (SID): Geben Sie die System-ID ein.
        • Servicename: Geben Sie den Servicenamen ein.
        • TNS-Name: Geben Sie den TNS-Namen ein, der in der Konfigurationsdatei tnsname.ora angegeben ist.

          Geben Sie den Dateipfad der Konfigurationsdatei tnsname.ora an, wenn Sie die Systemeigenschaft nicht mit einer Umgebungsvariablen festgelegt haben.

        Anmerkung: Sie können die Verbindung zur Oracle Database über den Servernamen oder die Oracle-Instanz herstellen. Wenn Sie eine Verbindung über den Servernamen herstellen, müssen Sie die System-ID (SID) oder den Servicenamen im Feld Oracle-Instanz angeben, um die Oracle-Datenbank und ihre Instanz zu identifizieren. Wenn Sie jedoch eine Verbindung über den TNS-Namen herstellen, müssen Sie keinen Wert in das Feld Servername eingeben. Sie sollten nur den Wert des TNS-Namens und den Dateipfad eingeben.
      • Nutzername: Geben Sie den Nutzernamen ein, den Sie für den Zugriff auf den Oracle-Server verwenden möchten. Um einen sicheren Nutzernamen zu gewährleisten, wählen Sie eine Credential Vault-Variable aus. Geben Sie andernfalls einen Wert ein.
      • Passwort: Geben Sie das Passwort für den von Ihnen angegebenen Nutzernamen ein. Um ein sicheres Kennwort zu gewährleisten, wählen Sie eine Credential Vault-Variable aus. Geben Sie andernfalls einen Wert ein.
      • Port: Geben Sie die Portnummer ein. Die Standard-Portnummer ist 1521.
      Anmerkung: Wenn Sie eine Verbindung über einen JDBC-Treiber herstellen, enthält das Datenbank-Paket bereits den JDBC-Treiber für Microsoft SQL Server. Für andere Datenbankserver müssen Sie jedoch die entsprechende JDBC-Treiber-Jar-Datei bereitstellen, nachdem Sie diese von den entsprechenden Ressourcen heruntergeladen haben.

      Wenn Sie eine Verbindung über einen ODBC-Treiber herstellen, müssen Sie keine jar-Datei bereitstellen.

  3. Wählen Sie eine Treiberdatei aus dem Ordner Bots, dem lokalen Gerät oder einer Dateivariablen aus.
  4. Wählen Sie eine der folgenden Registerkarten, um eine Datenbank-Sitzung zu erstellen:
    • Lokale Sitzung: Geben Sie einen Sitzungsnamen an, der nur vom aktuellen Bot verwendet werden kann.
    • Globale Sitzung: Geben Sie einen Sitzungsnamen an, der für mehrere Bots verwendet werden kann, wie z. B. übergeordnete Bots und untergeordnete Bots.
    • Variable: Geben Sie eine Sitzungsvariable vom Untertyp Datenbanksitzung an oder erstellen Sie eine solche.
  5. Klicken Sie auf Speichern.

Nächste Maßnahme

Wählen Sie eine der folgenden Optionen:
  • Verwenden Sie die Aktion Lesen aus, um Datensätze aus der Datenbank abzurufen.

    Verwenden der Aktion „Lesen aus“

  • Wenn Sie eine Aufgabe automatisieren, die Änderungen an der Datenbank beinhaltet, fügen Sie die Aktion Datenbanktransaktion starten ein.

    Diese Aktion stellt sicher, dass alle Datensätze vollständig aktualisiert oder gelöscht werden, und verhindert versehentliche Aktualisierungen oder Löschungen unvollständiger Daten, wenn der Bot während der Laufzeit auf einen Fehler stößt.

    Datenbank Paket