Etapa 4: configuração de bancos de dados SQL

Bancos de dados

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.

Cada produto do Automation Suite requer seu próprio banco de dados SQL com especificações correspondentes.

Por padrão, o instalador cria todos os bancos de dados para você durante o processo de instalação. Você deve fornecer as permissões necessárias para que o instalador faça isso no seu servidor SQL.

Como alternativa, você pode criar seus próprios bancos de dados. Consulte a tabela a seguir para os nomes que você precisa usar.

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.

A tabela a seguir lista os nomes dos bancos de dados e seu formato correspondente.

Produto / Serviço	Nome do banco de dados padrão	Formato da string de conexão
Recursos de plataforma compartilhados	AutomationSuite_Platform	ADO.NET
Orchestrator	AutomationSuite_Orchestrator	ADO.NET
Action Center	AutomationSuite_Orchestrator	ADO.NET
Automation Suite Robots	AutomationSuite_Orchestrator	ADO.NET
Automation Hub	AutomationSuite_Automation_Hub	ADO.NET
Data Service	AutomationSuite_DataService	ADO.NET
Insights	AutomationSuite_Insights	ADO.NET
Test Manager	AutomationSuite_Test_Manager	ADO.NET
Task Mining	AutomationSuite_Task_Mining	ADO.NET
AI Center	AutomationSuite_AICenter	JDBC
Apps	AutomationSuite_Apps 1	ODBC
Document Understanding	AutomationSuite_DU_Datamanager	ODBC PYODBC
Process Mining	AutomationSuite_ProcessMining_Metadata AutomationSuite_ProcessMining_Warehouse2 AutomationSuite_Airflow3 4	ADO.NET PYODBC PSYCOPG2

¹ A senha para o banco de dados do Apps não deve conter #{.

² AutomationSuite_ProcessMining_Warehouse utiliza os formatos ADO.NET e PYODBC.

³AutomationSuite_Airflow O banco de dados PostgreSQL usa o formato de string de conexão SQL alchemy. A conexão com o banco de dados AutomationSuite_Airflow não pode começar com um caractere { .

⁴AutomationSuite_Airflow Banco de dados Microsoft SQL Server usa o formato de string de conexão SQL alchemy. AutomationSuite_Airflow deve estar com READ_COMMITTED_SNAPSHOT habilitado ao criar bancos de dados manualmente. A conexão com o banco de dados AutomationSuite_Airflow não pode começar com um caractere { .

Atenção:

Para Process Mining no Automation Suite 2024.10.3 ou versões posteriores, é recomendável usar o PostgreSQL para AutomationSuite_Airflow .

Importante:

Se você definir manualmente as strings de conexão no arquivo de configuração, poderá usar o caractere de escape em senhas SQL, JDBC ou ODBC da seguinte maneira:

• para SQL: adicione ' no início e no fim da senha, e duplique qualquer outro '.
• para JDBC/ODBC: adicione { no início da senha e } no final, e duplique qualquer outro }

Observação:

Você pode usar os bancos de dados em um pool elástico para obter uma melhor relação custo-benefício.

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.

Permissões

Se você quiser que o instalador crie um banco de dados no SQL Server fornecido, certifique-se de conceder pelo menos a função dbcreator à conta SQL usada para se conectar ao banco de dados.

Se você quiser criar seus próprios bancos de dados para todos os produtos, você deve conceder à conta SQL a função db_owner para todos os bancos de dados do Automation Suite.

Se as restrições de segurança não permitirem o uso de db_owner, a conta SQL deverá ter as seguintes funções e permissões em todos os bancos de dados (a única exceção é o Insights, que ainda requer db_owner).

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

Observação: usamos apenas as funções db_securityadmin e db_ddladmin durante a instalação ou se os bancos de dados forem reprovisionados; então, você pode revogar essas permissões posteriormente.

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 conectado a um Orchestrator externo

Se você instalar um AI Center que se conecta a um Orchestrator externo, deve certificar-se de criar um novo banco de dados chamado AutomationSuite_Platform para os serviços do AI Events e do AI Storage.

Importante: atualmente, o AI Center requer o SQL Server versão 2019 e superior para funcionar de forma otimizada.

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