SQL 数据库

注意：除非专用要求部分另有说明，否则这些要求适用于所有 Automation Suite 产品。

您必须引入外部 SQL Server 才能安装 Automation Suite 和 UiPath™ 产品。 支持 Microsoft SQL Server 2017、2019 和 2022 标准版和企业版。

重要提示：目前，Orchestrator 和 AI Center 需要 SQL Server 2019 及更高版本才能最佳运行。

只要 Microsoft SQL Server 数据库引擎满足要求，其他 Microsoft SQL 平台（例如 Azure SQL 数据库、Azure SQL 托管实例或 Amazon 关系数据库服务）也受支持。 有关详细信息，请参阅兼容性矩阵。

备注：

如果启用了 Process Mining，并且您想使用最新版本的 Airflow，则AutomationSuite_Airflow数据库需要 PostgreSQL。(版本 2024.10.3 或更高版本。)

有关详细信息，请参阅Process Mining 的 SQL 要求。

备注：

确保可以从集群节点访问 SQL Server。

各个产品支持的配置各不相同。

对于计划部署的每个产品，您必须：

• 根据产品的要求检查 SQL Server 的支持版本；
• 满足 SQL Server 配置要求，包括 SQL Server 用户权限（产品要求）。

Microsoft SQL Server 的一般最低硬件要求如下：

• 8 (v-)CPU
• 32 GB RAM
• 256 GB 固态硬盘

最低要求是一般指导原则，并不能保证在生产部署中可靠地运行。 您需要进行容量规划，以确定可靠运行的硬件要求。 有关详细信息，请参阅容量规划。

每个 UiPath™ 产品都需要有自己的 SQL 数据库。

数据库创建工作流

交互式安装程序使用以下工作流自动创建数据库：

1. 交互式安装程序脚本会检查input.json文件中sql.create_db参数的值。
   • 如果sql.create_db参数设置为true ，则安装程序会代表您自动生成所有数据库。 在这种情况下，安装程序将使用默认数据库名称和默认模板，并忽略您提供的任何自定义数据库名称。

     有关详细信息，请参阅自动创建必要的数据库。

   • 如果将sql.create_db设置为false ，则您必须使用自己的数据库。 在这种情况下，您必须手动设置数据库。 请注意，您可以使用自定义数据库名称，前提是遵循提供的命名约定。 此步骤至关重要，因为我们将数据库名称与连接模板结合使用来构成数据库连接字符串。 如果您不遵循建议的命名约定，则必须自己提供 SQL 连接字符串。

     有关详细信息，请参阅使用自己的数据库。

2. 交互式安装程序会生成连接字符串，如下所示：

   • 如果您没有为服务定义连接字符串，则安装程序将使用连接模板生成所有数据库连接字符串。

   • 如果您为服务定义了连接字符串，则安装程序将使用为数据库提供的连接字符串。

自动创建必要的数据库

如果您希望安装程序创建数据库，请填写input.json文件的以下字段：

参数	描述
sql.create_db	设置为true以允许安装程序创建数据库。 请注意，安装程序将使用默认数据库名称和默认模板，并忽略您提供的任何自定义数据库名称。
sql.server_url	您希望安装程序在其中配置数据库的 SQL Server 的 FQDN。
sql.port	SQL Server 中应托管数据库实例的端口号。
sql.username	用于连接到 SQL Server 的用户名/用户 ID。
sql.password	之前提供的用于连接到 SQL Server 的用户名密码。

备注：

• 确保用户具有 dbcreator 角色。这将授予他们在 SQL Server 中创建数据库的权限。否则，安装将失败。
• 自动创建必要的数据库不能与目录身份验证结合使用。如果使用目录身份验证，则必须使用自己的数据库。
• ODBC 连接不支持包含特殊字符的用户名。对于 AI Center、Document Understanding 和 Apps 的数据库用户名，请仅使用大写和小写字母。

重要提示：

