更新 SQL 连接字符串

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

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

  Automation Suite 中的产品在更新 SQL 数据库连接字符串时不会创建表或架构。 确保新的连接字符串引用您当前使用的同一数据库。

  为避免在更新过程中出现停机，请确保当前连接字符串在更新过程中有效。 您可以在更新后撤销旧的连接字符串。

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

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

1. 生成 cluster_config.json 文件。
2. 为已安装的产品提供新的连接字符串。
3. 运行服务安装程序。

步骤 1：生成 cluster_config.json 文件

生成最新的 cluster_config.json 文件，如下所示：

• 答：如果您有旧的 cluster_config.json，请使用以下命令从集群生成配置文件：

  cd /opt/UiPathAutomationSuite/{version}/installer
  
  ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

• B：如果您没有旧的 cluster_config.json 文件，请使用以下命令覆盖在安装先前版本期间产生的任何默认值：

  cd /opt/UiPathAutomationSuite/{version}/installer
  
  ./configureUiPathAS.sh config get -o ./cluster_config.json

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

步骤 2：为已安装的产品提供新的连接字符串

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

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

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

重要提示：

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

• 对于 NET：在密码的开头和结尾添加 ' ，并将任何其他 '加倍。

• 对于 JDBC/ODBC：在密码的开头添加 { ，在密码的末尾添加 } ，并将其他任何 }加倍。

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

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

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

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

提示：

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

• 单节点评估： 配置 Microsoft SQL Server

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

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

参数	描述	产品
sql_connection_string_template	完整的 ADO.NET 连接字符串，其中目录名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	平台、Orchestrator、Test Manager、Automation Hub、Automation Ops、Insights、Task Mining、Data Service
sql_connection_string_template_jdbc	完整的 JDBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	AI Center
sql_connection_string_template_odbc	完整的 ODBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Document Understanding

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

注意： 使用要更新的新连接字符串模板更新 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 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
}

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": {
  "datamanager": {
    "sql_connection_str": "***" // odbc connection string
  }
}

Insights

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

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

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

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
}

步骤 3：运行服务安装程序

在线

要在在线环境中运行服务安装程序，请使用以下命令：

cd /opt/UiPathAutomationSuite/{version}/installer

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

离线

要在离线环境中运行服务安装程序，请使用以下命令：

cd /opt/UiPathAutomationSuite/{version}/installer

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

步骤 4：重新启动 Test Manager 和 Document Understanding 的 Pod

备注：

仅当您修改了 Test Manager 或 Document Understanding 的 SQL 连接字符串时，才需要执行此步骤。

1. 获取所有 Test Manager/Document Understanding Pod 的列表：

   // for Test Manager
   kubectl get pods -A | grep testmanager | awk '{print $2}'
   
   //for Document Understanding
   kubectl get pods -A | grep du-datamanager | awk '{print $2}'

2. 删除所有列出的 Pod。这将强制 Pod 使用正确的 SQL 连接字符串重新启动。

   kubectl delete pods <pod name>