SQL-Datenbank

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

Sie müssen einen externen SQL-Server verwenden, um die Automation Suite- und UiPath®-Produkte zu installieren. Standard und Enterprise Editionen von Microsoft SQL Server 2017, 2019 und 2022 werden unterstützt.

Wichtig: Derzeit benötigen der Orchestrator und das AI Center die SQL Server-Version 2019 und höher, um optimal zu funktionieren.

Zusätzliche Microsoft SQL-Plattformen, wie z. B. Azure SQL Database, Azure SQL Managed Instance oder Amazon Relational Database Service werden ebenfalls unterstützt, sofern die Microsoft SQL Server Database-Engine die Anforderungen erfüllt. Weitere Informationen finden Sie in der Kompatibilitätsmatrix.

Hinweis:

Wenn Process Mining aktiviert ist und Sie die neueste Version von Airflow verwenden möchten, ist PostgreSQL für die AutomationSuite_Airflow -Datenbank erforderlich. (Version 2024.10.3 oder höher.)

Weitere Informationen finden Sie unter SQL-Anforderungen für Process Mining .

Hinweis:

Stellen Sie sicher, dass von den Clusterknoten aus auf den SQL-Server zugegriffen werden kann.

Die Unterstützung für einzelne Produkte ist jedoch unterschiedlich.

Für jedes Produkt, das Sie bereitstellen möchten, müssen Sie:

• Die vom Produkt unterstützte Version vom SQL Server überprüfen;
• die SQL Server-Konfigurationsanforderungen erfüllen, einschließlich der SQL Server-Benutzerberechtigungen, je nach Produktanforderungen.

Die Mindest-Hardwareanforderungen für Microsoft SQL Server sind folgende:

• 8 (v-)CPU
• 32 GB RAM
• 256-GB-SSD

Die Mindestanforderungen sind eine allgemeine Orientierung und garantieren keinen zuverlässigen Betrieb in einer Produktionsbereitstellung. Um die Hardwareanforderungen für einen zuverlässigen Betrieb zu bestimmen, ist eine Kapazitätsplanung erforderlich. Weitere Informationen finden Sie unter Kapazitätsplanung.

Jedes UiPath®-Produkt benötigt eine eigene SQL-Datenbank.

Workflow zur Datenbankerstellung

Das interaktive Installationsprogramm erstellt automatisch Datenbanken mit dem folgenden Workflow:

1. Das interaktive Installationsskript überprüft den Wert des Parameters sql.create_db in der Datei input.json .
   • Wenn der Parameter sql.create_db auf true festgelegt ist, generiert das Installationsprogramm automatisch alle Datenbanken in Ihrem Namen. In diesem Fall verwendet das Installationsprogramm die standardmäßigen Datenbanknamen und Standardvorlagen und ignoriert alle benutzerdefinierten Datenbanknamen, die Sie angegeben haben.

     Weitere Informationen finden Sie unter Automatisches Erstellen der erforderlichen Datenbanken.

   • Wenn sql.create_db auf false festgelegt ist, müssen Sie Ihre eigenen Datenbanken mitbringen. In diesem Fall müssen Sie Ihre Datenbanken manuell einrichten. Beachten Sie, dass Sie benutzerdefinierte Datenbanknamen verwenden können, sofern Sie die angegebenen Namenskonventionen einhalten. Dieser Schritt ist kritisch, da wir den Datenbanknamen in Verbindung mit der Verbindungsvorlage verwenden, um die Datenbankverbindungszeichenfolge zu bilden. Wenn Sie die empfohlene Namenskonvention nicht einhalten, müssen Sie die SQL-Verbindungszeichenfolgen selbst angeben.

     Weitere Informationen finden Sie unter Mitbringen Ihrer eigenen Datenbanken.

