banco de dados SQL

Observação: a menos que especificado nas seções dedicadas aos requisitos, esses requisitos são aplicáveis a todos os produtos do Automation Suite.

Você deve trazer um servidor SQL externo para instalar os produtos do Automation Suite e da UiPath®. As edições Standard e Enterprise do Microsoft SQL Server 2017, 2019 e 2022 são suportadas.

Importante: atualmente, o Orchestrator e o AI Center exigem o SQL Server versão 2019 e superior para funcionarem de forma otimizada.

Plataformas adicionais do Microsoft SQL, como Azure SQL Database, Azure SQL Managed Instance ou o Serviço de banco de dados relacional da Amazon, também são compatíveis, desde que o mecanismo de banco de dados Microsoft SQL Server atenda aos requisitos. Para obter detalhes, consulte Matriz de compatibilidade.

Observação:

Se o Process Mining estiver habilitado e você quiser usar a versão mais recente do Airflow, o PostgreSQL é necessário para o banco de dados AutomationSuite_Airflow . (Versão 2024.10.3 ou superior.)

Consulte Requisitos do SQL para o Process Mining para obter mais informações.

Observação:

Certifique-se de que o SQL Server possa ser acessado a partir dos nós do cluster.

Suporte de produto individual é variado.

Para cada produto que você planeja implantar, você deve:

• verifique a versão suportada do SQL Server conforme exigido pelo produto;
• atender aos requisitos de configuração do SQL Server, incluindo permissões de usuário do SQL Server, conforme o produto exigir.

Os requisitos mínimos gerais de hardware para o Microsoft SQL Server são os seguintes:

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

Os requisitos mínimos são uma orientação geral e não garantem uma operação confiável em uma implantação de produção. O planejamento de capacidade é necessário para determinar os requisitos de hardware para uma operação confiável. Para obter mais detalhes, consulte Planejamento de capacidade.

Cada produto da UiPath® requer seu próprio banco de dados SQL.

Fluxo de trabalho de criação de banco de dados

O instalador interativo cria automaticamente bancos de dados usando o seguinte fluxo de trabalho:

1. O script do instalador interativo verifica o valor do parâmetro sql.create_db no arquivo input.json .
   • Se o parâmetro sql.create_db estiver definido como true, o instalador gerará automaticamente todos os bancos de dados em seu nome. Nesse caso, o instalador usa os nomes de bancos de dados e modelos padrão e ignora quaisquer nomes de bancos de dados personalizados que você forneceu.

     Para obter detalhes, consulte Criar automaticamente os bancos de dados necessários.

   • Se sql.create_db estiver definido como false, você deve trazer seus próprios bancos de dados. Nesse caso, você deve configurar manualmente seus bancos de dados. Observe que você pode usar nomes de banco de dados personalizados, desde que siga as convenções de nomenclatura fornecidas. Essa etapa é fundamental porque usamos o nome do banco de dados em conjunto com o modelo de conexão para formar a string de conexão com banco de dados. Se você não seguir a convenção de nomenclatura recomendada, deve fornecer as strings de conexão SQL por conta própria.

     Para obter detalhes, consulte Traga seus próprios bancos de dados.

2. O instalador interativo gera as strings de conexão da seguinte forma:

   • Se você não definiu uma string de conexão para seu serviço, o instalador usará o modelo de conexão com o banco de dados para gerar todas as strings de conexão com banco de dados.

   • Se você definiu uma string de conexão para seu serviço, o instalador usará a string de conexão fornecida para seu banco de dados.

Cria automaticamente os bancos de dados necessários

Se quiser que o instalador crie os bancos de dados, preencha os seguintes campos do arquivo input.json :

Parâmetro	Description
sql.create_db	Defina como true para permitir que o instalador crie os bancos de dados. Observe que o instalador usa os nomes de bancos de dados e modelos padrão e ignora quaisquer nomes de bancos de dados personalizados que você forneceu.
sql.server_url	FQDN do SQL Server, onde você deseja que o instalador configure o banco de dados.
sql.port	Número da porta na qual uma instância de banco de dados deve ser hospedada no SQL Server.
sql.username	Nome de usuário/ID do usuário para se conectar ao SQL Server.
sql.password	Senha do nome de usuário fornecido anteriormente para se conectar ao SQL Server.

