SQL-Datenbank

SQL-Datenbankanforderungen, Kompatibilität und Konfiguration für die Automation Suite auf EKS/AKS.

Wichtig:

Nur Microsoft ODBC-Treiber 17 wird unterstützt.

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. Microsoft SQL Server 2019 und 2022, Standard und Enterprise Editionen werden unterstützt.

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. Nähere Informationen finden Sie unter Kompatibilitätsmatrix.

Die folgenden Produkte erfordern zusätzlich zum Microsoft SQL-Server eine dedizierte PostgreSQL-Datenbank:

• Process Mining: AutomationSuite_Airflow. Weitere Informationen finden Sie unter SQL-Anforderungen für Process Mining.
• Maestro: AutomationSuite_Taas und AutomationSuite_Taas_Visibility. Weitere Informationen finden Sie unter SQL-Anforderungen für Temporal as a Service (TaaS).
• Autopilot for Developers (A4D): AutomationSuite_A4D. Weitere Informationen finden Sie unter SQL-Anforderungen für Autopilot for Developers (A4D).

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.

Hardwareanforderungen

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 dazu finden Sie unter Kapazitätsplanung.

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

Multi-AZ-Konfiguration

Wenn Sie ein Multi-AZ mit Always On SQL-Setup implementieren, bei dem Sie speziell einen Listener-Endpunkt verwenden, wie bei Amazon RDS, müssen Sie Ihren Verbindungszeichenfolgen den zusätzlichen Parameter MultiSubnetFailover hinzufügen.

Automation Hub unterstützt MultiSubnetFailover nicht.

Die MultiSubnetFailover -Parametereinstellungen unterscheiden sich je nach Typ der Verbindungszeichenfolge, wie in den folgenden Beispielen gezeigt:

• sql_connection_string_template: MultiSubnetFailover=Truefestlegen
• sql_connection_string_template_jdbc: multiSubnetFailover=truefestlegen
• sql_connection_string_template_odbc: MultiSubnetFailover=yesfestlegen
• sql_connection_string_template_sqlalchemy_pyodbc: MultiSubnetFailover=YESfestlegen

Der Parameter MultiSubnetFailover ermöglicht ein schnelles Failover zwischen mehreren IPs aus dem DNS-Eintrag während Netzwerk- oder Datenbankunterbrechungen.

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

Wichtig:

Für Process Mining in der Automation Suite müssen Sie die PostgreSQL-Datenbank für AutomationSuite_Airflow manuell erstellen, bevor Sie Automation Suite 2.2510 oder höher installieren oder aktualisieren. Die PostgreSQL-Datenbank für Airflow wird nicht automatisch vom Installationsprogramm erstellt.

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

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.

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 etwas anderes angegeben wird. Bestimmte Verbindungszeichenfolgen werden verschiedenen Diensten und Aufträgen zugewiesen, die eine Verbindung mit derselben Datenbank herstellen.

Vorlagen für Verbindungszeichenfolgen

Parameter	Beschreibung	Produkte
sql_connection_string_template	Vollständige ADO.NET-Verbindungszeichenfolge, in der 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 Integration Service Studio Web Data Service Process Mining Document Understanding LLM-Gateway LLM-Beobachtbarkeit ECS Solutions (Lösungen) Maestro Agents AgentHub
sql_connection_string_template_jdbc	Vollständige JDBC-Verbindungszeichenfolge, in der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	AI Center Integration Service
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 Integration Service
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
postgresql_connection_string_template_sqlalchemy_pyodbc	Vollständige SQL-Alchemy PSYCOPG2- 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.	Process Mining Temporal as a Service (TaaS)
postgresql_connection_string_template_sqlalchemy_asyncpg	Vollständige PostgreSQL-Verbindungszeichenfolge, in der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Autopilot for Developers