2. Das interaktive Installationsprogramm generiert die Verbindungszeichenfolgen wie folgt:

   • Wenn Sie keine Verbindungszeichenfolge für Ihren Dienst definiert haben, verwendet das Installationsprogramm die Verbindungsvorlage, um alle Datenbankverbindungszeichenfolgen zu generieren.

   • Wenn Sie eine Verbindungszeichenfolge für Ihren Dienst definiert haben, verwendet das Installationsprogramm die bereitgestellte Verbindungszeichenfolge für Ihre Datenbank.

Automatisches Erstellen der erforderlichen Datenbanken

Wenn das Installationsprogramm die Datenbanken erstellen soll, füllen Sie die folgenden Felder der Datei input.json aus:

Parameter	Beschreibung
sql.create_db	Legen Sie true fest, damit das Installationsprogramm die Datenbanken erstellen kann. Beachten Sie, dass das Installationsprogramm die standardmäßigen Datenbanknamen und Standardvorlagen verwendet und alle von Ihnen angegebenen benutzerdefinierten Datenbanknamen ignoriert.
sql.server_url	Der FQDN des SQL-Servers, auf dem das Installationsprogramm die Datenbank konfigurieren soll.
sql.port	Portnummer, auf der eine Datenbankinstanz auf dem SQL-Server gehostet werden soll.
sql.username	Der Benutzername/die UserID, um eine Verbindung mit dem SQL-Server herzustellen.
sql.password	Das Kennwort des zuvor angegebenen Benutzernamens, um eine Verbindung mit dem SQL-Server herzustellen.

Hinweis:

• Stellen Sie sicher, dass der Benutzer über die dbcreator-Rolle verfügt. Dadurch erhalten sie die Berechtigung zum Erstellen der Datenbank im SQL-Server. Andernfalls schlägt die Installation fehl.
• Das automatische Erstellen der erforderlichen Datenbanken funktioniert nicht in Kombination mit der Verzeichnisauthentifizierung. Wenn Sie die Verzeichnisauthentifizierung verwenden, müssen Sie Ihre eigenen Datenbanken mitbringen.
• Die ODBC-Verbindung unterstützt keine Benutzernamen, die Sonderzeichen enthalten. Verwenden Sie bei Datenbankbenutzernamen für AI Center, Document Understanding und Apps nur Groß- und Kleinbuchstaben.

Wichtig:

Für Process Mining auf der Automation Suite 2024.10.3 oder höher wird die Verwendung von PostgreSQL für die Airflow-Datenbank empfohlen. Wenn Sie eine PostgreSQL-Datenbank verwenden möchten, müssen Sie die PostgreSQL-Datenbank für AutomationSuite_Airflow manuell erstellen, bevor Sie die Automation Suite 2024.10.3 oder höher installieren oder ein Upgrade darauf durchführen. Die PostgreSQL-Datenbank für Airflow wird nicht automatisch vom Installationsprogramm erstellt.

Weitere Informationen finden Sie unter SQL-Anforderungen für Process Mining .

Nutzen Sie Ihre eigenen Datenbanken

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.

Wenn Sie Ihre eigene Datenbank mitbringen, müssen Sie die SQL-Verbindungszeichenfolgen für jede Datenbank angeben. Die Automation Suite unterstützt die folgenden Formate für SQL-Verbindungszeichenfolgen:

Hinweis: Stellen Sie bei Document Understanding sicher, dass Sie dieselbe Datenbank verwenden, sofern nicht ausdrücklich anders angegeben. Bestimmte Verbindungszeichenfolgen werden verschiedenen Diensten und Aufträgen zugewiesen, die eine Verbindung mit derselben Datenbank herstellen.

Parameter	Beschreibung	Produkte
sql_connection_string_template	Vollständige ADO.NET -Verbindungszeichenfolge, wobei der Katalogname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Plattform Orchestrator Automation Suite-Roboter Test Manager Automation Hub Automation Ops Insights Data Service Process Mining Document Understanding
sql_connection_string_template_jdbc	Vollständige JDBC -Verbindungszeichenfolge, wobei der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	AI Center
sql_connection_string_template_odbc	Vollständige ODBC-Verbindungszeichenfolge, bei der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Document Understanding Apps
sql_connection_string_template_sqlalchemy_pyodbc	Vollständige SQL-Alchemy PYODBC-Verbindungszeichenfolge, bei der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Document Understanding Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	Vollständige Zeichenfolge der SQL Alchemy PSYCOPG2- Verbindung, wobei der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Process Mining (2024.10.3 oder neuer)