Observação:

• Certifique-se de que o usuário tenha a função dbcreator. Isso concede a eles permissão para criar o banco de dados no SQL Server. Caso contrário, a instalação falha.
• A criação automática dos bancos de dados necessários não funciona em combinação com a autenticação de diretório. Se você usa a autenticação de diretórios, deve trazer seus próprios bancos de dados.
• A conexão ODBC não aceita nomes de usuário que contenham caracteres especiais. Para nomes de usuário de banco de dados no AI Center, Document Understanding e Apps, use apenas letras maiúsculas e minúsculas.

Importante:

Para Process Mining no Automation Suite 2024.10.3 ou superior, usar o PostgreSQL para o banco de dados Airflow é a opção recomendada. Se você optar por usar um banco de dados PostgreSQL, precisará criar manualmente o banco de dados PostgreSQL para AutomationSuite_Airflow antes de instalar ou atualizar para o Automation Suite 2024.10.3 ou superior. O banco de dados PostgreSQL para o Airflow não será criado automaticamente pelo instalador.

Consulte Requisitos do SQL para o Process Mining para obter mais informações.

Traga seus próprios bancos de dados

Se você optar por trazer seus próprios bancos de dados para uma nova instalação do Automation Suite, recomendamos fortemente a configuração de novos bancos de dados em vez de usar os existentes. Essa precaução é necessária para evitar quaisquer conflitos com a operação do Automation Suite que possam ocorrer devido a metadados restantes de bancos de dados antigos.

Se trouxer seu próprio banco de dados, você deve fornecer as strings de conexão do SQL para cada banco de dados. O Automation Suite oferece suporte aos seguintes formatos de string de conexão SQL:

Observação: para o Document Understanding, certifique-se de que você esteja usando o mesmo banco de dados, a menos que explicitamente indicado de outra forma. Strings de conexão específicas são atribuídas a vários serviços e trabalhos que se conectam ao mesmo banco de dados.

Parâmetro	Description	Produtos
sql_connection_string_template	String de conexão completa do ADO.NET onde o nome do catálogo é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Plataforma Orchestrator Automation Suite Robots Test Manager Automation Hub Automation Ops Insights Data Service Process Mining Document Understanding
sql_connection_string_template_jdbc	String de conexão completa do JDBC onde o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	AI Center
sql_connection_string_template_odbc	String de conexão completa do ODBC onde o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Document Understanding Apps
sql_connection_string_template_sqlalchemy_pyodbc	Cadeia de conexão PYODBC de alquimia SQL completa em que o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do conjunto instalados.	Document Understanding Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	String de conexão SQL alchemy PSYCOPG2 completa na qual o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços da suíte instalada.	Process Mining (2024.10.3 ou mais recente)

Importante:

Certifique-se de que a conta do SQL especificada nas strings de conexão tenha a função db_owner para todos os bancos de dados do Automation Suite. Se as restrições de segurança não permitem o uso de db_owner, a conta do SQL deve ter as seguintes funções e permissões em todos os bancos de dados:

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• EXECUTEpermissão no esquema dbo

O Insights requer que a função db_owner seja atribuída para uma instalação bem-sucedida.

Observação:

Por padrão, TrustServerCertificate é definido como False, e você deve fornecer um certificado de CA adicional para o SQL Server. Isso é necessário se o certificado do SQL Server for autoassinado ou assinado por uma CA interna. Se você não fornecer o certificado do SQL Server nesse cenário, a verificação de pré-requisitos falhará.

Exemplo do 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;

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

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

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

Exemplo postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

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

Exemplo: sql_connection_string_template e 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"

Exemplo de sql_connection_string_template e sql_connection_string_template_sqlalchemy_pyodbc (Process Mining)

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

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

Nomes de banco de dados padrão e opcional para serviços do 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",
  "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",
  
}

Observação:

Se você quiser substituir a string de conexão de algum dos serviços mencionados, defina sql_connection_str para esse serviço específico.

