Base de datos SQL

Nota: A menos que se especifique lo contrario en las secciones de requisitos específicos, estos requisitos son aplicables a todos los productos de Automation Suite.

Debes traer un servidor SQL externo para instalar productos de Automation Suite y UiPath®. Se admiten Microsoft SQL Server 2017, 2019 y 2022 ediciones Standard y Enterprise.

También se admiten plataformas Microsoft SQL adicionales, como Azure SQL Database, Azure SQL Managed Instance o Amazon Relational Database Service, siempre que el motor de base de datos de Microsoft SQL Server cumpla los requisitos. Para obtener más información, consulta Matriz de compatibilidad.

Nota:

Asegúrese de que se pueda acceder al servidor SQL desde los nodos del clúster.

La compatibilidad de cada producto es diferente.

Para cada producto que tenga previsto implementar, deberá:

• Comprobar la versión compatible de SQL Server, tal como requiere el producto.
• cumplir con los requisitos de configuración de SQL Server, incluidos los permisos de usuario de SQL Server, según lo requiera el producto.

Los requisitos mínimos generales de hardware para Microsoft SQL Server son los siguientes:

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

Los requisitos mínimos son una guía general y no garantizan un funcionamiento fiable en una implementación de Production . La planificación de la capacidad es necesaria para determinar los requisitos de hardware necesarios para un funcionamiento fiable. Para obtener más información, consulta Planificación de la capacidad.

Cada producto de UiPath® requiere su propia base de datos SQL.

Flujo de trabajo de creación de la base de datos

El instalador interactivo crea automáticamente bases de datos utilizando el siguiente flujo de trabajo:

1. El script del instalador interactivo comprueba el valor del parámetro sql.create_db en el archivo input.json .
   • Si el parámetro sql.create_db está establecido en true, el instalador genera automáticamente todas las bases de datos en tu nombre. En este caso, el instalador utiliza los nombres de base de datos predeterminados y las plantillas predeterminadas, e ignora cualquier nombre de base de datos personalizado que hayas proporcionado.

     Para obtener más información, consulta Crear automáticamente las bases de datos necesarias.

   • Si sql.create_db está establecido en false, debes traer tus propias bases de datos. En este caso, debes configurar manualmente tus bases de datos. Ten en cuenta que puedes utilizar nombres de bases de datos personalizados, siempre que sigas las convenciones de nomenclatura proporcionadas. Este paso es fundamental porque utilizamos el nombre de la base de datos junto con la plantilla de conexión para formar la cadena de conexión de la base de datos. Si no sigues la convención de nomenclatura recomendada, debes proporcionar las cadenas de conexión SQL tú mismo.

     Para obtener más información, consulta Trae tus propias bases de datos.

2. El instalador interactivo genera las cadenas de conexión de la siguiente manera:

   • Si no definiste una cadena de conexión para tu servicio, el instalador utiliza la plantilla de conexión para generar todas las cadenas de conexión de base de datos.

   • Si definiste una cadena de conexión para tu servicio, el instalador utiliza la cadena de conexión proporcionada para tu base de datos.

Creación automática de las bases de datos necesarias

Si quieres que el instalador cree las bases de datos, rellena los siguientes campos del archivo input.json :

Parámetro	Descripción
sql.create_db	Establece en true para permitir que el instalador cree las bases de datos. Ten en cuenta que el instalador utiliza los nombres de base de datos predeterminados y las plantillas predeterminadas, e ignora cualquier nombre de base de datos personalizado que hayas proporcionado.
sql.server_url	FQDN del servidor SQL donde desea que el instalador configure la base de datos.
sql.port	Número de puerto en el que se debe alojar una instancia de base de datos en el servidor SQL.
sql.username	Nombre o ID de usuario con el que conectarse al servidor SQL.
sql.password	Contraseña del nombre de usuario proporcionado anteriormente con la que conectarse al servidor SQL.

Nota:

• Asegúrate de que el usuario tiene el rol dbcreator. Esto les otorga permiso para crear la base de datos en SQL Server. De lo contrario, la instalación falla.
• La conexión ODBC no admite nombres de usuario que contengan caracteres especiales. Para los nombres de usuario de la base de datos para AI Center, Document Understanding, y Apps, utiliza solo letras en mayúsculas y minúsculas.

Utilizar su propia base de datos

Si decides traer tus propias bases de datos para una nueva instalación de Automation Suite, recomendamos encarecidamente configurar nuevas bases de datos en lugar de utilizar las existentes. Esta precaución es necesaria para evitar cualquier conflicto con la operación de Automation Suite que pueda ocurrir debido a los metadatos sobrantes de las bases de datos antiguas.

Si traes tu propia base de datos, debes proporcionar las cadenas de conexión SQL para cada base de datos. Automation Suite admite los siguientes formatos de cadenas de conexión SQL.

Parámetro	Descripción	Productos
sql_connection_string_template	Cadena de conexión ADO.NET completa en la que el nombre del catálogo se establece como DB_NAME_PLACEHOLDER. El instalador sustituirá este marcador de posición por los nombres de base de datos predeterminados para los servicios de la suite instalada.	Plataforma, Orchestrator, Automation Suite Robots, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service, Process Mining, Document Understanding
sql_connection_string_template_jdbc	Cadena de conexión JDBC completa en la que el nombre de base de datos se establece como DB_NAME_PLACEHOLDER. El instalador sustituirá este marcador de posición por los nombres de base de datos predeterminados para los servicios de la suite instalada.	AI Center
sql_connection_string_template_odbc	Cadena de conexión ODBC completa en la que el nombre de base de datos se establece como DB_NAME_PLACEHOLDER. El instalador sustituirá este marcador de posición por los nombres de base de datos predeterminados para los servicios de la suite instalada.	Document Understanding, Apps
sql_connection_string_template_sqlalchemy_pyodbc	Cadena de conexión PYODBC de alquimia SQL completa donde el nombre de la base de datos se establece en DB_NAME_PLACEHOLDER. El instalador sustituirá este marcador de posición por los nombres de base de datos predeterminados para los servicios de la suite instalada.	Process Mining

Importante:

Asegúrate de que la cuenta SQL especificada en las strings de conexión tiene asignado el rol db_owner y db_securityadmin para todas las bases de datos de Automation Suite. Si las restricciones de seguridad no permiten el uso de db_owner, entonces la cuenta SQL debe tener los siguientes roles y permisos en todas las bases de datos:

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• Permiso EXECUTE en el esquema dbo

Solo utilizamos los roles db_securityadmin y db_ddladmin durante la instalación o si las bases de datos se reaprovisionan, por lo que puedes revocar estos permisos después.

Insights requiere que se asigne el rol db_owner para una instalación correcta.

Importante:

Si establece manualmente las cadenas de conexión en el archivo de configuración, puede escapar de las contraseñas de SQL, JDBC, ODBC o PYODBC de la siguiente manera:

• para SQL: añade ' al principio y al final de la contraseña, y doble cualquier otra' .
• para JDBC/ODBC: añade { al principio y } al final de la contraseña, y duplicar cualquier otra }.
• para PYODBC: username y password deben codificarse como URL para tener en cuenta los caracteres especiales. Las contraseñas de la base de datos de Document Understanding no pueden comenzar con {.

Importante: La base de datos AutomationSuite_ProcessMining_Airflow para el producto Process Mining debe tener READ_COMMITTED_SNAPSHOT habilitado.

Nota:

De forma predeterminada, TrustServerCertificate está establecido en False, y debes proporcionar un certificado de CA adicional para SQL Server. Esto es necesario si el certificado del servidor SQL está autofirmado o firmado por una AC interna. Si no proporcionas el certificado de SQL Server en este escenario, la comprobación de requisitos previos fallará.

ejemplo: plantilla_cadena_conexión_sql

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;

ejemplo: plantilla_cadena_conexión_jdbc_sql

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"

ejemplo: plantilla_cadena_conexión_odjbc_sql

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

Ejemplo de sql_connection_string_template_sqlalchemy_pyodbc

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

Ejemplo de sql_connection_string_template y sql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

"sql_connection_string_template": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=[e-mail];Password='***';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"

Nombres de base de datos predeterminados y opcionales para servicios de 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",
  "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",
  
}

