Base de données SQL

Important : seul Microsoft ODBC Driver 17 est pris en charge.

Remarque : sauf indication contraire dans les sections exigences dédiées, ces exigences s'appliquent à tous les produits Automation Suite.

Vous devez ajouter un serveur SQL externe pour installer les produits Automation Suite et UiPath®. Les éditions Microsoft SQL Server 2016, 2017, 2019 et 2022 Standard et Enterprise sont prises en charge.

Attention : SQL Server 2016 et 2017 ne sont pas pris en charge dans les versions d'Automation Suite de 2023.10.6 à 2023.10.8. Toutes les versions de SQL sont prises en charge à partir des versions d’Automation Suite 2023.10.9 ou ultérieures pour toutes les applications à l’exception d’Insights.

Des plates-formes Microsoft SQL supplémentaires, telles qu'Azure SQL Database, Azure SQL Managed Instance ou Amazon Relational Database Service, sont également prises en charge du moment que le moteur de base de données Microsoft SQL Server répond aux exigences. Pour plus de détails, consultez Matrice de compatibilité.

Remarque :

Si Process Mining est activé et que vous souhaitez utiliser la dernière version de Airflow, PostgreSQL est requis pour la base de données AutomationSuite_Airflow . (Version 2023.10.9 ou supérieure.)

Reportez-vous aux exigences SQL pour Process Mining pour plus d'informations.

Remarque :

Assurez-vous que le serveur SQL est accessible à partir des nœuds du cluster.

Le support produit individuel est différent.

Pour chaque produit que vous envisagez de déployer, vous devez :

• vérifier la version prise en charge de SQL Server requise par le produit ;
• répondre aux exigences de configuration de SQL Server, y compris les autorisations d'utilisateur de SQL Server, tel que requis par le produit.

La configuration matérielle minimale générale requise pour Microsoft SQL Server est la suivante :

• 8 (v-)CPU
• 32 Go de RAM
• SSD de 256 Go

Les exigences minimales sont des indications générales et ne garantissent pas un fonctionnement fiable dans un déploiement de Production . La planification de la capacité est nécessaire pour déterminer la configuration matérielle requise pour un fonctionnement fiable. Pour plus de détails, consultez Planification des capacités.

Chaque produit UiPath® nécessite sa propre base de données SQL.

Workflow de création de base de données

Le programme d'installation interactif crée automatiquement des bases de données à l'aide du workflow suivant :

1. Le script d'installation interactif vérifie la valeur du paramètre sql.create_db dans le fichier input.json .
   • Si le paramètre sql.create_db est défini sur true, le programme d'installation génère automatiquement toutes les bases de données en votre nom. Dans ce cas, le programme d'installation utilise les noms de base de données par défaut et les modèles par défaut, et ignore tous les noms de base de données personnalisés que vous avez fournis.

     Pour plus de détails, consultez Créer automatiquement les bases de données nécessaires.

   • Si sql.create_db est défini sur false, vous devez apporter vos propres bases de données. Dans ce cas, vous devez configurer manuellement vos bases de données. Notez que vous pouvez utiliser des noms de base de données personnalisés, à condition de suivre les conventions d'affectation de nom fournies. Cette étape est essentielle car nous utilisons le nom de la base de données conjointement avec le modèle de connexion pour former la chaîne de connexion de la base de données. Si vous ne suivez pas la convention d’affectation de noms recommandée, vous devez fournir vous-même les chaînes de connexion SQL.

     Pour plus de détails, consultez Fournissez vos propres bases de données.

2. Le programme d'installation interactif génère les chaînes de connexion comme suit :

   • Si vous n’avez pas défini de chaîne de connexion pour votre service, le programme d’installation utilise le modèle de connexion pour générer toutes les chaînes de connexion de la base de données.

   • Si vous avez défini une chaîne de connexion pour votre service, le programme d’installation utilise la chaîne de connexion fournie pour votre base de données.

Créer automatiquement les bases de données nécessaires

Si vous souhaitez que le programme d'installation crée les bases de données, remplissez les champs suivants du fichier input.json :

Paramètre	Description
sql.create_db	Définissez sur true pour permettre au programme d'installation de créer les bases de données. Notez que le programme d'installation utilise les noms de base de données par défaut et les modèles par défaut, et ignore tous les noms de base de données personnalisés que vous avez fournis.
sql.server_url	Nom de domaine complet du serveur SQL, où vous souhaitez que le programme d'installation configure la base de données.
sql.port	Numéro de port sur lequel une instance de base de données doit être hébergée dans le serveur SQL.
sql.username	Nom d'utilisateur / ID d'utilisateur pour se connecter au serveur SQL.
sql.password	Mot de passe du nom d'utilisateur fourni précédemment pour se connecter au serveur SQL.

