Schritt 5: Konfigurieren von SQL-Datenbanken

SQL-Datenbankanforderungen, unterstützte Versionen und Datenbankkonfigurationsoptionen pro Produkt in der Automation Suite.

Datenbanken

Wichtig:

• Nur Microsoft ODBC-Treiber 17 wird unterstützt.
• Automation Suite-Versionen 2.2510.0 und höher sind mit SQL-Versionen 2019 und höher kompatibel.

Sofern in den entsprechenden Anforderungsabschnitten nicht anders angegeben, gelten diese Anforderungen für alle Automation Suite-Produkte.

Jedes Produkt in der Automation Suite benötigt eine eigene SQL-Datenbank mit entsprechenden Spezifikationen.

Standardmäßig erstellt das Installationsprogramm während des Installationsvorgangs alle Datenbanken für Sie. Sie müssen dazu die erforderlichen Berechtigungen für das Installationsprogramm auf Ihrem SQL-Server zur Verfügung stellen.

Alternativ können Sie eigene Datenbanken erstellen. In der folgenden Tabelle sind die Datenbanknamen und ihre entsprechenden Formate aufgeführt.

Produkt/Dienst	Standard-Datenbankname	Format der Verbindungszeichenfolge
Gemeinsame Plattformfunktionen	AutomationSuite_Platform	ADO.NET
Orchestrator	AutomationSuite_Orchestrator	ADO.NET
Action Center	AutomationSuite_Orchestrator	ADO.NET
Automation Suite-Roboter	AutomationSuite_Orchestrator	ADO.NET
Automation Hub	AutomationSuite_Automation_Hub	ADO.NET
Automation Ops	AutomationSuite_Platform	ADO.NET
Data Service	AutomationSuite_DataService	ADO.NET
Insights	AutomationSuite_Insights	ADO.NET
Test Manager	AutomationSuite_Test_Manager	ADO.NET
AI Center	AutomationSuite_AICenter	JDBC
Integration Service	AutomationSuite_Integration_Services 1	JDBC
Apps	AutomationSuite_Apps 1	ODBC
Document Understanding	AutomationSuite_DU_Datamanager	ODBC PYODBC
Process Mining2	AutomationSuite_ProcessMining_Metadata AutomationSuite_ProcessMining_Warehouse3 AutomationSuite_Airflow4	ADO.NET PYODBC PSYCOPG2
Solutions (Lösungen)	AutomationSuite_AutomationSolutions	ADO.NET

¹ Das Kennwort für die Apps- und Integration Service-Datenbanken darf nicht #{ als Paar enthalten.

²Um Latenzprobleme zu minimieren, wird dringend empfohlen, die Process Mining-Datenbanken in der gleichen Region wie die Rechenressource (Kubernetes-Cluster) bereitzustellen.

³AutomationSuite_ProcessMining_Warehouse verwendet sowohl das ADO.NET- als auch das PYODBC-Format.

⁴AutomationSuite_Airflow Die PostgreSQL-Datenbank verwendet das SQLAlchemy-Verbindungszeichenfolgenformat. Die Verbindung zur AutomationSuite_Airflow -Datenbank darf nicht mit dem Zeichen { beginnen.

Wenn Sie eigene Datenbanken für eine neue Automation Suite-Installation einsetzen möchten, empfehlen wir dringend, neue Datenbanken einzurichten, anstatt vorhandene zu verwenden. Diese Vorsichtsmaßnahme ist notwendig, um Konflikte mit dem Betrieb der Automation Suite zu vermeiden, die aufgrund von übrig gebliebenen Metadaten aus alten Datenbanken auftreten können.

Sie können die Datenbanken auch in einem Pool für elastische Datenbanken verwenden, um die Kosteneffizienz zu erhöhen.

Wenn Sie die Verbindungszeichenfolgen manuell in der Konfigurationsdatei festlegen, können Sie SQL-, JDBC- oder ODBC-Kennwörter wie folgt maskieren:

• für SQL: Fügen Sie ' am Anfang und Ende des Kennworts hinzu und verdoppeln Sie alle anderen ' .
• für JDBC/ODBC: Fügen Sie { am Anfang des Kennworts und } am Ende hinzu, und verdoppeln Sie alle anderen } .