对于 Automation Suite 2024.10.3 或更高版本上的 Process Mining，建议对 Airflow 数据库使用 PostgreSQL。如果您选择使用 PostgreSQL 数据库，则需要在安装或升级到 Automation Suite 2024.10.3 或更高版本之前手动为AutomationSuite_Airflow创建 PostgreSQL 数据库。安装程序不会自动创建适用于 Airflow 的 PostgreSQL 数据库。

有关详细信息，请参阅Process Mining 的 SQL 要求。

请自带数据库

如果您选择为新安装的 Automation Suite 使用自己的数据库，我们强烈建议设置新的数据库，而不是使用现有数据库。此预防措施有必要，以防止旧数据库中的剩余元数据与 Automation Suite 的操作发生任何冲突。

如果您有自己的数据库，则必须为每个数据库提供 SQL 连接字符串。Automation Suite 支持以下 SQL 连接字符串格式：

注意：对于 Document Understanding，请确保使用同一个数据库，除非另有明确说明。特定的连接字符串分配给连接到同一数据库的各种服务和作业。

参数	描述	产品
sql_connection_string_template	完整的 ADO.NET 连接字符串，其中目录名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	平台 Orchestrator Automation Suite 机器人 Test Manager Automation Hub Automation Ops Insights Data Service Process Mining Document Understanding
sql_connection_string_template_jdbc	完整的 JDBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	AI Center
sql_connection_string_template_odbc	完整的 ODBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Document Understanding Apps
sql_connection_string_template_sqlalchemy_pyodbc	完整的 SQL alchemy ODBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Document Understanding Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	完整的 SQL alchemy PSYCOPG2连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Process Mining（2024.10.3 或更高版本）

重要提示：

确保已向连接字符串中指定的 SQL 帐户授予所有 Automation Suite 数据库的 db_owner 角色。如果安全限制不允许使用 db_owner，则 SQL 帐户应在所有数据库上具有以下角色和权限：

• db_securityadmin
• db_ddladmin
• db_datawriter
• db_datareader
• 对 dbo 架构的 EXECUTE 权限

需要为 Insights 分配 db_owner 角色才能成功安装。

备注：

默认情况下将 TrustServerCertificate 设置为 False，并且您必须为 SQL Server 提供其他 CA 证书。如果 SQL Server 证书是自签名证书或由内部 CA 签名，则此为必要项。如果在这种情况下不提供 SQL Server 证书，先决条件检查将无法通过。

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;

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"

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

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"

postgresql_connection_string_template_sqlalchemy_pyodbc 示例 (Process Mining)

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

sql_connection_string_template和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"

sql_connection_string_template 和 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"

Automation Suite 服务的默认和可选 DB 名称

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

备注：

如果要覆盖上述任何服务的连接字符串，请为该特定服务设置sql_connection_str 。

在运行安装程序之前，您仍然必须手动创建这些数据库。

覆盖 Orchestrator 和平台的默认连接字符串

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

要覆盖其他产品的数据库连接字符串，请在相应的产品块中设置 sql_connection_str。连接字符串应具有相应产品支持的格式。

为 AI Center 设置数据库连接字符串的示例

参数	描述
aicenter.sql_connection_str	AI Center JDBC 连接字符串

注意：确保 JDBC 连接字符串具有以下示例中的格式：

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

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

注意：仅当您要用自己的连接字符串覆盖默认值时，Data Manager SQL 连接字符串才为可选。

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

示例 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;",  
},

备注：

使用 Kerberos 身份验证时，请利用Integrated Security和Trusted_Connection参数。 通过将Integrated Security设置为true并将Trusted_Connection设置为yes ，即可将当前登录用户的凭据用于连接。 在这种情况下，您无需指定单独的用户名和密码。

重要提示：

