更新 SQL 连接字符串

在多种情况下，您可能需要更新 Automation Suite 产品用于连接 SQL 数据库的连接字符串，例如：

• 出于安全性和合规性考虑，定期轮换用于连接到数据库的密码时
• 更改 SQL Server 的 FQDN 时
• 出于维护目的将数据库迁移到另一个 SQL Server 时
• 添加、修改或删除一个或多个连接属性，例如MultiSubnetFailover
• 从基本身份验证切换到使用 Kerberos 和 AD 的集成身份验证时
  重要提示：

  Automation Suite 中的产品在更新 SQL 数据库连接字符串时不会创建表格或架构。确保新的连接字符串引用您当前使用的同一个数据库。为了避免更新过程中出现停机，请确保当前连接字符串在更新过程中有效。您可以在更新后撤销旧的连接字符串。

更新已安装产品的连接字符串

要更新 Automation Suite 中已安装产品的连接字符串，请连接到任何服务器节点并执行以下操作。

1. 如果使用“帐户锁定阈值策略设置”，请启用维护模式。
2. 生成 cluster_config.json 文件。
3. 在cluster_config.json中为已安装的产品提供新的连接字符串。
4. 运行服务安装程序。
5. 如果使用“帐户锁定阈值策略设置”，请禁用维护模式。

生成 cluster_config.json 文件

使用以下命令生成最新的 cluster_config.json 文件：

./bin/uipathctl manifest get-revision > ./cluster_config.json

备注：

有关如何配置cluster_config.json参数的详细信息，请参阅高级安装体验。

为已安装的产品提供新的连接字符串

有两种方法可以为 Automation Suite 中运行的产品提供连接字符串：

• 答：提供一个对在 Automation Suite 中运行的所有产品通用的连接字符串模板。 此方法将假定所有产品的默认数据库名称。
• B：提供特定于每个产品的连接字符串。

重要提示：

请确保对 NET、JDBC 或 ODBC 密码进行转义，如下所示：

