如何将DBeaver连接至CockroachDB Serverless并解决连接报错？

报错信息：FATAL: codeParamsRoutingFailed: missing cluster name in connection string

该报错由CockroachDB Serverless的多租户路由规则触发，必须在连接参数中指定集群唯一标识才能正常访问实例，可按照以下步骤修复：

• 第一步：获取集群完整标识
  登录CockroachDB Cloud控制台进入对应集群的详情页，复制集群标识，格式为<自定义集群名>-<随机串>.<部署区域>，例如light-mammoth-4567.us-west-2
• 第二步：修改DBeaver连接配置
  你可以任选以下一种方式修改：
  1. 编辑JDBC连接串：在「常规」标签页的JDBC URL末尾追加参数?options=--cluster%3D<你的集群完整标识>，%3D为等号的URL编码，示例修改后的完整串：
     jdbc:postgresql://free-tier.gcp-us-central1.cockroachlabs.cloud:26257/defaultdb?options=--cluster%3Dlight-mammoth-4567.gcp-us-central1
  2. 配置驱动属性：切换到「驱动属性」标签页，找到options参数，填入值--cluster=<你的集群完整标识>即可；若你使用的是新版DBeaver内置的CockroachDB专用驱动，可直接找到ClusterName参数填入集群标识，无需手动拼接参数
• 第三步：校验必填配置
  确认连接配置中端口为默认26257，已勾选SSL连接选项，用户名、密码与CockroachDB Cloud控制台创建的SQL用户信息一致

配置完成后点击测试连接即可正常连通。

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