Você ainda precisa criar esses bancos de dados manualmente antes de executar o instalador.

Substituição da string de conexão padrão do Orchestrator e da 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 substituir as strings de conexão do banco de dados para outros produtos, defina sql_connection_str nos blocos de produto correspondentes. A string de conexão deve ter um formato compatível com o respectivo produto.

Exemplo para definir a string de conexão do banco de dados para o AI Center

Parâmetro	Description
aicenter.sql_connection_str	String de conexão JDBC do AI Center

Observação: certifique-se de que a string de conexão JDBC tenha o formato do seguinte exemplo:

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

Amostra de string de conexão do 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"
        }
    }

Observação: a string de conexão do SQL Data Manager é opcional apenas se você quiser substituir a string padrão por uma própria.

Exemplo de string de conexão do 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;",
  }

Exemplo de string de conexão do 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;",  
},

Observação:

Ao usar a autenticação do Kerberos, utilize os parâmetros Integrated Security e Trusted_Connection . Ao definir Integrated Security como true e definir Trusted_Connection como yes, as credenciais do usuário atualmente logado serão usadas para a conexão. Nesse caso, você não precisa especificar um nome de usuário e senha separados.

Importante:

Observe que os nomes para a string de conexão PYODBC postgresql_connection_string_template_sqlalchemy_pyodbc (para PostgreSQL) respectivamente sql_connection_string_template_sqlalchemy_pyodbc (para MS SQL Server) e a string de conexão PYODBC sqlalchemy_pyodbc_sql_connection_str usadas quando você traz seu próprio banco de dados são diferentes. Além disso, os nomes das strings de conexão são diferentes para o modelo SQL sql_connection_string_template e sql_connection_str usado quando você traz seu próprio banco de dados.

Importante:

Se você trouxer seu próprio banco de dados e configurou isso usando as strings de conexão sql_connection_str e sqlalchemy_pyodbc_sql_connection_str na seção processmining do arquivo input.json , as strings de conexão do modelo sql_connection_string_template e postgresql_connection_string_template_sqlalchemy_pyodbc (para PostgreSQL) respectivamente sql_connection_string_template_sqlalchemy_pyodbc (para o MS SQL Server) são ignorados, se especificados.

Atenção:

Defina MultiSubnetFailover=True para sql_connection_str , master_sql_connection_str e MultiSubnetFailover=Yes para sqlalchemy_pyodbc_sql_connection_str strings de conexão.

Observe que para pyodbc você usa '=Yes' em vez de '=True'.

Observação: dependendo da configuração app_security_mode, ou um novo usuário SQL é criado para cada aplicativo Process Mining pelo sistema (app_security_mode="system_managed"), ou uma única conta de usuário SQL é criada e usada para todos os aplicativos de processo (app_security_mode="single_account"). Observe que app_security_mode="system_managed" é a configuração padrão, e que isso requer permissões avançadas para o usuário do banco de dados.

Consulte Configuração da segurança do aplicativo de processo.

Exemplo de string de conexão do Process Mining

• Cenário: configuração com autenticação 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;"
      },
  },

• Cenário: configuração com autenticação do 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"
  },

Exemplo de string de conexão do Process Mining

• Cenário: banco de dados de metadados e armazém de dados usam servidor SQL separado (autenticação não 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;",  
},

Exemplo de string de conexão do Process Mining

• Cenário: usando app_security_mode personalizado:

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

Collation de SQL

O Automation Suite é compatível com agrupamento de SQL definido como SQL_Latin1_General_CP1_CI_AS no nível do servidor e do banco de dados. Recomendamos fortemente essa configuração específica para um desempenho e estabilidade ideais.

Embora você tenha a flexibilidade de usar um agrupamento de sua escolha, esteja ciente de que configurações não testadas podem levar a problemas inesperados.

Importante:

Não recomendamos usar SQL binário ou quaisquer agrupamentos que diferenciem maiúsculas e minúsculas, pois causam problemas conhecidos ao instalar o Automation Suite.

Codificações do SQL server

