Base de données SQL

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.

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 :

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, selon l'exigence du 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 de la capacité.

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

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 :

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 Robots Automation Suite Test Manager Automation Hub Automation Ops Insights Integration Service Studio Web 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 Integration Service
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.	Document Understanding Apps Integration Service
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

Important :

Assurez-vous que le compte SQL spécifié dans les chaînes de connexion dispose des rôles db_securityadmin et 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"

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"

Noms de bases de données par défaut et facultatifs pour les services Automation Suite

{
  "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"
  "task_mining": "AutomationSuite_Task_Mining",
  "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",
  
}

Remarque :

Si vous souhaitez remplacer la chaîne de connexion pour l'un des services ci-dessus, définissez le sql_connection_str pour ce service spécifique.

Vous devez toujours créer manuellement ces bases de données avant d'exécuter le programme d'installation.

Remplacer la chaîne de connexion par défaut pour Orchestrator et la plateforme

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

Pour remplacer les chaînes de connexion à la base de données pour d'autres produits, définissez le sql_connection_str dans les blocs de produits correspondants. La chaîne de connexion doit avoir un format pris en charge par le produit respectif.

Exemple de définition de la chaîne de connexion à la base de données pour AI Center

Paramètre	Description
aicenter.sql_connection_str	Chaîne de connexion AICenter JDBC (voir ci-dessous pour le format JDBC)

Remarque : assurez-vous que la chaîne de connexion JDBC a le même format que dans l'exemple suivant :

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

Exemple de chaîne de connexion Document Understanding

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

Remarque : La chaîne de connexion SQL de Data manager est facultative uniquement si vous souhaitez remplacer la valeur par défaut par la vôtre.

Exemple de chaîne de connexion Process Mining

"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;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
	    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://:@sfdev4515230-sql.database.windows.net:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes",
        "master_sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,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://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~[e-mail]: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;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",  
},

Attention : notez que les noms du modèle de chaîne de connexion PYODBC sql_connection_string_template_sqlalchemy_pyodbc et de 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 modèles sql_connection_string_template et sql_connection_string_template_sqlalchemy_pyodbc sont ignorées si spécifiées.

Attention :

MultiSubnetFailover=True n’est pas pris en charge. Assurez-vous de supprimer MultiSubnetFailover=True de l’une des chaînes de connexion de Process Mining.

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.

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

Exemple de chaîne de connexion Studio Web

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

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.

Exigences SQL pour la recherche en texte intégral

Document Understanding nécessite que SQL Server dispose du composant de recherche en texte intégral du moteur de base de données SQL Server, qui n'est pas toujours installé par défaut.

Si vous n'avez pas sélectionné la recherche en texte intégral lors de l'installation de SQL Server, exécutez à nouveau le programme d'installation de SQL Server pour l'ajouter avant de configurer Document Understanding.

Pour plus d'informations, consultez ce guide sur la façon d'ajouter/d'installer des fonctionnalités sur le serveur SQL. Vous pouvez également vérifier ici tous les composants qui peuvent être ajoutés au serveur SQL, qui comprend également la recherche en texte intégral.

Authentification SQL

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

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

Accès à SQL depuis AKS basé sur l'identité de la charge de travail

Pour des informations générales sur l'identité de la charge de travail, consultez Configuration de l'identité de la charge de travail.

Pour configurer SQL Server afin d'utiliser l’identité de la charge de travail, exécutez la commande suivante :

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

L’exemple suivant montre un modèle de chaîne de connexion SQL valide :

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

Comme Task Mining ne prend pas en charge l'identité de la charge de travail, l'activation de Task Mining nécessite que vous fournissiez un remplacement de chaîne de connexion SQL dans la section Task Mining du fichier input.json . L'exemple ci-dessous montre un exemple de telle section Task Mining :

"task_mining": {
  "sql_connection_str": "Server=tcp:sql_dns_name,1433;Initial Catalog=AutomationSuite_Task_Mining;Persist Security Info=False;User Id=userid;Password='psw';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
  "external_object_storage": {
    "account_key": "accountkey", 
  },
},

Si vous activez Apps ou Automation Hub, vous devez remplacer leurs chaînes de connexion SQL respectives dans le fichier input.json pour assurer la prise en charge de l'identité de la charge de travail. L'exemple ci-dessous montre un exemple de ces remplacements de chaîne de connexion SQL :

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

Exigences SQL pour Insights

Insights nécessite SQL Server 2019 ou 2022, qui prennent en charge l'index columnstore et les fonctions .json.

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

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 Data Service

Data Service nécessite un serveur SQL de version 2016 ou ultérieure.

Si vous créez votre propre base de données à l'aide du serveur SQL version 2019 ou ultérieure, veillez à accorder les autorisations Data Service suivantes à vos utilisateurs :

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

Exigences SQL pour Process Mining

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.

Vous trouverez ci-dessous 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.

Attention :

When setting up Microsoft SQL Server make sure that the timezone of the SQL Server machine where the Airflow database is installed, is set to UTC.

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 capacité 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.

Consultez également la section Configuration matérielle requise.

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.

Voir aussi Configuration de la sécurité des applications de processus.

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.

Exigences SQL pour la haute disponibilité (HA)

Pour une configuration haute disponibilité du serveur SQL, sélectionnez un groupe de disponibilité Toujours activé (Always On). Pour plus d'informations, consultez Présentation des groupes de disponibilité Toujours activé (Always On).

Exigences SQL pour Orchestrator

Important : Pour augmenter les performances, éviter les blocages et empêcher les lectures incorrectes dans SQL, assurez-vous que l’option READ_COMMITTED_SNAPSHOT est définie sur ON.

Utilisez cette requête pour vérifier si READ_COMMITTED_SNAPSHOT est activé ou désactivé :

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

S'il est activé, la valeur renvoyée sera 1.

S'il est désactivé, la valeur renvoyée sera 0. Utilisez cette requête pour l'activer :

ALTER DATABASE UiPath
SET READ_COMMITTED_SNAPSHOT ON

Si vous utilisez différentes bases de données pour l'automatisation de test (Test Automation) et/ou mettre à jour le serveur (Update Server), READ_COMMITTED_SNAPSHOT doit également être activé sur celles-ci.