Hinweis:

Wenn Ihr Kennwort reservierte URL-Zeichen enthält, ersetzen Sie jedes Sonderzeichen durch das in Prozent codierte Entsprechung in der Verbindungszeichenfolge. Wenn Ihr Kennwort beispielsweise P@ssw0rd#1! ist, müssen Sie es als P%40ssw0rd%231%21 codieren.

SQL-Zusammenstellung

Die Automation Suite unterstützt die SQL-Sortierung, die sowohl auf Server- als auch auf Datenbankebene auf SQL_Latin1_General_CP1_CI_AS festgelegt ist. Wir empfehlen dringend dieses spezielle Setup für optimale Leistung und Stabilität.

Sie können zwar eine Sortierreihenfolge Ihrer Wahl verwenden, aber beachten Sie, dass ungetestete Konfigurationen möglicherweise zu unerwarteten Problemen führen können.

Wichtig:

Es wird nicht empfohlen, binäres SQL oder Kollationen zu verwenden, bei denen die Groß- und Kleinschreibung beachtet wird, da diese bei der Installation der Automation Suite zu bekannten Problemen führen.

Berechtigungen

Wenn das Installationsprogramm eine Datenbank auf dem angegebenen SQL-Server erstellen soll, dann stellen Sie sicher, dass Sie dem SQL-Konto, das zum Herstellen einer Verbindung mit der Datenbank verwendet wird, mindestens die Rolle dbcreator gewähren.

Wenn Sie für alle Produkte Ihre eigenen Datenbanken erstellen möchten, müssen Sie dem SQL-Konto die Rolle db_owner für alle Automation Suite-Datenbanken gewähren.

Wenn die Sicherheitsbeschränkungen die Verwendung von db_owner nicht zulassen, muss das SQL-Konto über die folgenden Rollen und Berechtigungen für alle Databases verfügen (die einzige Ausnahme ist Insights, das immer noch db_owner erfordert).

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• EXECUTE -Berechtigung für dbo, dt, authz und msgbus-Schema

Die Rollen db_securityadmin und db_ddladmin werden nur während der Installation oder bei einer Neubereitstellung von Datenbanken benötigt; Sie können sie später widerrufen.

SQL Server-Verschlüsselungen

Nur die aufgeführten SQL-Verschlüsselungen werden in der Automation Suite unterstützt:

• TLS_AES_256_GCM_SHA384
• TLS_CHACHA20_POLY1305_SHA256
• TLS_AES_128_GCM_SHA256
• TLS_AES_128_CCM_SHA256
• ECDHE-ECDSA-AES256-GCM-SHA384
• ECDHE-RSA-AES256-GCM-SHA384
• ECDHE-ECDSA-CHACHA20-POLY1305
• ECDHE-RSA-CHACHA20-POLY1305
• ECDHE-ECDSA-AES256-CCM
• ECDHE-ECDSA-AES128-GCM-SHA256
• ECDHE-RSA-AES128-GCM-SHA256
• ECDHE-ECDSA-AES128-CCM
• ECDHE-ECDSA-AES128-SHA256
• ECDHE-RSA-AES128-SHA256
• ECDHE-ECDSA-AES256-SHA
• ECDHE-RSA-AES256-SHA
• ECDHE-ECDSA-AES128-SHA
• ECDHE-RSA-AES128-SHA
• AES256-GCM-SHA384
• AES256-CCM
• AES128-GCM-SHA256
• AES128-CCM
• AES256-SHA256
• AES128-SHA256
• AES256-SHA
• AES128-SHA
• DHE-RSA-AES256-GCM-SHA384
• DHE-RSA-CHACHA20-POLY1305
• DHE-RSA-AES256-CCM
• DHE-RSA-AES128-GCM-SHA256
• DHE-RSA-AES128-CCM
• DHE-RSA-AES256-SHA256
• DHE-RSA-AES128-SHA256
• DHE-RSA-AES256-SHA
• DHE-RSA-AES128-SHA
• PSK-AES256-GCM-SHA384
• PSK-CHACHA20-POLY1305
• PSK-AES256-CCM
• PSK-AES128-GCM-SHA256
• PSK-AES128-CCM
• PSK-AES256-CBC-SHA
• PSK-AES128-CBC-SHA256
• PSK-AES128-CBC-SHA
• DHE-PSK-AES256-GCM-SHA384
• DHE-PSK-CHACHA20-POLY1305
• DHE-PSK-AES256-CCM
• DHE-PSK-AES128-GCM-SHA256
• DHE-PSK-AES128-CCM
• DHE-PSK-AES256-CBC-SHA
• DHE-PSK-AES128-CBC-SHA256
• DHE-PSK-AES128-CBC-SHA
• ECDHE-PSK-CHACHA20-POLY1305
• ECDHE-PSK-AES256-CBC-SHA
• ECDHE-PSK-AES128-CBC-SHA256
• ECDHE-PSK-AES128-CBC-SHA
• RSA-PSK-AES256-GCM-SHA384
• RSA-PSK-CHACHA20-POLY1305
• RSA-PSK-AES128-GCM-SHA256
• RSA-PSK-AES256-CBC-SHA
• RSA-PSK-AES128-CBC-SHA256
• RSA-PSK-AES128-CBC-SHA