Remarque :

• Assurez-vous que l'utilisateur dispose du rôle dbcreator. Cela leur accorde l'autorisation de créer la base de données dans SQL Server. Sinon, l'installation échoue.
• La création automatique des bases de données nécessaires ne fonctionne pas en combinaison avec l'authentification de l'annuaire. Si vous utilisez l'authentification d'annuaire, vous devez apporter vos propres bases de données.
• La connexion ODBC ne prend pas en charge les noms d'utilisateur contenant des caractères spéciaux. Pour les noms d'utilisateur de base de données pour AI Center, Document Understanding et Apps, utilisez uniquement des lettres majuscules et minuscules.

Important :

Pour Process Mining sur Automation Suite 2023.10.9 ou version ultérieure, l'utilisation de PostgreSQL pour la base de données Airflow est l'option recommandée. Si vous choisissez d'utiliser une base de données PostgreSQL, vous devez créer manuellement la base de données PostgreSQL pour AutomationSuite_Airflow avant l'installation ou la mise à niveau vers Automation Suite 2023.10.9 ou une version ultérieure. La base de données PostgreSQL pour Airflow ne sera pas créée automatiquement par le programme d'installation.

Reportez-vous aux exigences SQL pour Process Mining pour plus d'informations.

Fournissez vos propres bases de données

Si vous choisissez d’apporter vos propres bases de données dans le cadre d’une nouvelle installation Automation Suite, nous vous recommandons fortement de créer de nouvelles bases de données plutôt que d’utiliser les bases existantes. Cette précaution est nécessaire afin d’éviter tout conflit avec le fonctionnement d’Automation Suite qui pourrait être provoqué par la présence de métadonnées relatives à d’anciennes bases de données.

Si vous apportez votre propre base de données, vous devez fournir les chaînes de connexion SQL pour chaque base de données. Automation Suite prend en charge les formats de chaîne de connexion SQL suivants :

Remarque : Pour Document Understanding, assurez-vous que vous utilisez la même base de données, sauf indication contraire explicite. Des chaînes de connexion spécifiques sont attribuées à divers services et tâches qui se connectent à la même base de données.

Paramètre	Description	Produits
sql_connection_string_template	Chaîne de connexion ADO.NET complète où le nom du catalogue est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Plate-forme, Orchestrator, Automation Suite Robots, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service, Process Mining, Document Understanding
sql_connection_string_template_jdbc	Chaîne de connexion ODBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	AI Center
sql_connection_string_template_odbc	Chaîne de connexion ODBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Apps Document Understanding
sql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion PYODBC SQL complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Document Understanding, Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion PSYCOP2 SQL complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d’installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Process Mining (2023.10.9 ou version plus récente)

Important :

Assurez-vous que le compte SQL spécifié dans les chaînes de connexion dispose du rôle db_owner pour toutes les bases de données Automation Suite. Si les restrictions de sécurité n'autorisent pas l'utilisation de db_owner, le compte SQL doit avoir les rôles et autorisations suivants sur toutes les bases de données :

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• Autorisation EXECUTE sur le schéma dbo

Nous utilisons uniquement les rôles db_securityadmin et db_ddladmin lors de l’installation, ou bien si les bases de données sont réenregistrées. Vous avez donc la possibilité de révoquer ces autorisations ultérieurement.

Insights nécessite l'attribution du rôle db_owner pour une installation réussie.

Important :

Si vous définissez manuellement les chaînes de connexion dans le fichier de configuration, vous pouvez échapper les mots de passe SQL, JDBC, ODBC ou PYODBC comme suit :