请注意，模板PYODBC 连接字符串postgresql_connection_string_template_sqlalchemy_pyodbc （用于 PostgreSQL）和sql_connection_string_template_sqlalchemy_pyodbc （用于 MS SQL Server）的名称与您自带数据库时使用的 PYODBC 连接字符串sqlalchemy_pyodbc_sql_connection_str名称不同。此外，当您使用自己的数据库时，模板 SQL sql_connection_string_template和sql_connection_str的连接字符串名称也不同。

重要提示：

如果您有自己的数据库，并且您已在input.json文件的processmining部分中使用sql_connection_str和sqlalchemy_pyodbc_sql_connection_str连接字符串配置，则模板连接字符串分别sql_connection_string_template和postgresql_connection_string_template_sqlalchemy_pyodbc （用于 PostgreSQL）如果指定，则会忽略sql_connection_string_template_sqlalchemy_pyodbc （适用于 MS SQL Server）。

注意：

设置MultiSubnetFailover=True为sql_connection_str和master_sql_connection_str ，并设置MultiSubnetFailover=Yes为sqlalchemy_pyodbc_sql_connection_str连接字符串。

请注意，对于pyodbc需使用“ =Yes”而非“ =True” 。

注意：根据 app_security_mode 设置，系统或者会为每个 Process Mining 应用程序创建一个新的 SQL 用户（app_security_mode="system_managed"），或者会创建用于所有流程应用程序的单个 SQL 用户帐户（app_security_mode="single_account"）。请注意，app_security_mode="system_managed" 是默认设置，这需要数据库用户的高级权限。

请参阅配置流程应用程序安全性。

Process Mining 连接字符串示例

• 场景：使用 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;"
      },
  },

• 场景：使用 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"
  },

Process Mining 连接字符串示例

• 场景：元数据数据库和数据仓库使用单独的 SQL Server（非 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;",  
},

Process Mining 连接字符串示例

• 场景：使用自定义 app_security_mode。

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

SQL 排序规则

Automation Suite 已在服务器和数据库级别支持将 SQL 排序规则设置为 SQL_Latin1_General_CP1_CI_AS。我们强烈建议您使用此特定设置，以获得最佳性能和稳定性。

虽然您可以灵活使用所选的排序规则，但请注意，未经测试的配置可能会导致意外问题。

重要提示：

我们不建议使用二进制 SQL 或任何区分大小写的排序规则，因为它们会导致安装 Automation Suite 时出现已知问题。

SQL Server 密码

Automation Suite 仅支持列出的 SQL 密码：

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

全文搜索的 SQL 要求

Document Understanding 要求 SQL Server 具有 SQL Server 数据库引擎的全文搜索组件，默认情况下并不总是安装该组件。

如果您在安装 SQL Server 时没有选择全文搜索，请在配置 Document Understanding 之前再次运行 SQL Server 安装程序以进行添加。

有关更多信息，请查看本指南，了解如何在 SQL Server 上添加/安装功能。您还可以在此处查看可添加到 SQL Server 的所有组件，其中也包括全文搜索。

Insights 的 SQL 要求

注意： Insights 不支持 Azure AD 身份验证。 如果您使用 Azure AD 进行身份验证，则无法加载仪表板，也无法从 Microsoft SQL 数据库获取数据。

Insights 要求使用支持列存储索引和 .json 函数的 SQL Server 2019 或 2022。

对于 Azure SQL，请确保数据库为 S3 服务目标或更高。

确保将 Insights 数据库的兼容性级别设置为 130 或更高。在大多数情况下，默认设置可满足此要求。有关详细信息，请参阅查看或更改数据库 (SQL Server) 的兼容性级别。

安装将验证这两个条件，并在未达到最低要求时向您发出警示。

Data Service 的 SQL 要求

Data Service 需要 SQL Server 2016 或更高版本。

如果您使用 SQL Server 2019 或更高版本创建自己的数据库，请确保向用户授予以下 Data Service 权限：

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

Process Mining 的 SQL 要求