SQL-Voraussetzungen für die Volltextsuche

Für Document Understanding muss der SQL-Server über die Volltextsuchkomponente der SQL Server Datenbank-Engine verfügen, die nicht immer standardmäßig installiert ist.

Wenn Sie bei der Installation von SQL Server keine Volltextsuche ausgewählt haben, führen Sie das SQL Server-Setup erneut aus, um es hinzuzufügen, bevor Sie Document Understanding konfigurieren.

Weitere Informationen finden Sie im Handbuch zum Hinzufügen/Installieren von Funktionen auf dem SQL Server. Sie finden auch eine vollständige Liste der SQL Server-Komponenten, einschließlich der Volltextsuche.

SQL-Voraussetzungen für Insights

Hinweis:

Insights unterstützt keine Azure AD-Authentifizierung. Wenn Sie sich mit Azure AD authentifizieren, können Dashboards nicht geladen und Daten nicht aus der Microsoft SQL-Datenbank abgerufen werden.

Insights erfordert den SQL Server 2019 oder 2022, einschließlich Unterstützung für den Spaltenspeicherindex und .json -Funktionen. SQL Server Enterprise wird aufgrund von effizienterem Threading und Skalierbarkeit empfohlen.

Stellen Sie bei Azure SQL sicher, dass die Datenbank das Dienstziel S3 oder höher ist.

Stellen Sie sicher, dass die Kompatibilitätsstufe für die Insights-Datenbank auf 130 oder höher festgelegt ist. In den meisten Fällen erfüllen die Standardeinstellungen diese Anforderung. Weitere Informationen finden Sie unter Anzeigen und Ändern des Kompatibilitätsgrads einer Datenbank – SQL Server.

Die Installation überprüft sowohl Bedingungen als auch Warnungen, wenn Mindestanforderungen nicht erfüllt sind.

SQL-Anforderungen für Data Service

Wenn Sie Ihre eigene Datenbank erstellen, stellen Sie sicher, dass Sie Ihren Benutzern die folgenden Data Service-Berechtigungen gewähren:

• db_ddladmin
• db_datareader
• db_datawriter

GRANT ALTER ANY SENSITIVITY CLASSIFICATION TO {userName};
GRANT VIEW ANY SENSITIVITY CLASSIFICATION TO {userName};

SQL-Anforderungen für Process Mining

Wichtig:

In den Automation Suite-Versionen 2.2510.0 und 2.2510.1 können Sie keinen benutzerdefinierten Datenbanknamen für die Plattformdatenbank verwenden, wenn Process Mining aktiviert ist. Wenn Sie einen benutzerdefinierten Namen angeben, schlägt der OMS-Abgleichauftrag fehl.

Um dies zu vermeiden, verwenden Sie AutomationSuite_Platform als Plattform-Datenbanknamen bei der Installation von Process Mining.