Wichtig:

Stellen Sie sicher, dass das in den Verbindungszeichenfolgen angegebene SQL-Konto die db_owner-Rolle für alle Automation Suite-Datenbanken erhält. Wenn die Sicherheitsbeschränkungen die Verwendung von db_owner nicht zulassen, sollte das SQL-Konto über die folgenden Rollen und Berechtigungen für alle Datenbanken verfügen:

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• Berechtigung EXECUTE für das Schema „dbo“

Insights erfordert die Zuweisung der Rolle db_owner für eine erfolgreiche Installation.

Hinweis:

Standardmäßig ist TrustServerCertificate auf False festgelegt und Sie müssen ein zusätzliches Zertifizierungsstellenzertifikat für den SQL-Server bereitstellen. Dies ist erforderlich, wenn das SQL Server-Zertifikat selbstsigniert oder von einer internen Zertifizierungsstelle signiert wurde. Wenn Sie das SQL Server-Zertifikat in diesem Szenario nicht bereitstellen, schlägt die Voraussetzungsprüfung fehl.

Beispiel: sql_connection_string_template

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=[e-mail];Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;

Beispiel: sql_connection_string_template_jdbc

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

Beispiel: sql_connection_string_template_odbc

SERVER=sfdev1804627-c83f074b-sql.database.windows.net,1433;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"

Beispiel: sql_connection_string_template_sqlalchemy_pyodbc

mssql+pyodbc://testuser%40sfdev3082457-sql.database.windows.net:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Beispiel „postgresql_connection_string_template_sqlalchemy_pyodbc“ (Process Mining)

postgresql+psycopg2://<user>:<password>@<host>:<port>/DB_NAME_PLACEHOLDER

Beispiel: sql_connection_string_template und postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

"sql_connection_string_template": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=[e-mail];Password='07<l[xj-=~:z`Ds&nl';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;"

"postgresql_connection_string_template_sqlalchemy_pyodbc ": 
"postgresql+psycopg2://<user>:<password>@sfdev4515230-postgresql.database.windows.net:5432/DB_NAME_PLACEHOLDER"

Beispiel: sql_connection_string_template und sql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

"sql_connection_string_template": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=[e-mail];Password='07<l[xj-=~:z`Ds&nl';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;"

"sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Standardmäßige und optionale DB-Namen für die Automation Suite-Dienste

{
  "orchestrator": "AutomationSuite_Orchestrator",
  "orchestrator_ta": "AutomationSuite_Orchestrator",
  "asrobots": "AutomationSuite_Orchestrator",
  "orchestrator_upd": "AutomationSuite_Platform",
  "platform": "AutomationSuite_Platform",
  "test_manager": "AutomationSuite_Test_Manager",
  "automation_ops": "AutomationSuite_Platform",
  "automation_hub": "AutomationSuite_Automation_Hub",
  "insights": "AutomationSuite_Insights",
  "dataservice": "AutomationSuite_DataService", 
  "aicenter": "AutomationSuite_AICenter",
  "documentunderstanding": "AutomationSuite_DU_Datamanager",
  "processmining_airflow": "AutomationSuite_Airflow",
  "processmining_metadata": "AutomationSuite_ProcessMining_Metadata",
  "processmining_warehouse": "AutomationSuite_ProcessMining_Warehouse",
  "apps": "AutomationSuite_Apps",
  
}

Hinweis:

Wenn Sie die Verbindungszeichenfolge für einen der genannten Dienste überschreiben möchten, legen Sie sql_connection_str für den spezifischen Dienst fest.