• 对于 NET：在密码的开头和结尾添加' ，并将任何其他'添加一倍。
• 对于 JDBC/ODBC：在密码的开头添加{ ，在结尾添加} ，并将任何其他}双击。不要加倍{ 。

如果设置了 TrustServerCertificate=False，则可能必须为 SQL Server 提供其他 CA 证书。如果 SQL Server 证书是自签名证书或由内部 CA 签名，则此为必要项。有关详细信息，请参阅更新 CA 证书。

要使用 PowerShell 对 Base64 字符串进行编码或解码，您可以使用以下命令：

• 解码 Base64 字符串： [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• 对 Base64 字符串进行编码： [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

答：为所有产品提供通用连接字符串

Automation Suite 中运行的所有产品都引用一个通用模板连接字符串。 选择此方法的一个用例是，您想一次更改所有产品的密码。请注意，在这种情况下，所有产品的密码都相同。

在这种情况下，所有产品的数据库名称必须是默认名称，这是 Automation Suite 的要求。 如果您配置的数据库名称不满足 Automation Suite 要求，请执行下一步。

提示：

检查数据库列表及其默认名称：

• 单节点评估：配置 Microsoft SQL Server
• 多节点 HA 就绪生产：配置 Microsoft SQL Server

下表说明了产品服务接受的模板格式：

参数	描述	产品
sql_connection_string_template	完整的 ADO.NET 连接字符串，其中目录名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Platform、Orchestrator、Automation Suite Robots、Test Manager、Automation Hub、Automation Ops、Insights、Task Mining、Data Service、Process Mining
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（2023.10.9 或更高版本）

sql_connection_string_template 示例

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=testadmin;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://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

postgresql_connection_string_template_sqlalchemy_pyodbc 示例 (Process Mining 2023.10.9 或更高版本)

"postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/DB_NAME_PLACEHOLDER"

备注：

使用要更新的新连接字符串模板更新cluster_config.json 。

B：提供特定于每个产品的连接字符串

平台

Platform 服务提供管理功能，例如组织和租户管理、许可管理、用户管理等。 Platform 服务默认处于启用状态，并且无法删除。 其默认数据库名称为AutomationSuite_Platform 。

要为 Platform 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"platform": {
  "sql_connection_str": "***" // dotnet connection string 
}

Orchestrator

Orchestrator 的默认数据库名称为AutomationSuite_Orchestrator 。

要为 Orchestrator 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"orchestrator": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Suite 机器人

默认情况下，Automation Suite 机器人和 Orchestrator 共享同一数据库。 数据库名称为AutomationSuite_Orchestrator 。

要为 Automation Suite 机器人提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"asrobots": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Hub

Automation Hub 的默认数据库名称为AutomationSuite_Automation_Hub 。

要为 Automation Suite 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"automation_hub": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Ops

Automation Ops 的默认数据库名称为AutomationSuite_Platform 。

要为 Automation Ops 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"automation_ops": {
  "sql_connection_str": "***" // dotnet connection string
}

AI Center

AI Center 的默认数据库名称为AutomationSuite_AICenter 。

要为 AI Center 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"aicenter": {
  "sql_connection_str": "***" // jdbc connection string
}

重要提示：

要在安装了 AI Center 的计算机上启用 FIPS 140-2，必须将以下内容附加到sql_connection_string_template_jdbc ： encrypt=true;trustServerCertificate=false;fips=true;

Apps

Apps 的默认数据库名称为 AutomationSuite_Apps。

要为 Apps 服务提供连接字符串，请在 cluster_config.json 文件中添加或更新以下部分：

"apps": {
  "sql_connection_str": "***" // odbc connection string
}

Data Service

Data Service 的默认数据库名称为AutomationSuite_DataService 。

要为 Data Service 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"dataservice": {
  "sql_connection_str": "***" // dotnet connection string
}

Document Understanding

Document Understanding 的默认数据库名称为AutomationSuite_DU_Datamanager 。

要为 Document Understanding 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"documentunderstanding": { 
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 "pyodbc_sql_connection_str": "***" // python sql connection string
 }
}

Insights

Insights 的默认数据库名称为AutomationSuite_Insights 。

要为 Insights 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"insights": {
  "sql_connection_str": "***" // dotnet connection string
}

Process Mining

Process Mining 的默认数据库名称为AutomationSuite_ProcessMining_Metadata 。

要为 Process Mining 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

对于 PostgreSQL：

"process_mining": {
    "enabled": true,
    "sql_connection_str": "***", // dotnet connection string
    "airflow": {
        "metadata_db_connection_str": ""
    },
    "warehouse": {
        "sql_connection_str": "",
        "master_sql_connection_str": "",
        "sqlalchemy_pyodbc_sql_connection_str": ""
    }
}

对于 Microsoft SQL Server：

"process_mining": {
  "enabled": true,
  "sql_connection_str": "***" // dotnet connection string
  "sqlalchemy_pyodbc_sql_connection_str": "", 
  "warehouse": {
     "sql_connection_str": "",
     "master_sql_connection_str": "",
     "sqlalchemy_pyodbc_sql_connection_str": ""
  }
}

Task Mining

Task Mining 的默认数据库名称为AutomationSuite_Task_Mining 。

要为 Task Mining 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"task_mining": {
  "sql_connection_str": "***" // dotnet connection string
}

Test Manager

Test Manager 的默认数据库名称为 AutomationSuite_Test_Manager。

要为 Test Manager 服务提供连接字符串，请在cluster_config.json文件中添加或更新以下部分：

"test_manager": {
  "sql_connection_str": "***" // dotnet connection string
}

运行服务安装程序

要运行服务安装程序，请使用以下命令：

cd /opt/UiPathAutomationSuite/{version}/installer

./install-uipath.sh -i ./cluster_config.json -s -o output.json --accept-license-agreement