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

Bancos de dados

Importante:

• Apenas o Microsoft ODBC Driver 17 é compatível.
• O SQL Server 2016 e 2017 não são compatíveis nas versões do Automation Suite de 2023.10.6 a 2023.10.8. Todas as versões do SQL são compatíveis a partir das versões 2023.10.9 ou posteriores do Automation Suite para todos os aplicativos, exceto o Insights.

Salvo especificação em contrário nas seções dedicadas a 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. A tabela a seguir lista os nomes de bancos de dados e seus formatos correspondentes.

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
Automation Ops	AutomationSuite_Platform	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
Process Mining	AutomationSuite_ProcessMining_Metadata AutomationSuite_ProcessMining_Warehouse2 AutomationSuite_Airflow34	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 O 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 { .

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.

For Process Mining on Automation Suite 2023.10.9 or higher versions, you are recommended to use PostgreSQL for AutomationSuite_Airflow.

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 '.
• for JDBC/ODBC: add { at the beginning of the password and } at the end, and double any other }. You can also use the databases in an elastic pool for better cost-effectiveness.

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.

If security restrictions do not allow the use of db_owner, then the SQL account must have the following roles and permissions on all databases (the only exception is Insights which still requires db_owner).

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

Usamos 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-CBC-SHA
• PSK-AES128-CBC-SHA256
• PSK-AES128-CBC-SHA
• DHE-PSK-AES256-GCM-SHA384
• DHE-PSK-CHACHA20-POLY1305
• DHE-PSK-AES256-CCM
• DHE-PSK-AES128-GCM-SHA256
• DHE-PSK-AES128-CCM
• DHE-PSK-AES256-CBC-SHA
• DHE-PSK-AES128-CBC-SHA256
• DHE-PSK-AES128-CBC-SHA
• ECDHE-PSK-CHACHA20-POLY1305
• ECDHE-PSK-AES256-CBC-SHA
• ECDHE-PSK-AES128-CBC-SHA256
• ECDHE-PSK-AES128-CBC-SHA
• RSA-PSK-AES256-GCM-SHA384
• RSA-PSK-CHACHA20-POLY1305
• RSA-PSK-AES128-GCM-SHA256
• RSA-PSK-AES256-CBC-SHA
• RSA-PSK-AES128-CBC-SHA256
• RSA-PSK-AES128-CBC-SHA

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 oferece suporte à autenticação do Azure AD. Se você se autenticar usando o Azure AD, os painéis não poderão ser carregados e os dados não poderão ser buscados a partir do banco de dados Microsoft SQL.

O Insights requer o SQL Server 2019 ou 2022, incluindo suporte para índice columnstore e funções .json . O SQL Server Enterprise é recomendado devido ao threading e escalabilidade mais eficientes.

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

Certifique-se de que o nível de compatibilidade do banco de dados Insights esteja 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 - 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 2023.10.9 ou posterior, você pode optar por trazer um banco de dados PostgreSQL ou um banco de dados Microsoft SQL Server para AutomationSuite_Airflow.

Importante:

For Process Mining on Automation Suite 2023.10.9 or higher versions, you are recommended to move to PostgreSQL for the AutomationSuite_Airflow database, as PostgreSQL runs with the latest versions of Apache Airflow. Running the latest version of Airflow ensures you make use of new functionality, performance, and security fixes.

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 202310.9 ou versões posteriores, você pode optar por usar um banco de dados PostgreSQL para o banco de dados AutomationSuite_Airflow .

Ao migrar do banco de dados Microsoft SQL Server para PostgreSQL, a migração de dados não é necessária. Com uma configuração correta definida, o banco de dados é recriado 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.

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 2023.10.8 e anteriores. Para o Process Mining no Automation Suite 2023.10.9 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.

Observaçã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 database

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.
• o número de campos de caso e evento em seus dados de saída. 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.

You can use the UiPath Automation Suite Install Sizing Calculator to determine the hardware requirements for setting up a dedicated Microsoft SQL Server machine for Process Mining. When you add Process Mining to the Product section, the minimum requirements for 1 Dedicated SQL Server are displayed. For details, refer to Hardware requirements.

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 detalhes, consulte a documentação oficial da Microsoft sobre Funções no nível do banco de dados e Configuração da segurança do aplicativo de processo.

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.

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. ao armazenamento de confiança da máquina do host. Para obter detalhes, consulte Atualizando os certificados de CA.

SQL requirements for HA

Para uma configuração de alta disponibilidade de seu SQL Server, selecione um grupo de disponibilidade Sempre Ativado. Para obter mais informações, consulte Visão geral dos grupos de disponibilidade Sempre Ativados.

Requisitos SQL para o Orchestrator

Importante:

Para aumentar o desempenho, evite deadlocks e impeça 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 like 'PLACEHOLDER'

Certifique-se de substituir PLACEHOLDER pelo nome do banco de dados do Orchestrator.

Se estiver habilitado, o valor retornado será 1.

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

ALTER DATABASE PLACEHOLDER
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.