Nota:

Si desea anular la cadena de conexión para cualquiera de los servicios anteriores, establezca la sql_connection_str para ese servicio específico.

De todos modos, tiene que crear manualmente estas bases de datos antes de ejecutar el instalador.

Anular la cadena de conexión predeterminada para Orchestrator y la plataforma

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

Para anular las cadenas de conexión a la base de datos de otros productos, establezca la sql_connection_str en los bloques de producto correspondientes. La cadena de conexión debe tener un formato compatible con el respectivo producto.

Ejemplo de establecimiento de cadena de conexión a la base de datos para AI Center

Parámetro	Descripción
aicenter.sql_connection_str	Cadena de conexión JDBC de AI Center (consulte el formato JDBC más abajo)

Nota: asegúrate de que la cadena de conexión JDBC tiene el formato de la muestra a continuación:

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

Cadena de conexión de ejemplo de Document Understanding

"documentunderstanding": {
"enabled": true,
"sql_connection_str": "" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "" // odbc connection string
 }
}

Nota: la cadena de conexión SQL de Data Manager es opcional solamente si deseas sobrescribir la base de datos predeterminada con la tuya propia.

La escritura manual está siempre habilitada para la instalación en línea.

El valor predeterminado para max_cpu_per-pod es 2, pero puede ajustarlo según sus necesidades.

Ejemplo de cadena de conexión de Process Mining

"processmining": {
    "enabled": true,
    "warehouse": {
        "sql_connection_str": "Server=tcp:sfdev4515230-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;User Id=[e-mail];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='***';Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",  
},

Importante: Ten en cuenta que los nombres de la cadena de conexión PYODBC de la plantilla sql_connection_string_template_sqlalchemy_pyodbc y la cadena de conexión PYODBC sqlalchemy_pyodbc_sql_connection_str utilizados cuando traes tu propia base de datos son diferentes. Además, los nombres de las cadenas de conexión son diferentes para la plantilla SQL sql_connection_string_template y sql_connection_str utilizada cuando traes tu propia base de datos.

Importante:

Si traes tu propia base de datos y la configuraste utilizando las cadenas de conexión sql_connection_str y sqlalchemy_pyodbc_sql_connection_str en la sección processmining del archivo input.json , las cadenas de conexión de la plantilla sql_connection_string_template y sql_connection_string_template_sqlalchemy_pyodbc se ignoran si se especifican.

Atención:

MultiSubnetFailover=True no es compatible. Asegúrate de eliminar MultiSubnetFailover=True de cualquiera de las cadenas de conexión de Process Mining.

Nota:

Dependiendo de la configuración app_security_mode, el sistema crea un nuevo usuario SQL para cada aplicación de Process Mining (app_security_mode="system_managed"), o crea una única cuenta de usuario SQL que se utiliza para todas las aplicaciones de proceso (app_security_mode="single_account"). Ten en cuenta que app_security_mode="system_managed" es la configuración predeterminada y que requiere permisos avanzados para el usuario de la base de datos. Consulta Configurar la seguridad de la aplicación de proceso.

Ejemplo de cadena de conexión de Process Mining

• Escenario: configuración con autenticación 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"
  },

Ejemplo de cadena de conexión de Process Mining

• Escenario: la base de datos de metadatos y el almacén de datos utilizan un servidor SQL independiente (autenticación no 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;",  
},

Ejemplo de cadena de conexión de Process Mining

• Escenario: utilizando personalizado app_security_mode:

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

Autenticación de SQL

Acceso basado en Azure Active Directory a SQL desde AKS

Puede elegir acceder al servidor Microsoft SQL a través de Azure Active Directory desde el clúster de AKS. El siguiente ejemplo muestra algunas cadenas de conexiones que utilizan el método de acceso de 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",