在 Automation Suite 2024.10.3 或更高版本上启用 Process Mining 安装时，您可以为AutomationSuite_Airflow选择使用 PostgreSQL 数据库或 Microsoft SQL Server 数据库。

重要提示：

对于 Automation Suite 2024.10.3 或更高版本上的 Process Mining，建议您将AutomationSuite_Airflow数据库迁移到 PostgreSQL，因为 PostgreSQL 与最新版本的 Apache Airflow 一起运行。运行最新版本的 Airflow 可确保您使用新功能、性能和安全修复程序。

如果您选择不使用 PostgreSQL 数据库并继续使用 Microsoft SQLServer 数据库，则 Automation Suite 上的 Process Mining 将使用旧版 Airflow 运行。旧版 Apache Airflow 可能缺少功能、性能和安全修复程序。

从 Automation Suite 2025.10 上的 Process Mining 开始， AutomationSuite_Airflow数据库仅支持 PostgreSQL 数据库。

AutomationSuite_Airflow PostgreSQL 数据库

对于 Automation Suite 2024.10.3 或更高版本上的 Process Mining，您可以选择对AutomationSuite_Airflow数据库使用 PostgreSQL 数据库。

注意：

在安装或升级到 Automation Suite 2024.10.3 或更高版本之前，您需要为AutomationSuite_Airflow手动创建 PostgreSQL 数据库。安装程序不会自动创建适用于 Airflow 的 PostgreSQL 数据库。

备注：

从 Microsoft SQL Server 迁移到 PostgreSQL 数据库时，不需要数据迁移。使用正确的配置设置，运行 Sync Airflow 时将重建数据库。

支持的 PostgreSQL 版本

支持 PostgreSQL 版本 12.x 至 16.x。建议使用此范围内的最新版本的 PostgreSQL，以获得最佳兼容性和性能。

硬件要求

安装了适用于 Airflow 的 PostgreSQL 数据库的计算机必须满足以下硬件要求。

• 核心数： 4

• 内存： 16 GiB

• 存储： 64 GiB

• IOPS： >= 500 IOPS

所需权限

PostgreSQL Airflow 用户（或任何专用数据库用户）必须

• 指定 Airflow 数据库的“所有权限”权限。

• 服务器公共架构上的“所有授权”。

• 将“search_path”设置为“公开”。

备注：

您可能需要更新 PostgreSQL 基于主机的身份验证文件pg_hba.conf ，以将 Airflow 用户添加到数据库访问控制列表，然后重新加载数据库配置以应用更改。

以下代码显示了设置 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;

以下代码显示了一个数据库编码验证示例。

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

有关如何为 Airflow 设置 PostgreSQL 数据库的更多信息，请参阅官方Airflow 文档。

默认服务器端口

Airflow 数据库与 PostgreSQL 连接的默认服务器端口为5432 。如果您使用的是 PgBounder 连接池程序，通常要使用端口6432 。

以下代码块显示了使用端口5432 PostgreSQL 的一些示例连接字符串。

示例连接字符串:

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

使用 Kerberos 的示例连接字符串：

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

使用托管身份的示例连接字符串：

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

可以根据系统要求，将默认服务器端口配置为使用任何可用端口。

PG 保票员

由于 Airflow 使用短期连接，因此强烈建议您设置 PgBooker。PgBunker 是一个用于 PostgreSQL 的轻量级连接池程序。

有关如何设置 PgBooker 的更多信息，请参阅PgB runtimer 官方文档。

备注：

从 Microsoft SQL Server 迁移到 PostgreSQL 数据库时，不需要数据迁移。使用正确的配置设置，运行 Sync Airflow 时将重建数据库。

AutomationSuite_Airflow Microsoft SQL Server 数据库

备注：

对于AutomationSuite_Airflow数据库，Microsoft SQL Server 是 Automation Suite 2024.10.2 版及更早版本上可用于 Process Mining 的唯一选项。对于 Automation Suite 2024.10.3 或更高版本上的 Process Mining，建议您迁移到 PostgreSQL。