Wenn Sie Process Mining für die Installation in der Automation Suite aktivieren, müssen Sie eine PostgreSQL-Datenbank für AutomationSuite_Airflow bereitstellen. PostgreSQL ist der einzige unterstützte Datenbanktyp für AutomationSuite_Airflow.

AutomationSuite_Airflow PostgreSQL-Datenbank

Hinweis:

Vor der Installation oder dem Upgrade der Automation Suite 2.2510 müssen Sie die PostgreSQL-Datenbank für AutomationSuite_Airflow manuell erstellen. Die PostgreSQL-Datenbank für Airflow wird nicht automatisch vom Installationsprogramm erstellt.

Bei der Migration von Microsoft SQL Server zu PostgreSQL ist keine Datenmigration erforderlich. Bei einer korrekten Konfiguration wird die Datenbank beim Ausführen von Sync Airflow neu erstellt.

Unterstützte PostgreSQL-Versionen

Die PostgreSQL-Versionen 12.x bis 16.x werden unterstützt. Es wird empfohlen, die neueste Version von PostgreSQL innerhalb dieses Bereichs für optimale Kompatibilität und Leistung zu verwenden.

Hardwareanforderungen

Die Maschine, auf der die PostgreSQL-Datenbank für Airflow installiert ist, muss die folgenden Hardware-Anforderungen erfüllen.

• Kerne: 4
• Speicher: 16 GiB
• Speicher: 128 GiB
• IOPS: >= 500 IOPS

Erforderliche Berechtigungen

Der PostgreSQL Airflow-Benutzer (oder ein dedizierter Datenbankbenutzer) muss verfügen

• Berechtigungen „Alle Berechtigungen“ für die angegebene Airflow-Datenbank.
• „Alle Gewährungen“ für das öffentliche Schema des Servers.
• „search_path“ ist auf „public“ festgelegt.

Hinweis:

Möglicherweise müssen Sie die hostbasierte Authentifizierungsdatei pg_hba.conf von PostgreSQL aktualisieren, um den Airflow-Benutzer zur Zugriffskontrollliste der Datenbank hinzuzufügen, und die Datenbankkonfiguration neu laden, um die Änderungen zu übernehmen.

Der folgende Code zeigt ein Beispiel für die Einrichtung einer PostgreSQL-Datenbank.

CREATE DATABASE airflow_db
  WITH ENCODING 'UTF8'
  LC_COLLATE='en_US.UTF-8'
  LC_CTYPE='en_US.UTF-8'
  TEMPLATE template0;

CREATE USER airflow_user WITH PASSWORD 'airflow_pass';
GRANT ALL PRIVILEGES ON DATABASE airflow_db TO airflow_user;

-- PostgreSQL 15 requires additional privileges:
GRANT ALL ON SCHEMA public TO airflow_user;

Der folgende Code zeigt ein Beispiel für die Validierung der Datenbankcodierung.

SELECT pg_encoding_to_char(encoding) AS encoding
FROM pg_database
WHERE datname = 'airflow_db';

Weitere Informationen zum Einrichten einer PostgreSQL-Datenbank für Airflow finden Sie in der offiziellen Airflow-Dokumentation.

Standardserverport

Der Standardserverport für Airflow-Datenbankverbindungen mit PostgreSQL ist 5432. Wenn Sie den PgBouncer-Verbindungspooler verwenden, wird häufig Port 6432 verwendet.

Die folgenden Codeblöcke zeigen einige Beispiele für Verbindungszeichenfolgen für PostgreSQL mit Port 5432.

Beispiel für die Verbindungszeichenfolge:

postgresql+psycopg2://testadmin:<password>@test-cu231009v3-postgresql.postgres.database.azure.com:5432/automationsuite_airflow

Beispielverbindungszeichenfolge für die Verwendung von Kerberos:

postgresql+psycopg2://kerberos_user:@kerberospostgres.AUTOSUITEAD.LOCAL:5432/automationsuite_airflow

Beispielverbindungszeichenfolge für die Verwendung der verwalteten Identität:

postgresql+psycopg2://testmanagedidentity:@test-postgresql-1.postgres.database.azure.com/airflow-ci-sfasaksqacu8524745

Der Standardserverport kann so konfiguriert werden, dass er einen beliebigen verfügbaren Port gemäß Ihren Systemanforderungen verwendet.

PgBouncer

Da Airflow kurzfristige Verbindungen verwendet, wird dringend empfohlen, PgBouncer einzurichten. PgBouncer ist ein einfacher Verbindungspooler für PostgreSQL.

Weitere Informationen zum Einrichten von PgBouncer finden Sie in der offiziellen PgBouncer-Dokumentation.

AutomationSuite_ProcessMining_Warehouse database

Process Mining in der Automation Suite erfordert einen separaten Microsoft SQL-Server für AutomationSuite_ProcessMining_Warehouse für die Datenspeicherung für Process Mining-Prozess-Apps.

Wichtig:

Um das ordnungsgemäße Funktionieren von Process Mining sicherzustellen, wird empfohlen, Microsoft SQL Server 2022 zu verwenden.

Dies ist eine Übersicht über die Hardwareanforderungen und Empfehlungen zum Einrichten einer Microsoft SQL Server-Datenbankmaschine für AutomationSuite_ProcessMining_Warehouse.

Um die Hardwareanforderungen zu berechnen, müssen Sie Folgendes angeben:

• der Anzahl der Ereignisse (Millionen) in Ihrem Prozess.
• die Anzahl der Fall- und Ereignisfelder in Ihren Ausgabedaten.

In einer Entwicklungsumgebung wird aus Leistungsgründen empfohlen, mit einem kleinen Entwicklungs-Dataset mit einer begrenzten Anzahl von Datensätzen zu arbeiten.

Sie können den Rechner der UiPath Automation Suite zur Installationsskalierung verwenden, um die Hardwareanforderungen zum Einrichten einer dedizierten Microsoft SQL Server-Maschine für Process Mining zu bestimmen. Wenn Sie Process Mining zum Produktabschnitt hinzufügen, werden die Mindestanforderungen für 1 dedizierten SQL-Server angezeigt. Weitere Informationen finden Sie unter Hardwareanforderungen.

Der in den Verbindungszeichenfolgen verwendete SQL-Benutzer muss die Rolle db_securityadmin auf Datenbankebene sowohl während als auch nach der Installation haben, um die App-spezifische Sicherheit auf dem Data-Warehouse-SQL-Server von Process Mining zu aktivieren. Weitere Informationen finden Sie in der offiziellen Microsoft-Dokumentation zu Rollen auf Datenbankebene und Konfigurieren der Prozess-App-Sicherheit.

Es wird empfohlen, die Groß-/Kleinschreibung von Tabellen- und Spaltennamen mit dem folgenden Befehl zu aktivieren:

ALTER DATABASE AutomationSuite_ProcessMining_Warehouse COLLATE SQL_Latin1_General_CP1_CS_AS

Dies verhindert Fehler beim Laden von Daten, die durch Spalten mit ähnlichen Namen verursacht werden, z. B. id und id. Dadurch wird auch sichergestellt, dass Textwerte, die sich nur in der Groß-/Kleinschreibung unterscheiden, als unterschiedlich behandelt werden. Zum Beispiel:

• 'activity 1' == 'activity 1'
• 'Activity 1' != 'activity 1'

Dies verhindert Duplizierungsprobleme in SQL-Transformationen.

SQL-Anforderungen für das AI Center

Anforderungen für das AI Center, das mit einem externen Orchestrator verbunden ist

Wenn Sie ein AI Center installieren, das sich mit einem externen Orchestrator verbindet, müssen Sie sicherstellen, dass Sie eine neue Datenbank mit dem Namen AutomationSuite_Platform für AI Events- und AI Storage-Dienste erstellen.

Wichtig:

Derzeit erfordert das AI Center die SQL Server-Version 2019 und höher, um optimal zu funktionieren.

Anforderungen für das AI Center, installiert auf einer FIPS 140-2-fähigen Maschine

