Tricentis Tosca接入他人创建的MS SQL DB多用户工作区步骤

前置准备 #

• 本地安装的Tricentis Tosca Commander版本必须和目标工作区版本完全一致，跨小版本都可能出现连接失败、数据兼容问题，提前和工作区创建人确认版本号
• 提前从工作区管理员处获取完整的MS SQL连接信息：SQL Server服务地址、实例名（若有）、工作区对应的数据库名、具备读写权限的认证凭据（SQL账号密码/已授权的域账号）、数据库服务端口（默认1433，若自定义需单独获取）
• 确认本地持有的Tosca许可证包含多用户工作区访问权限，单用户许可证无法接入多用户类型工作区
• 确认本地网络可以正常访问SQL Server对应端口，无防火墙、安全组策略拦截

分步操作流程 #

• 启动Tricentis Tosca Commander，初始启动弹出的工作区选择窗口中点击Workspaces...按钮；如果已经进入其他工作区，点击顶部菜单栏Project -> Open Workspace即可调出工作区管理界面
• 在工作区管理窗口点击Add按钮，新增一个工作区连接配置
• 工作区类型选择Multiuser workspace on Microsoft SQL Server，不要误选单用户工作区、其他数据库类型的选项
• 按界面字段要求填写连接配置：
  • Server字段填写SQL Server地址，若带命名实例按服务地址\实例名格式填写，例如10.0.3.22\TOSCA_PROD
  • Database name字段填写管理员提供的、已存储目标工作区的数据库名称，不要自行新建数据库
  • 认证方式按实际拿到的权限选择：选SQL Server Authentication就直接填写对应的账号密码；选Windows Authentication要提前确认当前登录系统的域账号已经被授予目标数据库的对应读写权限
  • 下方Workspace name可自定义填写方便本地识别的名称，例如XX项目多用户公共工作区，本地缓存路径选择剩余空间充足的非系统盘目录即可，路径不要包含中文、空格、特殊字符
• 所有信息填写完成后点击Test connection，提示连接成功后点击OK保存配置
• 回到工作区选择列表，选中刚添加的工作区配置，点击Open即可。首次打开会自动拉取工作区元数据生成本地缓存，等待加载完成即可正常操作

首次加载时长由工作区数据量决定，从数分钟到十余分钟不等，不要中途强制结束Tosca进程，避免本地缓存损坏后续无法正常打开

常见问题排查 #

• 连接测试失败：优先排查网络连通性，可通过telnet命令测试SQL Server端口是否可达，再确认账号密码输入正确、账号未被锁定、目标数据库确实存在
• 打开时提示版本不兼容：卸载本地Tosca后安装和目标工作区完全匹配的版本，不要尝试跨版本接入多用户工作区
• 加载完成后看不到测试对象、目录：联系工作区管理员给你的账号分配对应项目节点的访问权限，多用户工作区默认按角色做细粒度权限控制，新接入账号默认无对象访问权限
• 编辑对象时提示锁冲突：多用户工作区修改对象前需要先执行Checkout操作，编辑完成后及时Checkin提交，不要长期持有对象锁阻塞其他用户操作

内容的提问来源于stack exchange，提问作者YoYo