Apenas as cifras SQL listadas são suportadas no 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
• AES256-CCM
• AES128-GCM-SHA256
• AES128-CCM
• AES256-SHA256
• AES128-SHA256
• AES256-SHA
• AES128-SHA
• DHE-RSA-AES256-GCM-SHA384
• DHE-RSA-Chacha20-POLY1305
• DHE-RSA-AES256-CCM
• DHE-RSA-AES128-GCM-SHA256
• DHE-RSA-AES128-CCM
• DHE-RSA-AES256-SHA256
• DHE-RSA-AES128-SHA256
• DHE-RSA-AES256-SHA
• DHE-RSA-AES128-SHA
• PSK-AES256-GCM-SHA384
• PSK-Chacha20-POLY1305
• PSK-AES256-CCM
• PSK-AES128-GCM-SHA256
• PSK-AES128-CCM
• PSK-AES256-CPC-SHA
• PSK-AES128- CBC-SHA256
• PSK-AES128-CPC-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-CPC-SHA
• DHE-PSK-AES128-CPC-SHA256
• DHE-PSK-AES128-CPC-SHA
• ECDHE-PSK-Chacha20-POLY1305
• ECDHE-PSK-AES256-CPC-SHA
• ECDHE-PSK-AES128-CPC-SHA256
• ECDHE-PSK-AES128-CPC-SHA
• RSA-PSK-AES256-GCM-SHA384
• RSA-PSK-Chacha20-POLY1305
• RSA-PSK-AES128-GCM-SHA256
• RSA-PSK-AES256-CPC-SHA
• RSA-PSK-AES128-CPC-SHA256
• RSA-PSK-AES128-CPC-SHA

Requisitos de SQL para pesquisa de texto completo

O Document Understanding exige que o SQL Server tenha o componente Pesquisa de Texto Completo do Mecanismo de Banco de Dados do SQL Server, que nem sempre é instalado por padrão.

Se você não selecionou Pesquisa de Texto Completo quando instalou o SQL Server, execute a Instalação do SQL Server novamente para adicioná-la antes de configurar o Document Understanding.

Para obter mais informações, consulte este guia sobre como adicionar/instalar recursos no servidor SQL. Você também pode verificar aqui todos os componentes que podem ser adicionados ao SQL Server, que inclui também a Pesquisa de Texto Completo.

Requisitos de SQL para Insights

Observação: O Insights não suporta autenticação do Azure AD. Se você se autenticar usando o Azure AD, os painéis não podem ser carregados e os dados não podem ser buscados no banco de dados do Microsoft SQL.

O Insights requer o SQL Server 2019 ou 2022, incluindo suporte para índice columnstore e funções .json.

Para Azure SQL, certifique-se de que o banco de dados seja S3 Service Object ou superior.

Verifique se o nível de compatibilidade do banco de dados Insights está definido como 130 ou superior. Na maioria dos casos, as configurações padrão atendem a esse requisito. Para obter mais informações, consulte Exibir ou alterar o nível de compatibilidade de um banco de dados do SQL Server.

A instalação valida ambas as condições e alerta você se os requisitos mínimos não forem atendidos.

SQL requirements for Data Service

O Data Service requer o SQL Server versão 2016 ou superior.

Se você criar seu próprio banco de dados usando o SQL Server versão 2019 ou superior, certifique-se de conceder as seguintes permissões de serviço do Data Service aos seus usuários:

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

SQL requirements for Process Mining

Ao habilitar o Process Mining para a instalação no Automation Suite 2024.10.3 ou superior, você pode optar por trazer um banco de dados PostgreSQL ou um banco de dados Microsoft SQL Server para AutomationSuite_Airflow.

Importante:

Para o Process Mining no Automation Suite 2024.10.3 ou versões posteriores, é recomendável migrar para o PostgreSQL para o banco de dados AutomationSuite_Airflow , pois o PostgreSQL é executado com as versões mais recentes do Apache Airflow. Executar a versão mais recente do Airflow garante que você use novas funcionalidades, desempenho e correções de segurança.

Se você optar por não usar um banco de dados PostgreSQL e continuar usando um banco de dados Microsoft SQLServer, o Process Mining no Automation Suite será executado com o Airflow legado. As versões legadas do Apache Airflow podem não ter funcionalidades, desempenho e correções de segurança.