Sie müssen diese Datenbanken weiterhin manuell erstellen, bevor Sie das Installationsprogramm ausführen.

Überschreiben der Standardverbindungszeichenfolge für Orchestrator und die Plattform

{
  "orchestrator": {
    "sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=CustomOrchDB;Persist Security Info=False;User Id=[e-mail];Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;"
  },
  "platform": {
    "sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=CustomIDDB;Persist Security Info=False;User Id=[e-mail];Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;"
  }
}

Um die Datenbankverbindungszeichenfolgen für andere Produkte zu überschreiben, legen Sie sql_connection_str in den entsprechenden Produktblöcken fest. Die Verbindungszeichenfolge muss ein vom jeweiligen Produkt unterstütztes Format haben.

Beispiel zum Festlegen der Datenbankverbindungszeichenfolge für das AI Center

Parameter	Beschreibung
aicenter.sql_connection_str	AI Center JDBC-Verbindungszeichenfolge

Hinweis: Stellen Sie sicher, dass die JDBC-Verbindungszeichenfolge das Format im folgenden Beispiel hat:

"aicenter": {
    "enabled": true,
    "sql_connection_str": "jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net;database=aicenter;user=[e-mail];password=TFgID_9GsE7_P@srCQp0WemXX_euHQZJ"
}

Beispiel für die Document Understanding-Verbindungszeichenfolge

"documentunderstanding": {
        "enabled": true,
        "sql_connection_str": "Server=SERVER_PLACEHOLDER;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=USER_PLACEHOLDER;Password='PASSWORD_PLACEHOLDER';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
        "datamanager": {
            "sql_connection_str": "SERVER=SERVER_PLACEHOLDER;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=USER_PLACEHOLDER;PWD={PASSWORD_PLACEHOLDER};;Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;hostNameInCertificate=customer-sql.database.windows.net",
            "pyodbc_sql_connection_str": "mssql+pyodbc://testadmin%40sql.database.windows.net:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
        }
    }

Hinweis: Die SQL-Verbindungszeichenfolge vom Data Manager ist nur optional, wenn Sie die Standardzeichenfolge mit Ihrer eigenen überschreiben möchten.

Beispiel für die Process Mining-Verbindungszeichenfolge (PostgreSQL)

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },
    "warehouse": {
      "sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=AutomationSuite_Warehouse;Persist Security Info=False;User Id=testadmin;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin:<password>@kerberossql.autosuitead.local:1433/AutomationSuite_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;User Id=testadmin;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
    }
    "sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Metadata;User Id=[e-mail];Password='password';Persist Security Info=False;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
  }

Beispiel für die Process Mining-Verbindungszeichenfolge (SQL Server)

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "warehouse": {
        "sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;User Id=[e-mail];Password='password';Persist Security Info=False;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
	    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>:@sfdev4515230-sql.database.windows.net:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
        "master_sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=master;Persist Security Info=False;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
    },
    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES"
    "sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Metadata;User Id=[e-mail];Password='password';Persist Security Info=False;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",  
},

Hinweis:

Verwenden Sie bei Verwendung der Kerberos-Authentifizierung die Parameter Integrated Security und Trusted_Connection . Wenn Sie Integrated Security auf true und Trusted_Connection auf yes setzen, werden die Anmeldeinformationen des aktuell angemeldeten Benutzers für die Verbindung verwendet. In diesem Fall müssen Sie keinen separaten Benutzernamen und kein Kennwort angeben.

Wichtig:

Beachten Sie, dass die Namen für die PYODBC-Verbindungszeichenfolge postgresql_connection_string_template_sqlalchemy_pyodbc (für PostgreSQL) bzw. sql_connection_string_template_sqlalchemy_pyodbc (für MS SQL Server) und die PYODBC-Verbindungszeichenfolge sqlalchemy_pyodbc_sql_connection_str , die Sie verwenden, wenn Sie Ihre eigene Datenbank mitbringen, unterschiedlich sind. Auch die Namen der Verbindungszeichenfolgen für die SQL-Vorlagen sql_connection_string_template und sql_connection_str die verwendet werden, wenn Sie Ihre eigene Datenbank mitbringen, sind unterschiedlich.