Wenn Sie die Verbindungszeichenfolgen manuell in der Konfigurationsdatei festlegen, können Sie SQL-, JDBC-, ODBC- oder PYODBC-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 } .
• Bei PYODBC: username und password müssen URL-codiert werden, um Sonderzeichen zu berücksichtigen. Kennwörter der Document Understanding-Datenbank dürfen nicht mit { beginnen.

In der AutomationSuite_ProcessMining_Airflow -Datenbank für das Process Mining-Produkt muss READ_COMMITTED_SNAPSHOT aktiviert sein.

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.

sql_connection_string_template

Das folgende Beispiel zeigt eine sql_connection_string_template -Verbindungszeichenfolge:

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;

sql_connection_string_template_jdbc

Das folgende Beispiel zeigt eine sql_connection_string_template_jdbc -Verbindungszeichenfolge:

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"

sql_connection_string_template_odbc

Das folgende Beispiel zeigt eine sql_connection_string_template_odbc -Verbindungszeichenfolge:

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;"

sql_connection_string_template_sqlalchemy_pyodbc

Das folgende Beispiel zeigt eine sql_connection_string_template_sqlalchemy_pyodbc -Verbindungszeichenfolge:

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

postgresql_connection_string_template_sqlalchemy_pyodbc

Das folgende Beispiel zeigt eine postgresql_connection_string_template_sqlalchemy_pyodbc -Verbindungszeichenfolge für Process Mining:

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

Kombinierte Process Mining-Vorlagen

Die folgenden Beispiele zeigen kombinierte Vorlagenkonfigurationen für 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"

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

Standarddatenbanknamen

Das folgende Beispiel zeigt die standardmäßigen und optionalen Datenbanknamen für 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",
  "integrationservices": "AutomationSuite_Integration_Services",
  "studioweb": "AutomationSuite_StudioWeb",
  "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",
  "llmgateway": "AutomationSuite_LLMGateway",
  "ecs": "AutomationSuite_ECS",
  "ecs_vector": "AutomationSuite_ECSVector",
  "llmobservability": "AutomationSuite_Llmops",
  "automationsolutions": "AutomationSuite_AutomationSolutions",
  "maestro": "AutomationSuite_Maestro",
  "taas": {
    "persistence store": "AutomationSuite_Taas",
    "visibility store": "AutomationSuite_Taas_Visibility"
  },
  "a4d": "AutomationSuite_A4D",
  "agents": "AutomationSuite_Agents",
  "agenthub": "AutomationSuite_AgentHub"
}

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.

Produktspezifische Überschreibungen von Verbindungszeichenfolgen

Um die Standardverbindungszeichenfolgen für bestimmte Produkte zu überschreiben, legen Sie die sql_connection_str im entsprechenden Produktblock fest. Die Verbindungszeichenfolge muss ein Format haben, das vom jeweiligen Produkt unterstützt wird.

Orchestrator und Plattform

Das folgende Beispiel zeigt, wie die Standardverbindungszeichenfolge für den Orchestrator und die Plattform überschrieben wird:

{
  "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;"
  }
}

AI Center

Das folgende Beispiel zeigt, wie die Datenbankverbindungszeichenfolge für das AI Center mithilfe des erforderlichen JDBC-Formats festgelegt wird:

"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"
}

Document Understanding

Das folgende Beispiel zeigt eine 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"
        }
    }

Die SQL-Verbindungszeichenfolge vom Data Manager ist optional; Geben Sie ihn nur an, wenn Sie den Standardwert überschreiben möchten.

Process Mining

Process Mining-Verbindungszeichenfolgen unterscheiden sich in folgenden Punkten von Vorlagenverbindungszeichenfolgen:

• Die Namen der Vorlagenverbindungszeichenfolgen (postgresql_connection_string_template_sqlalchemy_pyodbc, sql_connection_string_template) unterscheiden sich von den Namen der Bring-Your-Own-Datenbank (sqlalchemy_pyodbc_sql_connection_str, sql_connection_str).
• Wenn Sie Ihre eigene Datenbank mitbringen und sie mithilfe von sql_connection_str und sqlalchemy_pyodbc_sql_connection_str im Abschnitt processmining von input.json konfigurieren, werden die Vorlagenverbindungszeichenfolgen sql_connection_string_template und postgresql_connection_string_template_sqlalchemy_pyodbc ignoriert.

Die Einstellung steuert, wie SQL-Benutzer für Process Mining-Apps erstellt werden. app_security_mode Im Standardmodus app_security_mode="system_managed" wird für jede Process Mining-App ein neuer SQL-Benutzer erstellt, was erweiterte Berechtigungen für den Datenbankbenutzer erfordert. Im Modus app_security_mode="single_account" wird ein einzelnes SQL-Benutzerkonto für alle Prozess-Apps verwendet. Weitere Informationen finden Sie unter Konfigurieren der Prozess-App-Sicherheit.

Wenn Sie eine Multi-AZ mit Always On SQL-Setup verwenden, legen Sie den Parameter MultiSubnetFailover in Ihren Process Mining-Verbindungszeichenfolgen fest. Der Wert unterscheidet sich je nach Typ der Verbindungszeichenfolge: Verwenden Sie MultiSubnetFailover=True für sql_connection_str und master_sql_connection_str und MultiSubnetFailover=Yes für sqlalchemy_pyodbc_sql_connection_str. Beachten Sie, dass Sie für pyodbc „ =Yes“ anstelle von „ =True“ verwenden. Weitere Informationen finden Sie unter Multi-AZ-Konfiguration.