A partir do Process Mining no Automation Suite 2025.10, apenas o banco de dados PostgreSQL é compatível com o banco de dados AutomationSuite_Airflow .

AutomationSuite_Airflow Banco de dados PostgreSQL

Para o Process Mining no Automation Suite 2024.10.3 ou versões posteriores, você pode optar por usar um banco de dados PostgreSQL para o banco de dados AutomationSuite_Airflow .

Atenção:

Antes de instalar ou atualizar para o Automation Suite 2024.10.3 ou superior, você precisa criar manualmente o banco de dados PostgreSQL para AutomationSuite_Airflow. O banco de dados PostgreSQL para o Airflow não será criado automaticamente pelo instalador.

Observação:

Ao migrar do Microsoft SQL Server para o banco de dados PostgreSQL, a migração de dados não é necessária. Com uma configuração correta, o banco de dados é reconstruído ao executar o Sync Airflow.

Versões do PostgreSQL compatíveis

As versões 12.x a 16.x do PostgreSQL são compatíveis. É recomendável usar a versão mais recente do PostgreSQL dentro desse intervalo para compatibilidade e desempenho ideais.

Requisitos de Hardware

A máquina na qual o banco de dados PostgreSQL para Airflow está instalado deve atender aos seguintes requisitos de hardware.

• Núcleos: 4

• Memória: 16 GiB

• Armazenamento: 64 GiB

• IOPS: >=500 IOPS

Permissões necessárias

O usuário do PostgreSQL Airflow (ou qualquer usuário de banco de dados dedicado) deve ter

• Permissões "Todos os privilégios" para o banco de dados do Airflow designado.

• "todas as concessões" no esquema público do servidor.

• "search_path" definido como "public".

Observação:

Pode ser necessário atualizar o arquivo de autenticação baseada em host do PostgreSQL pg_hba.conf para adicionar o usuário do Airflow à lista de controle de acesso do banco de dados e recarregar a configuração do banco de dados para aplicar as alterações.

O código a seguir mostra um exemplo para configurar um banco de dados 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;

O código a seguir mostra um exemplo de validação de codificação de banco de dados.

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

Consulte a documentação oficial do Airflow para obter mais informações sobre como configurar um banco de dados PostgreSQL para o Airflow.

Porta padrão do servidor

A porta padrão do servidor para as conexões de banco de dados do Airflow com o PostgreSQL é 5432. Se você estiver usando o pool de conexões PgBouncer, é comum usar a porta 6432.

Os blocos de código a seguir mostram alguns exemplos de strings de conexão para PostgreSQL usando a porta 5432.

Exemplo de string de conexão:

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

Exemplo de string de conexão para usar o Kerberos:

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

Exemplo de string de conexão para usar Identidade Gerenciada:

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

A porta padrão do servidor pode ser configurada para usar qualquer porta disponível conforme os requisitos do seu sistema.

PgBouncer

Como o Airflow usa conexões de vida curta, é altamente recomendável configurar o PgBouncer. O PgBouncer é um pool de conexões leve para o PostgreSQL.

Consulte a documentação oficial do PgBouncer para obter mais informações sobre como configurar o PgBouncer.

Observação:

Ao migrar do Microsoft SQL Server para o banco de dados PostgreSQL, a migração de dados não é necessária. Com uma configuração correta, o banco de dados é reconstruído ao executar o Sync Airflow.

AutomationSuite_Airflow Banco de dados do Microsoft SQL Server

Observação:

Para o banco de dados AutomationSuite_Airflow , o Microsoft SQL Server é a única opção disponível para o Process Mining nas versões do Automation Suite 2024.10.2 e anteriores. Para o Process Mining no Automation Suite 2024.10.3 ou versões posteriores, é recomendável migrar para o PostgreSQL.

Se você usar o Microsoft SQL Server para o banco de dados AutomationSuite_Airflow , certifique-se de atender aos seguintes requisitos.

Importante:

Você deve usar a porta padrão do servidor 1433 para as conexões do banco de dados do Airflow.

As portas do servidor SQL não padrão não são suportadas.

Atenção:

Ao configurar o Microsoft SQL Server, certifique-se de que o fuso horário da máquina SQL Server onde o banco de dados Airflow está instalado, esteja definido como UTC.

AutomationSuite_ProcessMining_Warehouse Banco de dados

O Process Mining no Automation Suite requer um Microsoft SQL Server separado para AutomationSuite_ProcessMining_Warehouse para armazenamento de dados para aplicativos de processos do Process Mining.

Importante:

Para garantir o funcionamento adequado do Process Mining, é recomendável usar o Microsoft SQL Server 2022.

Esta é uma visão geral dos requisitos de hardware e recomendações para configurar uma máquina de banco de dados do Microsoft SQL Server para AutomationSuite_ProcessMining_Warehouse.

Para calcular os requisitos de hardware, você precisa ter uma indicação do:

• número de (milhões) de eventos em seu processo.

• the number of case and event fields in your output data.

  Observação: em um ambiente de desenvolvimento, por motivos de desempenho, é recomendável trabalhar em um pequeno conjunto de dados de desenvolvimento com um número limitado de registros.

Você pode usar o Calculador de dimensionamento de instalação do UiPath Automation Suite para determinar os requisitos de hardware para configurar uma máquina dedicada do Microsoft SQL Server para o Process Mining. Ao adicionar o Process Mining na seção Produto, os requisitos mínimos para 1 SQL Server dedicado são exibidos.

Consulte Requisitos de hardware para obter mais informações.

O usuário SQL usado nas strings de conexão deve ter a função db_securityadmin no nível do banco de dados durante e após a instalação para habilitar a segurança por aplicativo no SQL Server do Process Mining. Para obter mais detalhes, consulte a documentação oficial da Microsoft sobre Funções no nível do banco de dados.

Consulte Configuração da segurança do aplicativo de processo para obter mais informações.

Requisitos de SQL para o AI Center

Requisitos para o AI Center instalado em uma máquina habilitada para FIPS 140-2

Para instalar o AI Center em uma máquina habilitada para FIPS 140-2, execute as seguintes etapas:

1. Antes de iniciar a instalação do Automation Suite, siga os seguintes passos:

   1. Ative o FIPS 140-2 na máquina em que planeja instalar o Microsoft Server seguindo as instruções da Microsoft.

   2. Instale o Microsoft SQL Server na máquina habilitada para FIPS 140-2.

   3. Obtenha o certificado do Microsoft SQL Server executando o seguinte comando do SQL Server ou de qualquer servidor que possa se conectar ao servidor SQL com o nome do host SQL configurado:

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

2. Durante a instalação do Automation Suite, execute as seguintes etapas:

   1. Acrescente os seguintes valores à string de conexão sql_connection_string_template_jdbc do AI Center no arquivo input.json : encrypt=true;trustServerCertificate=false;fips=true;.

      Exemplo:

      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"

      Para obter detalhes sobre a configuração do banco de dados, consulte Experiência de instalação avançada e Atualizando o banco de dados SQL.

   2. Adicione o certificado exportado da etapa 1.c. para o armazenamento confiável da máquina host. Para obter detalhes, consulte Atualizando os certificados de CA.

SQL requirements for HA

Para obter uma configuração de alta disponibilidade do SQL Server, selecione um grupo de disponibilidade Always On. Para obter mais informações, consulte Visão geral dos grupos de disponibilidade Always On.

Requisitos SQL para o Orchestrator

Importante: para aumentar o desempenho, evitar deadlocks e evitar leituras sujas no SQL, certifique-se de que a opção READ_COMMITTED_SNAPSHOT esteja definida como ON.

Use esta consulta para verificar se READ_COMMITTED_SNAPSHOT está habilitado ou desabilitado:

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

Se estiver habilitado, o valor retornado será 1.

Se estiver desabilitado, o valor retornado será 0.Use esta consulta para habilitá-lo:

ALTER DATABASE UiPath
SET READ_COMMITTED_SNAPSHOT ON

Se você usar bancos de dados diferentes para Testar Automação e/ou Atualizar Servidor, READ_COMMITTED_SNAPSHOT deve ser habilitado neles também.