Wichtig:

Wenn Sie Ihre eigene Datenbank mitbringen und diese mithilfe der Verbindungszeichenfolgen sql_connection_str und sqlalchemy_pyodbc_sql_connection_str im Abschnitt processmining der Datei input.jsonkonfiguriert haben, dann werden die Vorlagenverbindungszeichenfolgen sql_connection_string_template bzw. postgresql_connection_string_template_sqlalchemy_pyodbc (für PostgreSQL) verwendet sql_connection_string_template_sqlalchemy_pyodbc (für MS SQL Server) werden ignoriert, wenn angegeben.

Achtung:

Legen Sie MultiSubnetFailover=True für sql_connection_str und master_sql_connection_str und MultiSubnetFailover=Yes für sqlalchemy_pyodbc_sql_connection_str -Verbindungszeichenfolgen fest.

Beachten Sie, dass Sie für pyodbc '=Yes' anstatt '=True' verwenden.

Hinweis: Je nach Einstellung von app_security_mode="single_account" wird entweder ein neuer SQL-Benutzer für jede Process Mining-App vom System erstellt (app_security_mode), oder es wird ein einzelnes SQL-Benutzerkonto erstellt, das für alle Prozess-Apps verwendet wird (app_security_mode="system_managed"). Beachten Sie, dass app_security_mode="system_managed" die Standardeinstellung ist und erweiterte Berechtigungen für den Datenbankbenutzer erfordert.

Siehe Konfigurieren der Prozess-App-Sicherheit.

Beispiel für die Process Mining-Verbindungszeichenfolge

• Szenario: Einrichtung mit Kerberos-Authentifizierung (PostgreSQL)

"processmining": {
    "enabled": true,
    "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://kerberos_user:@kerberospostgres.AUTOSUITEAD.LOCAL:5432/automationsuite_airflow"
    }
    "warehouse": {
        "sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
        "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes",
        "master_sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
      },
  },

• Szenario: Einrichtung mit Kerberos-Authentifizierung (Microsoft SQL Server).

"processmining": {
    "enabled": true,
    "warehouse": {
        "sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
        "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes",
        "master_sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
      },
    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes"
  },

Beispiel für die Process Mining-Verbindungszeichenfolge

• Szenario: Metadatendatenbank und Data Warehouse verwenden separaten SQL-Server (Authentifizierung ohne Kerberos).

"processmining": {
    "enabled": true,
    "warehouse": {
      "sql_connection_str": "Server=tcp:uipath-integration1.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;Persist Security Info=False;User Id=userid;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://userid:[e-mail]:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:uipath-integration1.database.windows.net,1433;Initial Catalog=master;Persist Security Info=False;User Id=userid;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
    },
    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://userid:[e-mail]:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES"
    "sql_connection_str": "Server=tcp:uipath-integration2.database.windows.net,1433;Initial Catalog=AutomationSuite_Airflow;Persist Security Info=False;User Id=userid;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",  
},

Beispiel für die Process Mining-Verbindungszeichenfolge

• Szenario: Verwenden eines benutzerdefinierten app_security_mode.

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "warehouse": {
        "sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
        "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes",
        "master_sql_connection_str": "Server=tcp:assql2019.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
      },
    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=YES"
  },

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.

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 SQL Server. Hier können Sie alle Komponenten überprüfen, die SQL Server hinzugefügt werden können, 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.

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

Data Service erfordert SQL Server-Version 2016 oder höher.

Wenn Sie Ihre eigene Datenbank mit SQL Server-Version 2019 oder höher erstellen, stellen Sie sicher, dass Sie Ihren Benutzern die folgenden Data Service-Berechtigungen gewähren:

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

SQL-Anforderungen für Process Mining