• pour SQL : ajoutez ' au début et à la fin du mot de passe, et doublez tout autre ' .
• pour JDBC/ODBC : ajoutez { au début du mot de passe et } à la fin, et doublez tout autre } .
• pour PYODBC : username et password doivent être encodés en pourcentage pour tenir compte des caractères spéciaux. Les mots de passe de la base de données Document Understanding ne peuvent pas commencer par {.

Important : la base de données AutomationSuite_ProcessMining_Airflow du produit Process Mining doit avoir l'élément READ_COMMITTED_SNAPSHOT activé.

Remarque :

Par défaut, TrustServerCertificate est défini sur False et vous devez fournir un certificat CA supplémentaire pour SQL Server. Ceci est requis si le certificat SQL Server est auto-signé ou signé par une autorité de certification interne. Si vous ne fournissez pas le certificat SQL Server dans ce scénario, la vérification des prérequis échouera.

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

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

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

sql_connection_string_template_sqlalchemy_pyodbc example

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

Exemple postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

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

Exemple sql_connection_string_template et 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"

sql_connection_string_template and sql_connection_string_template_sqlalchemy_pyodbc example (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"

Exemple de chaîne de connexion Process Mining (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;",
  }

Exemple de chaîne de connexion Process Mining (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;",  
},

Remarque :

Lorsque vous utilisez l'authentification Kerberos, utilisez les paramètres Integrated Security et Trusted_Connection . En définissant Integrated Security sur true et en définissant Trusted_Connection sur yes, les informations d'identification de l'utilisateur actuellement connecté sont utilisées pour la connexion. Dans ce cas, vous n'avez pas besoin de spécifier un nom d'utilisateur et un mot de passe distincts.

Important :

Notez que les noms du modèle de chaîne de connexion PYODBC postgresql_connection_string_template_sqlalchemy_pyodbc (pour PostgreSQL) respectivement sql_connection_string_template_sqlalchemy_pyodbc (pour MS SQL Server) et la chaîne de connexion PYODBC sqlalchemy_pyodbc_sql_connection_str utilisés lorsque vous apportez votre propre base de données sont différents. De plus, les noms de chaîne de connexion sont différents pour le modèle SQL sql_connection_string_template et sql_connection_str utilisé lorsque vous apportez votre propre base de données.

Important :

Si vous apportez votre propre base de données et que vous l'avez configurée à l'aide des chaînes de connexion sql_connection_str et sqlalchemy_pyodbc_sql_connection_str dans la section processmining du fichier input.json , les chaînes de connexion du modèle sql_connection_string_template et postgresql_connection_string_template_sqlalchemy_pyodbc (pour PostgreSQL) respectivement sql_connection_string_template_sqlalchemy_pyodbc (pour MS SQL Server) sont ignorés si spécifiés.

Attention :

Définissez MultiSubnetFailover=True pour les chaînes de connexion sql_connection_str et master_sql_connection_str et MultiSubnetFailover=Yes pour les chaînes de connexion sqlalchemy_pyodbc_sql_connection_str .

Notez que pour pyodbc vous utilisez «=Oui » au lieu de «=Vrai ».

Remarque : selon le paramètre app_security_mode, un nouvel utilisateur SQL est créé pour chaque application Process Mining par le système (app_security_mode="system_managed"), ou bien un seul compte utilisateur SQL est créé et est utilisé pour toutes les applications de processus (app_security_mode="single_account"). Notez que app_security_mode="system_managed" est le paramètre par défaut, et que cela nécessite des autorisations avancées pour l’utilisateur de la base de données.

Consultez Configuration de la sécurité de l'application de processus.

Exemple de chaîne de connexion Process Mining

• Scénario : configuration avec l’authentification Kerberos (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;"
      },
  },

• Scénario : configuration avec l’authentification Kerberos (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"
  },

Exemple de chaîne de connexion Process Mining

• Scénario : la base de données de métadonnées et l’entrepôt de données utilisent un SQL Server distinct (authentification non 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;",  
},

Exemple de chaîne de connexion Process Mining

• Scénario : utilisation de app_security_mode personnalisés.

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

Classement SQL

Automation Suite prend en charge le classement SQL défini sur SQL_Latin1_General_CP1_CI_AS au niveau du serveur et de la base de données. Pour des performances et une stabilité optimales, nous recommandons fortement d’utiliser cette configuration.

Bien que vous ayez la possibilité d’utiliser le classement de votre choix, sachez que des configurations non testées sont susceptibles d’entraîner des problèmes inattendus.

Important :

Nous vous déconseillons d'utiliser SQL binaire ou tout classement sensible à la casse, car ils provoquent des problèmes connus lors de l'installation d'Automation Suite.

Chiffrements de SQL server

Seuls les chiffrements SQL répertoriés sont pris en charge dans Automation Suite :

• 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
• AES 256-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-CC
• 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

Authentification SQL

Accès à SQL à partir d'AKS basé sur Azure Active Directory

Remarque :

Insights et Task Mining ne prennent actuellement pas en charge la configuration d’authentification Microsoft Entra ID (anciennement Azure Active Directory) pour accéder à SQL.

Vous pouvez choisir d'accéder au serveur Microsoft SQL via Azure Active Directory à partir du cluster AKS. L'exemple suivant montre des chaînes de connexion utilisant la méthode d'accès AAD :

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

Exigences SQL pour Insights

Remarque : Insights ne prend pas en charge l'authentification Azure AD. Si vous vous authentifiez à l'aide d'Azure AD, les tableaux de bord ne peuvent pas être chargés et les données ne peuvent pas être extraites de la base de données Microsoft SQL.

Insights nécessite SQL Server 2019 ou 2022, qui prennent en charge l'index columnstore et les fonctions .json . SQL Server Enterprise est recommandé en raison d'un threading et d'une évolutivité plus efficaces.

Pour Azure SQL, assurez-vous que la base de données correspond à l'objectif de service S3 ou plus.

Assurez-vous que le niveau de compatibilité de la base de données Insights est défini sur 130 ou plus. Dans la plupart des cas, les paramètres par défaut répondent à cette exigence. Pour plus d'informations, reportez-vous à Afficher ou modifier le niveau de compatibilité d'une base de données - SQL Server (View or Change the Compatibility level of a Database - SQL Server).

L'installation valide les deux conditions et vous avertit si les exigences minimales ne sont pas remplies.

Exigences SQL pour Process Mining

Lorsque vous activez Process Mining pour une installation sur Automation Suite 2023.10.9 ou une version ultérieure, vous pouvez choisir d'apporter une base de données PostgreSQL ou une base de données Microsoft SQL Server pour AutomationSuite_Airflow.

Important :

Pour Process Mining sur Automation Suite 2023.10.9 ou des versions supérieures, il est recommandé de passer à PostgreSQL pour la base de données AutomationSuite_Airflow , car PostgreSQL s'exécute avec les dernières versions d'Apache Airflow. L'exécution de la dernière version de Airflow vous permet d'utiliser de nouvelles fonctionnalités, performances et correctifs de sécurité.

Si vous choisissez de ne pas utiliser de base de données PostgreSQL et de continuer à utiliser une base de données Microsoft SQLServer, Process Mining s'exécutera avec l'ancien Airflow sur Automation Suite. Les versions héritées d'Apache Airflow peuvent manquer de fonctionnalités, de performances et de correctifs de sécurité.

À partir de Process Mining sur Automation Suite 2025.10, seule la base de données PostgreSQL est prise en charge pour la base de données AutomationSuite_Airflow .

AutomationSuite_Airflow Base de données PostgreSQL

Pour Process Mining sur Automation Suite 202310.9 ou des versions plus récentes, vous pouvez choisir d'utiliser une base de données PostgreSQL pour la base de données AutomationSuite_Airflow .

Remarque :

Lors de la migration de Microsoft SQL Server vers PostgreSQL, la migration des données de la base de données n'est pas requise. Avec une configuration de configuration correcte, la base de données est reconstruite lors de l'exécution de Sync Airflow.

Versions de PostgreSQL prises en charge

Les versions 12.x à 16.x de PostgreSQL sont prises en charge. Il est recommandé d'utiliser la version la plus récente de PostgreSQL dans cette plage pour une compatibilité et des performances optimales.

Prérequis matériels

La machine sur laquelle la base de données PostgreSQL pour Airflow est installée doit répondre aux exigences matérielles suivantes.

• Cœurs : 4

• Mémoire : 16 Gio

• Stockage : 64 Gio

• IOPS : >=500 IOPS

Autorisations requises

L’utilisateur PostgreSQL Airflow (ou tout utilisateur de base de données dédié) doit avoir

• Autorisations « Tous les privilèges » (All Privileges) pour la base de données Airflow désignée.

• « toutes les autorisations » sur le schéma public du serveur.

• « search_path » est défini sur « public ».

Remarque :

Vous devrez peut-être mettre à jour le fichier d'authentification basée sur l'hôte PostgreSQL pg_hba.conf pour ajouter l'utilisateur Airflow à la liste de contrôle d'accès à la base de données et recharger la configuration de la base de données pour appliquer les modifications.

Le code suivant montre un exemple de configuration d'une base de données PostgreSQL.

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;

Le code suivant montre un exemple de validation d'encodage de base de données.

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

Reportez-vous à la documentation officielle de Airflow pour plus d'informations sur la configuration d'une base de données PostgreSQL pour Airflow.

Port du serveur par défaut

Le port de serveur par défaut pour les connexions de base de données Airflow avec PostgreSQL est 5432. Si vous utilisez le pooler de connexion PgBounder, il est courant d'utiliser le port 6432.

Les blocs de code suivants montrent des exemples de chaînes de connexion pour PostgreSQL utilisant le port 5432.

Exemple de chaîne de connexion :

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

Exemple de chaîne de connexion pour l'utilisation de Kerberos :

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

Exemple de chaîne de connexion pour l'utilisation de l'identité gérée :

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

Le port de serveur par défaut peut être configuré pour utiliser n'importe quel port disponible selon les exigences de votre système.

LanceurPg

Étant donné que Airflow utilise des connexions de courte durée, il est fortement recommandé de configurer PgBounder. PgBounder est un pooler de connexions léger pour PostgreSQL.

Reportez-vous à la documentation officielle de PgBounder pour plus d'informations sur la configuration de PgBounder.

Remarque :

Lors de la migration de Microsoft SQL Server vers PostgreSQL, la migration des données de la base de données n'est pas requise. Avec une configuration de configuration correcte, la base de données est reconstruite lors de l'exécution de Sync Airflow.

AutomationSuite_Airflow Base de données Microsoft SQL Server

Remarque :

Pour la base de données AutomationSuite_Airflow , Microsoft SQL Server est la seule option disponible pour Process Mining sur les versions d'Automation Suite 2023.10.8 et antérieures. Pour Process Mining sur Automation Suite 2023.10.9 ou des versions plus récentes, il est recommandé de passer à PostgreSQL.

Si vous utilisez Microsoft SQL Server pour la base de données AutomationSuite_Airflow , assurez-vous de répondre aux exigences suivantes.

Important :

Vous devez utiliser le port de serveur par défaut 1433 pour les connexions à la base de données Airflow.

Les ports de SQL server non standard ne sont pas pris en charge.

Attention :

Lors de la configuration de Microsoft SQL Server, veillez à ce que le fuseau horaire est défini sur UTC dans la machine SQL Server où la base de données Airflow est installée.

AutomationSuite_ProcessMining_Warehouse Base de données

Process Mining sur Automation Suite nécessite un serveur Microsoft SQL distinct pour AutomationSuite_ProcessMining_Warehouse afin de stocker les données des applications de processus Process Mining.

Important :

Pour assurer un bon fonctionnement de Process Mining, il est recommandé d'utiliser Microsoft SQL Server 2022.

Il s'agit d'un aperçu de la configuration matérielle requise et des recommandations pour configurer une machine de base de données Microsoft SQL Server pour AutomationSuite_ProcessMining_Warehouse.

Pour calculer la configuration matérielle requise, vous devez disposer des éléments suivants :

• le nombre de (millions) d'événements dans votre processus.

• le nombre de champs d'incident et d'événement dans vos données de sortie.

  Remarque : dans un environnement de développement, pour des raisons de performances, il est recommandé de travailler sur un petit ensemble de données de développement avec un nombre limité d'enregistrements.

Vous pouvez utiliser le calculateur de dimensionnement d'installation d'UiPath Automation Suite pour déterminer la configuration matérielle requise en vue de configurer une machine Microsoft SQL Server dédiée pour Process Mining. Lorsque vous ajoutez Process Mining à la section Produit (Product), la configuration minimale requise pour une machine SQL Server dédiée s'affiche.

Reportez-vous à la configuration matérielle requise pour plus d'informations.

L’utilisateur SQL utilisé dans les chaînes de connexion doit disposer du rôle au niveau de la base de données db_securityadmin pendant et après l’installation pour activer la sécurité par application sur le serveur SQL de l’entrepôt de données Process Mining. Pour plus de détails, consultez la documentation officielle de Microsoft sur les rôles de niveau base de données.

Reportez-vous à Configuration de la sécurité de l'application de processus pour plus d'informations.

Exigences SQL pour AI Center

Exigences pour AI Center installé sur une machine compatible FIPS 140-2

Pour installer AI Center sur une machine compatible FIPS 140-2, procédez comme suit :

1. Avant de commencer l'installation d'Automation Suite, procédez comme suit :

   1. Activez FIPS 140-2 sur la machine sur laquelle vous prévoyez d'installer Microsoft Server en suivant les instructions de Microsoft.

   2. Installez le serveur Microsoft SQL sur la machine compatible FIPS 140-2.

   3. Obtenez le certificat Microsoft SQL Server en exécutant la commande suivante à partir de SQL Server ou de tout serveur pouvant se connecter au serveur SQL avec le nom d'hôte SQL configuré :

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

2. Lors de l'installation d'Automation Suite, procédez comme suit :

   1. Ajoutez les valeurs suivantes à la chaîne de connexion sql_connection_string_template_jdbc d'AI Center dans le fichier input.json : encrypt=true;trustServerCertificate=false;fips=true;.

      Exemple :

      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"

      Pour plus de détails sur la configuration de la base de données, voir Expérience d'installation avancée et Mise à jour de la base de données SQL.

   2. Ajoutez le certificat exporté de l'étape 1.c. au magasin approuvé de la machine hôte. Pour plus de détails, consultez Mise à jour des certificats CA.