Um das AI Center auf einer FIPS 140-2-fähigen Maschine zu installieren, führen Sie die folgenden Schritte aus:

1. Bevor Sie die Automation Suite-Installation starten, führen Sie die folgenden Schritte aus:

   1. Aktivieren Sie FIPS 140-2 auf der Maschine, auf der Sie Microsoft Server installieren möchten, indem Sie die Anweisungen von Microsoft befolgen.

   2. Installieren Sie Microsoft SQL-Server auf der FIPS 140-2-fähigen Maschine.

   3. Rufen Sie das Microsoft SQL Server-Zertifikat ab, indem Sie den folgenden Befehl vom SQL-Server oder einem beliebigen Server ausführen, der eine Verbindung zum SQL-Server mit dem konfigurierten SQL-Hostnamen herstellen kann:

      nmap -sV -p <port> -vv --script ssl-cert domain
      

2. Führen Sie während der Installation der Automation Suite die folgenden Schritte aus:

   1. Hängen Sie die folgenden Werte an die Verbindungszeichenfolge sql_connection_string_template_jdbc des AI Centers in der Datei cluster_config.json an: encrypt=true;trustServerCertificate=false;fips=true;.

      Beispiel:

      jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net:1433;database=DB_NAME_PLACEHOLDER;user=testadmin;password=***;encrypt=true;trustServerCertificate=false;fips=true;Connection Timeout=30;hostNameInCertificate=sfdev1804627-c83f074b-sql.database.windows.net"
      

      Weitere Informationen zur Datenbankkonfiguration finden Sie unter Erweiterte Installation und Aktualisieren der SQL-Datenbank.

   2. Fügen Sie das exportierte Zertifikat aus Schritt 1.c. hinzu. in den Vertrauensspeicher der Hostmaschine kopieren. Weitere Details finden Sie unter Aktualisieren der Zertifikate von Zertifizierungsstellen.

SQL-Anforderungen für HA

Für eine Hochverfügbarkeitskonfiguration Ihres SQL-Servers wählen Sie eine Always On-Verfügbarkeitsgruppe aus. Weitere Informationen finden Sie unter Übersicht über Always On-Verfügbarkeitsgruppen.

SQL-Voraussetzungen für den Orchestrator

Wichtig:

Um die Leistung zu steigern, Deadlocks zu vermeiden und Dirty Reads in SQL zu verhindern, stellen Sie sicher, dass die Option READ_COMMITTED_SNAPSHOT auf ON festgelegt ist.

Um die gleiche Warteschlange mit mehreren Robotern zu prozessieren und die Snapshot-Isolierung zu aktivieren, stellen Sie sicher, dass die Option ALLOW_SNAPSHOT_ISOLATION auf ON festgelegt ist.

Verwenden Sie diese Abfrage, um zu überprüfen, ob READ_COMMITTED_SNAPSHOT und ALLOW_SNAPSHOT_ISOLATION aktiviert oder deaktiviert sind:

SELECT is_read_committed_snapshot_on, snapshot_isolation_state FROM sys.databases
   WHERE name like 'PLACEHOLDER'

Ersetzen Sie PLAATZHALTER durch den Namen Ihrer Orchestrator-Datenbank.

Wenn die Einstellungen aktiviert sind, ist der zurückgegebene Wert 1.

Wenn die Einstellungen deaktiviert sind, ist der zurückgegebene Wert 0. Verwenden Sie diese Abfrage, um sie zu aktivieren:

# To enable READ_COMMITTED_SNAPSHOT
ALTER DATABASE <PLACEHOLDER>
SET READ_COMMITTED_SNAPSHOT ON

# To enable ALLOW_SNAPSHOT_ISOLATION
ALTER DATABASE <PLACEHOLDER>
SET ALLOW_SNAPSHOT_ISOLATION ON

Ersetzen Sie <PLACEHOLDER> durch Ihren Orchestrator-Datenbanknamen.

Wenn Sie verschiedene Datenbanken für die Testautomatisierung und/oder den Update-Server verwenden, müssen READ_COMMITTED_SNAPSHOT und ALLOW_SNAPSHOT_ISOLATION auch für diese aktiviert sein.