Wenn Sie Process Mining für die Installation auf der Automation Suite 2024.10.3 oder höher aktivieren, können Sie entweder eine PostgreSQL-Datenbank oder eine Microsoft SQL Server-Datenbank für AutomationSuite_Airflow einbringen.

Wichtig:

Für Process Mining auf Automation Suite 2024.10.3 oder höheren Versionen wird empfohlen, für die AutomationSuite_Airflow -Datenbank zu PostgreSQL zu wechseln, da PostgreSQL mit den neuesten Versionen von Apache Airflow ausgeführt wird. Wenn Sie die neueste Version von Airflow ausführen, stellen Sie sicher, dass Sie neue Funktionen, Leistung und Sicherheitskorrekturen verwenden können.

Wenn Sie keine PostgreSQL-Datenbank verwenden und weiterhin eine Microsoft SQLServer-Datenbank verwenden möchten, wird Process Mining auf der Automation Suite mit dem Legacy-Airflow ausgeführt. Bei älteren Versionen von Apache Airflow fehlen möglicherweise Funktionen, Leistung und Sicherheitskorrekturen.

Ab Process Mining auf der Automation Suite 2025.10 wird nur die PostgreSQL-Datenbank für die AutomationSuite_Airflow -Datenbank unterstützt.

AutomationSuite_Airflow PostgreSQL-Datenbank

Bei Process Mining auf Automation Suite 2024.10.3 oder höheren Versionen können Sie eine PostgreSQL-Datenbank für die AutomationSuite_Airflow -Datenbank verwenden.

Achtung:

Bevor Sie Automation Suite 2024.10.3 oder höher installieren oder aktualisieren, müssen Sie die PostgreSQL-Datenbank für AutomationSuite_Airflow manuell erstellen. Die PostgreSQL-Datenbank für Airflow wird nicht automatisch vom Installationsprogramm erstellt.

Hinweis:

Bei der Migration von Microsoft SQL Server zu PostgreSQL ist keine Datenbankdatenmigration erforderlich. Mit einer korrekten Konfigurationseinrichtung 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: 64 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.

• „all gewähren“ im öffentlichen 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 .

Hinweis:

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

AutomationSuite_Airflow Microsoft SQL Server-Datenbank

Hinweis:

Für die Datenbank AutomationSuite_Airflow ist Microsoft SQL Server die einzige Option, die für Process Mining auf Automation Suite-Version 2024.10.2 und früher verfügbar ist. Für Process Mining auf Automation Suite 2024.10.3 oder höheren Versionen wird empfohlen, zu PostgreSQL zu wechseln.

Wenn Sie Microsoft SQL Server für die AutomationSuite_Airflow -Datenbank verwenden, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen.

Wichtig:

Sie müssen den Standardserverport 1433 für Airflow-Datenbankverbindungen verwenden.

Nicht standardmäßige SQL Server-Ports werden nicht unterstützt.

Achtung:

Stellen Sie beim Einrichten von Microsoft SQL Server sicher, dass die Zeitzone der SQL Server-Maschine, auf der die Airflow-Datenbank installiert ist, auf UTC festgelegt ist.

AutomationSuite_ProcessMining_Warehouse Datenbank

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.

  Hinweis: In einer Entwicklungsumgebung wird aus Leistungsgründen empfohlen, an 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 für die Einrichtung 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 während und nach der Installation die Rolle db_securityadmin auf Datenbankebene 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.

Weitere Informationen finden Sie unter Konfigurieren der Prozess-App-Sicherheit .

SQL-Anforderungen für das AI Center

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 input.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. zum Vertrauensspeicher der Hostmaschine hinzu. 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.

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

SELECT is_read_committed_snapshot_on FROM sys.databases
   WHERE name= 'UiPath'

Wenn sie aktiviert ist, ist der zurückgegebene Wert 1.

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

ALTER DATABASE UiPath
SET READ_COMMITTED_SNAPSHOT ON

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