Verwenden Sie für die Kerberos-Authentifizierung die Parameter Integrated Security und Trusted_Connection anstelle eines Benutzernamens und eines Kennworts. Legen Sie Integrated Security auf true und Trusted_Connection auf yes fest, um sich mit den Anmeldeinformationen des derzeit angemeldeten Benutzers zu authentifizieren.

Das folgende Beispiel zeigt eine Process Mining Verbindungszeichenfolge für 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;",
  }

Das folgende Beispiel zeigt eine Process Mining-Verbindungszeichenfolge mit Kerberos-Authentifizierung für 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;"
      },
  },

Das folgende Beispiel zeigt eine Process Mining-Verbindungszeichenfolge mit separaten Metadaten- und Data Warehouse-Servern (Nicht-Kerberos-Authentifizierung):

"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;"
    },
  "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },
    "sql_connection_str": "Server=tcp:uipath-integration2.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Metadata;Persist Security Info=False;User Id=userid;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",  
},

Das folgende Beispiel zeigt eine Process Mining-Verbindungszeichenfolge mit einer 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;"
      },
   "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },

Studio Web

Das folgende Beispiel zeigt eine Studio Web-Verbindungszeichenfolge:

"studioweb": {
      "enabled": true,
      "sql_connection_str": "Server=tcp:ci-asaksdev7031068.database.windows.net,1433;Initial Catalog=AutomationSuite_StudioWeb;Persist Security Info=False;User Id=mssqladminun;Password='****';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
      },

Berechtigungen

Stellen Sie sicher, dass dem in den Verbindungszeichenfolgen angegebenen SQL-Konto die Rolle db_owner für alle Automation Suite-Datenbanken gewährt wird. 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:

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

Wir verwenden die Rollen db_securityadmin und db_ddladmin nur während der Installation oder wenn die Datenbanken neu bereitgestellt werden, sodass Sie diese Berechtigung später widerrufen können. Insights erfordert, dass die Rolle db_owner für eine erfolgreiche Installation zugewiesen wird.

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

Kontextgrundlage und Document Understanding erfordern, dass der SQL Server über die Volltextsuchkomponente der SQL Server-Datenbank-Engine verfügt, 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-Authentifizierung

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.

Azure Active Directory-basierter Zugriff auf SQL über AKS

Hinweis:

Insights und Studio Web unterstützen nicht die Authentifizierungskonfiguration von Microsoft Entra ID (früher Azure Active Directory) für den Zugriff auf SQL in den Automation Suite-Versionen 2.2510.0 und 2.2510.1.

Sie können über das Azure Active Directory vom AKS-Cluster aus auf den Microsoft SQL-Server zugreifen. Das folgende Beispiel zeigt einige Verbindungszeichenfolgen, die die AAD-Zugriffsmethode verwenden:

  "sql_connection_string_template": "Server=tcp:sfdev3888449-sql.database.windows.net,1433;Authentication=Active Directory Service Principal;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=5c6b8ff1-efb4-48ca-a530-f744f1d438df;Password='I5V8Q~srSTWf0onUYeHLK..qLO69pP7MZ3KIMaB2';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
  "sql_connection_string_template_jdbc": "jdbc:sqlserver://sfdev3888449-sql.database.windows.net;authentication=ActiveDirectoryServicePrincipal;database=DB_NAME_PLACEHOLDER;user=5c6b8ff1-efb4-48ca-a530-f744f1d438df;password={I5V8Q~srSTWf0onUYeHLK..qLO69pP7MZ3KIMaB2};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;",
  "sql_connection_string_template_odbc": "SERVER=sfdev3888449-sql.database.windows.net;Authentication=ActiveDirectoryServicePrincipal;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=5c6b8ff1-efb4-48ca-a530-f744f1d438df;PWD={I5V8Q~srSTWf0onUYeHLK..qLO69pP7MZ3KIMaB2};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;hostNameInCertificate=sfdev3888449-sql.database.windows.net",
  "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://5c6b8ff1-efb4-48ca-a530-f744f1d438df:I5V8Q~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server&authentication=ActiveDirectoryServicePrincipal",

Workload-identitätsbasierter Zugriff auf SQL über AKS