如果将 Microsoft SQL Server 用于AutomationSuite_Airflow数据库，请确保满足以下要求。

重要提示：

您必须使用默认服务器端口1433进行 Airflow 数据库连接。

不支持非标准 SQL 服务器端口。

注意：

设置 Microsoft SQL Server 时，请确保将安装 Airflow 数据库的 SQL Server 计算机的时区设置为 UTC。

AutomationSuite_ProcessMining_Warehouse数据库

Automation Suite 上的 Process Mining 需要单独的 Microsoft SQL Server 用于AutomationSuite_ProcessMining_Warehouse ，以便为 Process Mining 流程应用程序存储数据。

重要提示：

为确保 Process Mining 正常运行，建议使用 Microsoft SQL Server 2022。

以上概述了为AutomationSuite_ProcessMining_Warehouse设置 Microsoft SQL Server 数据库计算机的硬件要求和建议。

要计算硬件要求，您需要了解以下内容：

• 流程中的 (百万) 个事件数。

• 输出数据中案例和事件字段的数量。

  注意：在开发环境中，出于性能考虑，建议使用记录数有限的小型开发数据集。

您可以使用UiPath Automation Suite 安装规格计算器来确定硬件要求，从而为 Process Mining 设置专用的 Microsoft SQL Server 计算机。将 Process Mining 添加到“产品部分”时，系统将显示 1 个专用 SQL Server 的最低要求。

有关更多信息，请参阅硬件要求。

连接字符串中使用的 SQL 用户必须在安装期间和安装后具有db_securityadmin数据库级别角色，才能在 Process Mining 数据仓库 SQL Server 上启用基于应用程序的安全性。 有关详细信息，请参阅 Microsoft 官方文档数据库级别角色。

有关更多信息，请参阅配置流程应用程序安全性。

AI Center 的 SQL 要求

在启用 FIPS 140-2 的计算机上安装 AI Center 的要求

要在启用 FIPS 140-2 的计算机上安装 AI Center，请执行以下步骤：

1. 在开始安装 Automation Suite 之前，请执行以下步骤：

   1. 按照 Microsoft 说明，在计划安装 Microsoft Server 的计算机上启用 FIPS 140-2。

   2. 在已启用 FIPS 140-2 的计算机上安装 Microsoft SQL Server。

   3. 通过从 SQL Server 或任何可以连接到具有已配置 SQL 主机名的 SQL Server 的服务器运行以下命令，以获取 Microsoft SQL Server 证书：

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

2. 在安装 Automation Suite 期间，请执行以下步骤：

   1. 在input.json文件中，将以下值附加到 AI Center sql_connection_string_template_jdbc连接字符串： encrypt=true;trustServerCertificate=false;fips=true; 。

      示例：

      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"

      有关数据库配置的详细信息，请参阅高级安装体验和更新 SQL 数据库。

   2. 将从步骤 1.c 中导出的证书添加到主机的信任存储区。有关详细信息，请参阅更新 CA 证书。

HA 的 SQL 要求

对于 SQL Server 的高可用性配置，请选择“始终开启”可用性组。有关详细信息，请参阅AlwaysOn 可用性组概述。

Orchestrator 的 SQL 要求

重要提示：为提高性能、避免死锁并防止 SQL 中的脏读，请确保将“READ_COMMITTED_SNAPSHOT”选项设置为“ON”。

使用以下查询检查 READ_COMMITTED_SNAPSHOT 是否已启用：

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

如果已启用，则返回的值为 1。

如果已禁用，则返回的值为 0。使用以下查询启用它：

ALTER DATABASE UiPath
SET READ_COMMITTED_SNAPSHOT ON

如果您对测试自动化和/或更新服务器使用不同的数据库，则还必须在这些数据库上启用 READ_COMMITTED_SNAPSHOT。