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

Bancos de dados

Importante:

• Apenas o Microsoft ODBC Driver 17 é compatível.
• As versões 2.2510.0 e superiores do Automation Suite são compatíveis com as versões 2019 e superiores do SQL.

Observação:

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. 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
Automation Ops	AutomationSuite_Platform	ADO.NET
Data Service	AutomationSuite_DataService	ADO.NET
Insights	AutomationSuite_Insights	ADO.NET
Test Manager	AutomationSuite_Test_Manager	ADO.NET
AI Center	AutomationSuite_AICenter	JDBC
Apps	AutomationSuite_Apps 1	ODBC
Document Understanding	AutomationSuite_DU_Datamanager	ODBC PYODBC
Process Mining2	AutomationSuite_ProcessMining_Metadata AutomationSuite_ProcessMining_Warehouse3 AutomationSuite_Airflow4	ADO.NET PYODBC PSYCOPG2
Soluções	AutomationSuite_Platform	ADO.NET

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

²Para minimizar os problemas de latência, é altamente recomendável implantar os bancos de dados do Process Mining na mesma região que o recurso de computação (cluster do Kubernetes).

³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 SQLAlchemy. A conexão com o banco de dados AutomationSuite_Airflow não pode começar com um caractere { .

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
• EXECUTE permissão no esquema dbo, dt, authz, e messagebus

Observação:

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

Importante:

Due to a known issue, in Automation Suite versions 2.2510.0 and 2.2510.1 you cannot use a custom database name for the Platform database if Process Mining is enabled. If you specify a custom name, the OMS backfill job fails.

To avoid this, use AutomationSuite_Platform as the Platform database name when installing Process Mining.

Quando você habilita o Process Mining para a instalação no Automation Suite, é necessário trazer um banco de dados PostgreSQL para AutomationSuite_Airflow.

Importante:

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

AutomationSuite_Airflow banco de dados PostgreSQL

Observação:

Antes de instalar ou atualizar para o Automation Suite 2.2510 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: 128 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_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.
• the number of case and event fields in your output data.
  Observação:

  In a development environment, for performance reasons, it is recommended to work on a small development dataset with a limited number of records.

Você pode usar a Calculadora 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 no nível do banco de dados db_securityadmin 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.

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

Observação:

É recomendável habilitar a diferenciação entre maiúsculas e minúsculas nos nomes de tabelas e colunas usando o seguinte comando:

ALTER DATABASE AutomationSuite_ProcessMining_Warehouse COLLATE SQL_Latin1_General_CP1_CS_AS

Isso evita erros ao carregar dados causados por colunas com nomes semelhantes, como ID e id. Isso também garante que os valores textuais que diferem apenas em letras maiúsculas ou minúsculas sejam tratados como distintos. Por exemplo:

• 'activity 1' == 'activity 1'
• 'Activity 1' != 'activity 1'

Isso evita problemas de duplicação em transformações SQL.

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

Para processar a mesma fila com vários robôs e se o isolamento de instantâneo estiver ativado, certifique-se de que a opção ALLOW_SNAPSHOT_ISOLATION esteja definida como ON.

Use esta consulta para verificar se READ_COMMITTED_SNAPSHOT e ALLOW_SNAPSHOT_ISOLATION estão habilitados ou desabilitados:

SELECT is_read_committed_snapshot_on, snapshot_isolation_state FROM sys.databases
   WHERE name like 'PLACEHOLDER'

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

Se as configurações estiverem habilitadas, o valor retornado será 1.

Se as configurações estiverem desabilitadas, o valor retornado será 0. Use esta consulta para habilitá-lo:

# To enable READ_COMMITTED_SNAPSHOT
ALTER DATABASE <PLACEHOLDER>
SET READ_COMMITTED_SNAPSHOT ON

# To enable ALLOW_SNAPSHOT_ISOLATION
ALTER DATABASE <PLACEHOLDER>
SET ALLOW_SNAPSHOT_ISOLATION ON

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

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