天翼云 DMS 数据管理服务 (客户端)

本 Skill 提供 DMS（数据管理服务）客户端的自动化操作能力，支持通过 API 调用或 CLI 工具实现实例管理、数据查询、工单创建、团队配置等功能。

功能概述

本 Skill 支持以下 4 个核心功能场景：

1. 自动实例管理 - 数据库实例的添加、删除、修改
2. 数据查询 - SQL 执行和数据探索分析
3. 自然语言提工单 - 工单创建和查询
4. 自动团队配置管理 - 团队创建、用户邀请、实例分配

⚠️ 避坑指南（必读）

1. 实例登录方式

实例登录支持两种方式：

方式一：使用 dbAccountId 登录（推荐）

通过 account-list 命令获取数据库账号 ID，然后使用账号 ID 登录，无需密码。

步骤：

# 1. 查询实例账户列表
java -jar dms-cli.jar instance account-list --id <实例ID> --origin <origin值>

# 2. 使用 dbAccountId 登录
java -jar dms-cli.jar instance login \
    --id <实例ID> \
    --db-account-id <账号ID> \
    --origin <origin值>

方式二：使用账密登录

使用数据库账号和密码登录，需要用户手动提供真实密码，不支持任何默认密码。

命令：

java -jar dms-cli.jar instance login \
    --id <实例ID> \
    --db-account <数据库账号> \
    --password <数据库密码> \
    --origin <origin值>

⚠️ 注意：

• 参数名是 --password，不是 --db-password
• 密码会被自动 AES 加密传输
• 禁止提供默认密码或自动尝试密码

2. origin 参数必须显式指定

错误写法（可能失败）：

java -jar dms-cli.jar instance login --id 10413 --db-account root --password "密码"
# origin 使用默认值 5，但实例实际可能是 2

正确写法：

# 先查询实例详情确认 origin 值
java -jar dms-cli.jar instance detail --id 10413
# 查看返回数据中的 "origin" 字段

# 登录时显式指定正确的 origin
java -jar dms-cli.jar instance login --id 10413 --db-account root --password "密码" --origin 2

⚠️ origin 取值：

3. 弱管控实例也需要 Token

⚠️ 重要：即使 controlType=0（弱管控），执行 SQL 仍需要先登录获取 Token！

错误做法：

# 直接执行 SQL，不登录
java -jar dms-cli.jar sql execute --instance-id 10413 --sql "SHOW DATABASES"
# 会报错："查询弱管控实例Token不能为空"

正确流程：

# 1. 先登录获取 Token
java -jar dms-cli.jar instance login --id 10413 --db-account root --password "密码" --origin 2
# 返回: {"code":200,"data":"26d4540fe7e01ff1",...}  -- Token 在 data 字段

# 2. 使用 Token 执行 SQL
java -jar dms-cli.jar sql execute \
    --instance-id 10413 \
    --sql "SHOW DATABASES" \
    --instance-token "26d4540fe7e01ff1" \
    --origin 2

4. database list API 可能返回空

问题： database list 命令返回空数组，但实例确实有数据库。

原因： 该 API 对某些实例可能不返回数据。

解决方案： 使用 SQL 直接查询

# 先登录获取 Token
java -jar dms-cli.jar instance login --id 10413 --db-account root --password "密码" --origin 2

# 用 SQL 查询数据库列表
java -jar dms-cli.jar sql execute \
    --instance-id 10413 \
    --sql "SHOW DATABASES" \
    --instance-token "Token值" \
    --origin 2

5. account-list 可能返回空

问题： account-list 命令返回空数组，但实例详情显示有 dbAccount: "root"。

解决方案： 直接使用实例详情中的 dbAccount 值登录

# 查询实例详情
java -jar dms-cli.jar instance detail --id 10413
# 找到 "dbAccount": "root"

# 直接使用该账号登录
java -jar dms-cli.jar instance login --id 10413 --db-account root --password "密码" --origin 2

6.