Allgemeine Informationen zur Workload-Identität finden Sie unter Konfiguration der Workload-Identität.

Um SQL Server für die Verwendung der Workload Identity einzurichten, führen Sie den folgenden Befehl aus:

az sql server ad-admin create --display-name test --object-id $userAssignedManagedIdentityObjectId -g $(TARGET_RG) -s $(TARGET_RG)

Das folgende Beispiel zeigt eine gültige SQL-Verbindungszeichenfolgevorlage:

"sql_connection_string_template":"Server=tcp:sql_dns_name,1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;Authentication=Active Directory Managed Identity;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;"
"sql_connection_string_template_jdbc":"jdbc:sqlserver://sql_dns_name;database=DB_NAME_PLACEHOLDER;authentication=ActiveDirectoryMSI;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;"
"sql_connection_string_template_sqlalchemy_pyodbc"://@sql_dns_name:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
"sql_connection_string_template_odbc": "SERVER=sql_dns_name;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};FEDAUTH=ActiveDirectoryDefault;Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;hostNameInCertificate=*.database.windows.net"

Wenn Sie Apps oder Automation Hub aktivieren, müssen Sie deren jeweilige SQL-Verbindungszeichenfolgen in der input.json -Datei überschreiben, um die Unterstützung von Workload-Identitäten sicherzustellen. Das folgende Beispiel zeigt ein Beispiel für solche Überschreibungen von SQL-Verbindungszeichenfolgen:

"apps": {
  "sql_connection_str": "Server=tcp:sql_dns_name,1433;Initial Catalog=AutomationSuite_Apps;Authentication=Active Directory Integrated;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
},
"automation_hub": {
  "sql_connection_str": "Server=tcp:sql_dns_name,1433;Initial Catalog=AutomationSuite_Automation_Hub;Authentication=Active Directory Integrated;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
},

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 Aktualisierung auf Automation Suite 2.2510 oder höher 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, 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. 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.

SQL-Voraussetzungen für Temporal as a Service (TaaS)

Wenn Maestro in der Automation Suite aktiviert ist, erfordert TaaS zwei dedizierte PostgreSQL-Datenbanken:

• Persistenzspeicher (AutomationSuite_Taas) – Speichert Daten und Verlauf der Workflow-Ausführung.
• Sichtbarkeitsspeicher (AutomationSuite_Taas_Visibility) – Speichert Workflow-Metadaten, die von der temporären UI und den Sichtbarkeits-APIs verwendet werden. Erfordert, dass die btree_gin -Erweiterung auf dem PostgreSQL-Server verfügbar ist.

Beide Datenbanken werden automatisch vom Installationsprogramm erstellt, wenn sql.create_db auf true festgelegt ist. Wenn Sie Ihre eigenen Datenbanken mitbringen, erstellen Sie beide, bevor Sie das Installationsprogramm ausführen. Die Standarddatenbanknamen finden Sie unter Standard- und optionale DB-Namen für Automation Suite-Dienste.

Um die Verbindungszeichenfolgen für TaaS zu überschreiben, verwenden Sie postgresql_connection_string_template_sqlalchemy_pyodbc. Das Format der Verbindungszeichenfolge finden Sie unter Mitbringen Ihrer eigenen Datenbanken.

Unterstützte PostgreSQL-Versionen

PostgreSQL-Versionen 12.x bis 16.x werden unterstützt.

Hardwareanforderungen

Formatieren Sie die TaaS PostgreSQL-Datenbank basierend auf dem Workflow-Volumen pro Tag. Für die Dimensionierung werden drei Komplexitätsprofile verwendet:

• Einfach – ungefähr 3 BPMN-Aufgaben pro Workflow
• moderat – ungefähr 25 BPMN-Aufgaben und 1 Teilprozess (5 Aufgaben)
• Komplex – ungefähr 100 BPMN-Aufgaben und 3 Teilprozesse (jeweils 5 Aufgaben)

Suchen Sie in einer beliebigen Spalte die Zeile, die Ihrer Workload entspricht (OR, nicht AND) und lesen Sie die Hardwareanforderungen auf der rechten Seite. Sie müssen nicht alle drei Spaltenschwellenwerte gleichzeitig erfüllen. Verwenden Sie für Workloads mit gemischter Komplexität den Kapazitätsrechner der Automation Suite – Beiträge über Komplexitätsstufen hinweg sind additiv.

CPU und RAM

In folgender Tabelle werden die CPU- und RAM-Anforderungen basierend auf dem täglichen Workflow-Volume und der Komplexität beschrieben:

Einfache Workflows/Tag	Mäßige Workflows/Tag	Komplexe Workflows/Tag	CPU	RAM
< 12.500	< 1.900	< 525	2 vCores	4 GB
12.500–125.000	1.900–19.200	525–5.275	4 vCores	8 GB
Über 125.000	Über 19.200	Über 5.275	8 vCores	16 GB

Datenträger und IOPS

Die Datenträgergröße hängt vom Workflow-Volume, der Komplexität und dem im Orchestrator konfigurierten Prozessaufbewahrungszeitraum ab. Verwenden Sie den Kapazitätsrechner der Automation Suite für eine Workload-gesteuerte Empfehlung. In folgender Tabelle sind die empfohlenen Datenträger und IOPS basierend auf Ihrer Dauergröße beschrieben:

Empfohlener Datenträger	IOPs
100 GB	500
150 GB	800
250 GB	1.110
500 GB	2.300
1 TB	5,000

Wichtig:

Premium SSD (oder gleichwertig) ist erforderlich. Standard-SSD kann den TaaS-Schreibdurchsatz über eine sehr geringe Last hinaus nicht aufrechterhalten.

Lesen Sie die Replikate

Optional – Empfohlen für Bereitstellungen mit hoher Verfügbarkeit.

Der PostgreSQL-Server muss mit den TaaS-Clusterkomponenten am selben Standort sein (z. B. im selben Rechenzentrum). Diese Anforderung gilt sowohl für die primäre Region als auch für alle passiven oder Failover-Regionen.

Verbindungsanforderungen

TaaS unterhält einen anwendungsseitigen Verbindungspool pro Pod. Die folgende Tabelle beschreibt den erforderlichen max_connections -Wert basierend auf Ihrem Bereitstellungsprofil und dem täglichen Workflow-Volume:

Einfache Workflows/Tag	Mäßige Workflows/Tag	Komplexe Workflows/Tag	Standard	Lite	HAA
< 12.500	< 1.900	< 525	200	200	400
12.500–125.000	1.900–19.200	525–5.275	200	400	500
Über 125.000	Über 19.200	Über 5.275	200	600	600

Wichtig:

Der Standardwert von PostgreSQL max_connections ist 100, was für ein TaaS-Profil nicht ausreicht. Verwenden Sie die obige Tabelle, um den erforderlichen Wert für Ihr Bereitstellungsprofil und Workflow-Volume zu bestimmen, und erhöhen Sie vor der Installation max_connections auf dem PostgreSQL-Server.

Verbindungsbeschränkungen

• TaaS unterstützt keine Verbindungen über pgBouncer.
• Nur die Authentifizierung mit Benutzername und Kennwort wird unterstützt. Workload Identity, Kerberos und IAM-Authentifizierung werden nicht unterstützt.

Optimieren des Verbindungspools

Die Standardeinstellungen für den Verbindungspool sind für die meisten Bereitstellungen geeignet. Wenn Ihre PostgreSQL-Instanz ein niedrigeres max_connections -Limit hat, überschreiben Sie die Standardeinstellungen mithilfe von advanced_configuration in input.json:

{
  "taas": {
    "enabled": true,
    "advanced_configuration": {
      "taas": {
        "temporal": {
          "server": {
            "config": {
              "persistence": {
                "default": {
                  "sql": {
                    "maxConns": 10,
                    "maxIdleConns": 10
                  }
                },
                "visibility": {
                  "sql": {
                    "maxConns": 10,
                    "maxIdleConns": 10
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Wichtig:

Wenn maxConns offengelegt wird, kann dies zu Timeouts bei der TaaS-Persistenz unter Last führen. Passen Sie diese Werte nur an, wenn Ihre PostgreSQL-Instanz die Standardverbindungsanforderungen nicht erfüllen kann.

SQL-Anforderungen für Autopilot for Developers (A4D)

Autopilot for Developers erfordert eine dedizierte PostgreSQL-Datenbank (AutomationSuite_A4D). A4D verwendet die Verbindungszeichenfolgevorlage postgresql_connection_string_template_sqlalchemy_asyncpg .

Hardwareanforderungen

In der folgenden Tabelle werden die Hardwareanforderungen für den A4D-PostgreSQL-Server beschrieben:

Ressource	Anforderungen
CPU	2 vCores
Arbeitsspeicher	8 GB RAM
Speicher	128 GB
IOPs	100

Verbindungsanforderungen

Der erforderliche max_connections -Wert auf dem PostgreSQL-Server ist 100.