alibabacloud-lindorm-agent-skill

Lindorm Agent Skill

阿里云 Lindorm 云原生多模数据库 Skill。涵盖三个领域：运维管理、开发指南和参考资料。开发指南包括经典 SQL／搜索用法，以及向量检索、Lindorm AI 引擎调用、多模态图文搜索和私有知识库搜索。

核心能力矩阵

类别	子场景	参考文档
01-开发指南	连接设置、快速入门、SQL 指南、表设计、搜索引擎用法、向量检索、图引擎用法、AI 引擎调用、多模态搜索、知识搜索	references/01-dev/
02-运维管理	实例管理、实例生命周期（创建／扩容／释放／付费类型）、监控、错误排查、存储分析、连接诊断、网络访问控制、备份与恢复、迁移、权限、慢查询	references/02-ops/
03-参考资料	阿里云 CLI 命令参考、Lindorm CLI（SQL 客户端）指南、HBase Shell 指南、RAM 权限、验收标准	references/03-ref/

决策树

User Request
├── Connection / DDL / SQL / Code examples → 01-dev
│   ├── Connection address / code → references/01-dev/connection-guide.md
│   ├── DDL / write / query examples → references/01-dev/quick-start-guide.md
│   ├── SQL connection & SQL-based application development → references/01-dev/sql-client-guide.md
│   ├── SQL syntax reference → references/01-dev/sql-operations.md
│   ├── MySQL compatibility → references/01-dev/sql-usage-notes.md
│   ├── Table design guide → references/01-dev/table-design.md
│   ├── Search engine standalone usage → references/01-dev/search-guide.md
│   ├── Vector engine usage through Search / Wide Table → references/01-dev/vector-guide.md
│   ├── Graph engine usage (Gremlin / Schema / query) → references/01-dev/graph-guide.md
│   ├── Lindorm AI engine model calls → references/01-dev/ai-guide.md
│   ├── Multimodal image-text search scene → references/01-dev/multimodal-search-scene.md
│   └── Knowledge base search / private QA scene → references/01-dev/knowledge-search-scene.md
│
├── Instance / Monitoring / Errors / Performance / Storage / Connection / Scaling / Backup / Migration / Permissions / Slow query → 02-ops
│   ├── Instance query (list / details / engines / storage) → references/02-ops/instance-management.md
│   ├── Instance write ops (create / scale / release / pay-type) → references/02-ops/instance-lifecycle.md
│   ├── IP whitelist / ECS security group → references/02-ops/network-access-control.md
│   ├── Monitoring / Alerts → references/02-ops/monitoring-guide.md
│   ├── Error codes → references/02-ops/error-troubleshoot.md
│   ├── Storage analysis → references/02-ops/storage-analysis.md
│   ├── Connection diagnostics → references/02-ops/connection-troubleshoot.md
│   ├── Scale up/down → references/02-ops/instance-lifecycle.md
│   ├── Backup & restore → references/02-ops/backup-restore.md
│   ├── Data migration → references/02-ops/data-migration.md
│   ├── Account & permissions → references/02-ops/user-permission.md
│   └── Slow query analysis → references/02-ops/slow-query-analysis.md
│
└── Command list / Permission reference / CLI tools / SQL execution → 03-ref
    ├── Aliyun CLI command list + region rule + return structures (`aliyun lindorm ...`) → references/03-ref/related-commands.md
    ├── Lindorm CLI — SQL client, executes SQL (`lindorm-cli`) → references/03-ref/lindorm-cli-guide.md
    ├── HBase Shell (alihbase) → references/03-ref/hbase-shell-guide.md
    ├── RAM permission list → references/03-ref/ram-policies.md
    ├── Aliyun CLI setup → references/03-ref/cli-installation-guide.md
    ├── Acceptance criteria → references/03-ref/acceptance-criteria.md
    └── Verification methods → references/03-ref/verification-method.md

快速映射表

用户说	场景	参考文档
"如何连接 / 连接地址"	连接设置	references/01-dev/connection-guide.md
"创建表 / 插入 / 查询示例"	快速入门	references/01-dev/quick-start-guide.md
"如何创建表"	表设计	references/01-dev/table-design.md
"通过 SQL 进行 DBA / 运维调试"	通过 CLI 进行 SQL 运维 → SQL 语法	references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md
"开发 SQL 应用 / 代码连接"	SQL 客户端开发 → SQL 语法	references/01-dev/sql-client-guide.md → references/01-dev/sql-operations.md
"SQL 语法"	SQL 参考	references/01-dev/sql-operations.md
"如何使用 SQL"	SQL 指南	references/01-dev/sql-client-guide.md
"MySQL 兼容性"	SQL 说明	references/01-dev/sql-usage-notes.md
"搜索引擎用法 / ES API / 30070"	搜索引擎独立用法	references/01-dev/search-guide.md
"向量引擎 / KNN / RRF / IVFPQ / IVFBQ"	通过搜索引擎或宽表进行向量检索	references/01-dev/vector-guide.md
"AI 引擎 / embedding / VL / rerank / 9002"	Lindorm AI 引擎模型调用	references/01-dev/ai-guide.md
"多模态检索 / 图文搜索 / 以图搜图 / 以文搜图"	多模态图文搜索场景	references/01-dev/multimodal-search-scene.md
"知识库检索 / 私有问答 / 文档分块"	知识库检索与问答场景	references/01-dev/knowledge-search-scene.md
"图引擎 / Gremlin / 图查询 / 图 Schema / hasVector"	通过 Gremlin 使用图引擎	references/01-dev/graph-guide.md
"列出实例 / 有哪些实例"	实例查询	references/02-ops/instance-management.md
"创建实例 / 开通 Lindorm"	实例创建	references/02-ops/instance-lifecycle.md
"扩容 / 调整规格 / 添加节点 / 启用引擎"	实例扩缩容	references/02-ops/instance-lifecycle.md
"释放 / 删除 / 退订实例"	实例释放	references/02-ops/instance-lifecycle.md
"切换计费方式 / 转为包年包月"	付费类型转换	references/02-ops/instance-lifecycle.md
"白名单 / 添加 IP / 安全组"	网络访问控制	references/02-ops/network-access-control.md
"CPU / 内存 / QPS / 延迟"	监控查询	references/02-ops/monitoring-guide.md
"配置告警 / 告警通知"	监控告警	references/02-ops/monitoring-guide.md
"遇到错误 / 错误码"	错误排查	references/02-ops/error-troubleshoot.md
"慢查询 / 查询很慢"	慢查询分析	references/02-ops/slow-query-analysis.md
"性能不佳 / RT 高"	监控查询	references/02-ops/monitoring-guide.md
"无法连接 / 连接超时"	连接诊断	references/02-ops/connection-troubleshoot.md
"存储用量"	存储分析	references/02-ops/storage-analysis.md
"冷热数据 / 分层存储"	存储分析	references/02-ops/storage-analysis.md
"扩容 / 添加节点"	扩缩容	references/02-ops/instance-lifecycle.md
"备份 / 恢复数据"	备份与恢复	references/02-ops/backup-restore.md
"数据迁移 / 同步"	数据迁移	references/02-ops/data-migration.md
"创建账号 / 权限"	权限管理	references/02-ops/user-permission.md
"lindorm-cli / lindormcli"	Lindorm CLI（SQL 客户端）	references/03-ref/lindorm-cli-guide.md
"aliyun lindorm / 管理 CLI / 实例生命周期 CLI"	Aliyun CLI 命令参考	references/03-ref/related-commands.md
"执行 SQL / 运行查询"	通过 CLI 执行 SQL	references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md
"SHOW TABLES / DESCRIBE / 查看表 Schema / 列出表"	通过 CLI 探索 Schema	references/03-ref/lindorm-cli-guide.md
"预览数据 / 检查数据 / 查询数据"	通过 CLI 预览数据	references/03-ref/lindorm-cli-guide.md
"测试连接 / 验证连接"	通过 CLI 探测连接	references/03-ref/lindorm-cli-guide.md
"HBase Shell / hbase shell "	HBase Shell	references/03-ref/hbase-shell-guide.md

Aliyun CLI

前置条件

需要调用 CLI 时，Agent 必须确认：

1. 已安装 CLI：aliyun version >= 3.4.1 — aliyun lindorm 子命令仅在 3.4.1 及更高版本中可用。使用旧版 CLI 时，每次调用 aliyun lindorm ... 都会因命令未知而失败，因此在认定命令有问题前，请先检查版本。如果未安装 CLI 或版本过旧，请参阅 references/03-ref/cli-installation-guide.md。lindorm 插件由下方的 AI-Mode 步骤自动安装（aliyun configure set --auto-plugin-install true + aliyun plugin update）；请使用 aliyun lindorm --version 确认。
2. 已配置凭证：

   安全规则：

   • 绝不读取、回显或打印 AK/SK 值
   • 绝不要求用户在对话或命令行中直接输入 AK/SK
   • 仅使用 aliyun configure list 检查凭证状态

   如果不存在有效配置文件，立即停止。在本次会话之外配置凭证。

3. 已授予权限：最低要求为 AliyunLindormReadOnlyAccess + AliyunCloudMonitorReadOnlyAccess

   [MUST] 权限错误处理： 执行过程中，任何命令或 API 调用因权限错误而失败时，都必须遵循以下流程：

   1. 阅读 references/03-ref/ram-policies.md，获取此 SKILL 所需权限的完整列表
   2. 如果有可用的 ram-permission-diagnose 技能，请使用它指导用户申请权限。否则，直接输出所需的 RAM 策略/操作列表和错误代码，并逐步说明如何通过 RAM Console 向管理员申请权限
   3. 暂停并等待用户确认所需权限已获授

可观测性（每次执行 aliyun 命令都必须遵守）

加载此技能时，为整个会话生成一个新的随机会话 ID（32 位小写十六进制字符串），并将其用作下方的 {session-id}。每个会话都必须重新生成会话 ID：不得重用下方的示例值或之前会话中的任何会话 ID。 从 references/manifest.json 的 version 字段读取技能版本，并将其用作下方的 {skill-version}。

规则：每条调用云 API 的 aliyun CLI 命令都必须包含 --user-agent 标志。 本地实用程序命令（例如 configure、plugin、version）不支持此标志，因此应排除。

--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/{session-id} skill-version/{skill-version}"

示例（假设 session-id 为 a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6，skill-version 为 0.0.3）：

aliyun lindorm v1 instance describe ld-xxx --lindorm-region cn-shanghai \
  --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 skill-version/0.0.3"

执行任何 aliyun API 命令时，不得跳过、修改格式或省略 --user-agent。

参数确认

执行任何命令前，必须先与用户确认所有可由用户配置的参数（区域、实例 ID、时间范围等）。

版本检测

对于实例操作，Agent 必须先确定实例架构，因为 V1 和 V2 使用不同的子命令。优先使用 aliyun lindorm instance list：它会返回区域中的所有实例，并包含 arch（v1 / v2）和 service_type 列，因此一次调用即可确定架构，无需猜测：

aliyun lindorm instance list --lindorm-region cn-shanghai --output json

对于单个已知实例，aliyun lindorm v1 instance describe <id> 也会返回两种架构的 service_type——底层的 GetLindormInstance 操作是共用的，尽管命令路径中包含 v1。

service_type 与架构的对应关系如下：

service_type	版本	部署方式
lindorm	V1	单可用区
lindorm_multizone	V1	多可用区（高可用）
lindorm_multizone_basic	V1	多可用区（基础版）
lindorm_v2	V2	单可用区
lindorm_v2_multizone	V2	多可用区（基础版）
lindorm_v2_multizone_ha	V2	多可用区（高可用）

通用策略

地域策略

场景	命令	是否需要地域
列出支持的地域	aliyun lindorm regions list	❌ 与地域无关；未配置时会回退到默认端点
查询所有地域概览	aliyun lindorm summary	❌ 与地域无关；涵盖所有地域的 V1 + V2
查询实例列表	aliyun lindorm instance list	✅ --lindorm-region，默认值为 cn-shanghai
查询实例详情 / 引擎 / 存储 / 白名单	aliyun lindorm v1|v2 instance ...	✅ --lindorm-region——根据地域解析端点，而不是根据实例 ID 解析
云监控查询	cms 命令	❌ 不需要，会通过 instanceId 自动解析地域

⚠️ [MUST] 在 aliyun lindorm 下，必须使用 --lindorm-region 传入地域，绝不要使用 --region。 --region 是父级 aliyun CLI 的全局标志，在插件收到它之前就会被消耗。命令仍会成功，但查询的是配置文件中的地域，而不是你指定的地域——这是一个会返回错误结果的陷阱，而非报错。插件确实会向 stderr 输出警告，Agent 不得忽略：

note: using region cn-shenzhen (from profile/environment). '--region' is consumed by the aliyun CLI
and never reaches this plugin — use '--lindorm-region <region>' to override.

--profile 也存在同样的情况，其插件侧对应标志为 --lindorm-profile。摘自 aliyun lindorm --help：

--lindorm-region string    Same as --region; use this under 'aliyun lindorm', where --region is consumed by the aliyun CLI
--lindorm-profile string   Same as --profile; use this under 'aliyun lindorm', where --profile is consumed by the aliyun CLI

未提供 --lindorm-region 时，地域取自当前启用的配置文件。始终显式传入 --lindorm-region，并在告知用户结果对应哪个地域前，先核实输出中的 region_id。

例外：profile create --region <region> 是该子命令的命令级标志，按原样使用即可。

如果用户报告地域范围查询悄然返回了其他地域的数据（没有报错，region_id 错误），应将其诊断为此标志陷阱——绝不要将其归因于 RAM / 权限（Forbidden）问题。说明根本原因（父级 CLI 会消耗 --region）以及解决方法（使用 --lindorm-region）。

⚠️ summary 会低报数量——不要将其用作资源清单。 已观察到它返回的 total 前后一致，但各地域的数量偏低或完全缺失（例如某地域报告有 9 个实例，而该地域的 instance list --lindorm-region 返回 11 个）。仅将其用作快速概览；如需准确计数，请先使用 regions list，再针对每个地域运行 instance list --lindorm-region <region>。

时间格式

云监控时间参数的时区说明：

• ✅ 2026-04-14 08:00:00（本地时间，按中国标准时间解析）
• ✅ 1773897600000（Unix 毫秒时间戳，无时区歧义）
• ✅ 2026-04-14T08:00:00Z（ISO 8601 UTC 完整格式，按 UTC 解析，即中国标准时间 + 8 小时 = 16:00）
• ❌ 2026-04-14T08:00Z（ISO 8601 简写格式，不含秒——不受支持，会返回 parse param time error）
• ❌ 用户意图为本地时间时，绝不要使用 UTC Z 格式（例如，用户说“14:00”时，写成 2026-04-14 14:00:00，不要写成 2026-04-14T14:00:00Z）
• ⚠️ 注意：本地时间和 ISO 8601 Z 格式查询的时间范围不同——这是与时区相关问题的常见来源

命令参考

查询（只读，不影响账单）

命令	描述	示例
aliyun lindorm regions list	列出支持的地域（DescribeRegions）；不受地域限制	aliyun lindorm regions list --output json
aliyun lindorm summary	所有地域、所有架构的实例数量（GetInstanceSummary）；不受地域限制	aliyun lindorm summary --output json
aliyun lindorm instance list	列出目标地域中的所有实例，混合 V1 和 V2（GetLindormInstanceList）；arch / service_type 列用于标识架构	aliyun lindorm instance list --lindorm-region cn-shanghai --output json
aliyun lindorm v1 instance describe	V1 配置／版本／状态（GetLindormInstance）；不包含连接地址	aliyun lindorm v1 instance describe ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v2 instance describe	V2 详情，包括引擎拓扑和 connect_address_list（GetLindormV2InstanceDetails）	aliyun lindorm v2 instance describe ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v1 instance engine-list	各引擎的连接地址（GetLindormInstanceEngineList）；获取 V1 连接地址的唯一方式	aliyun lindorm v1 instance engine-list ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v2 instance engine-list	同一端点，V2 子树	aliyun lindorm v2 instance engine-list ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v1 instance storage	V1 存储用量：热／冷存储、按引擎和磁盘类型划分（GetLindormFsUsedDetail）	aliyun lindorm v1 instance storage ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v2 instance storage	按磁盘类别统计的 V2 存储用量（GetLindormV2StorageUsage）	aliyun lindorm v2 instance storage ld-xxx --lindorm-region cn-beijing --output json
aliyun lindorm v1 instance whitelist get	获取 IP 白名单（GetInstanceIpWhiteList，V1/V2 共用）	aliyun lindorm v1 instance whitelist get ld-xxx --lindorm-region cn-beijing
aliyun lindorm v1 instance security-group get	获取已绑定的 ECS 安全组（GetInstanceSecurityGroups，V1/V2 共用）	aliyun lindorm v1 instance security-group get ld-xxx --lindorm-region cn-beijing
aliyun lindorm vpc list	列出该地域中的 VPC（DescribeVpcs）	aliyun lindorm vpc list --lindorm-region cn-beijing --output json
aliyun lindorm vpc vswitch	列出 VSwitch，可按 VPC／可用区筛选（DescribeVSwitches）	aliyun lindorm vpc vswitch --vpc-id vpc-xxx --zone-id cn-beijing-i --lindorm-region cn-beijing --output json

变更（会产生费用／具有破坏性——除非指定 --yes，否则会要求确认）

命令	描述	示例
aliyun lindorm v2 instance create	创建 V2 实例（CreateLindormV2Instance）；支持 --dry-run	aliyun lindorm v2 instance create --lindorm-region cn-beijing --name demo --zone-id cn-beijing-i --vpc-id vpc-xxx --vswitch-id vsw-xxx --arch-version 1.0 --pay-type POSTPAY --engine TABLE:lindorm.g.2xlarge:2 --cloud-storage-type PerformanceStorage --cloud-storage-size 400 --dry-run
aliyun lindorm v1 instance create	创建 V1 实例（CreateLindormInstance）	aliyun lindorm v1 instance create --lindorm-region cn-hangzhou --name demo --zone-id cn-hangzhou-h --vpc-id vpc-xxx --vswitch-id vsw-xxx --lindorm-spec lindorm.g.2xlarge --lindorm-num 2 --instance-storage 480 --pay-type POSTPAY
aliyun lindorm v2 instance modify	扩展 V2 实例（UpdateLindormV2Instance）；每次调用只能修改一种规格类别	aliyun lindorm v2 instance modify ld-xxx --lindorm-region cn-beijing --cloud-storage-size 800 --dry-run
aliyun lindorm v1 instance modify	扩展 V1 实例（UpgradeLindormInstance）；根据提供的标志推断 UpgradeType	aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --lindorm-num 4 --cluster-storage 1280 --yes
aliyun lindorm v1 instance modify --tsdb-spec/--tsdb-num	启用或扩展时序引擎	aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --tsdb-spec lindorm.g.4xlarge --tsdb-num 2 --cluster-storage 2160 --yes
aliyun lindorm v1 instance modify --search-spec/--search-num	启用或扩展搜索引擎	aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --search-spec lindorm.g.xlarge --search-num 2 --yes
aliyun lindorm v1 instance whitelist update	替换某个分组的 IP 白名单（UpdateInstanceIpWhiteList）	aliyun lindorm v1 instance whitelist update ld-xxx --lindorm-region cn-beijing --group default --ips 10.0.0.0/8,192.168.1.1
aliyun lindorm v1 instance security-group update	替换已绑定的 ECS 安全组（UpdateInstanceSecurityGroups）	aliyun lindorm v1 instance security-group update ld-xxx --lindorm-region cn-beijing --groups sg-aaa,sg-bbb
aliyun lindorm v1 instance switch-pay-type	转换计费方式（ModifyInstancePayType，V1/V2 通用）	aliyun lindorm v1 instance switch-pay-type ld-xxx --lindorm-region cn-beijing --pay-type PREPAY --pricing-cycle Month --duration 1
aliyun lindorm v2 instance release	释放 V2 实例（ReleaseLindormV2Instance）；仅限 POSTPAY	aliyun lindorm v2 instance release ld-xxx --lindorm-region cn-beijing --yes
aliyun lindorm v1 instance release	释放 V1 实例（ReleaseLindormInstance）；仅限 POSTPAY	aliyun lindorm v1 instance release ld-xxx --lindorm-region cn-beijing --yes --immediate

aliyun lindorm instance ... 是 aliyun lindorm v2 instance ... 的别名。

⚠️ 在 aliyun lindorm 下，请使用 --lindorm-region / --lindorm-profile，切勿使用 --region / --profile——后者是 aliyun CLI 的全局标志，会被其自身解析且不会转发给插件，因此会被静默忽略（退出代码为 0，但使用了错误的区域）。 这些别名在独立二进制文件中也有效，因此两种模式可使用相同的写法。 需要插件 v0.2.20+。

每个子命令还支持以下标志：--aliyun-profile / --output table|json|yaml（-o）/ --yes / --non-interactive。

whitelist / security-group / switch-pay-type / engine-list 在 v1 instance 和 v2 instance 下的功能完全相同；storage 则因架构而异——对 V2 实例运行 v1 instance storage 会返回 HTTP 200 和空响应正文（而非错误），反之则返回 451。

创建 / 修改时的枚举值

枚举	值
EngineType（--engine）	TABLE 宽表 / TSDB 时序 / LSEARCH 搜索 / LVECTOR 向量 / LTS 流 / LCOLUMN 列存
--engine 格式	<EngineType>:<NodeSpec>:<NodeCount>[:<DiskType>:<DiskSizeGB>]，可重复指定；磁盘参数仅适用于架构 3.0 — 对于 1.0 / 2.0，建议使用实例级 --cloud-storage-*
CloudStorageType	StandardStorage 标准型 / PerformanceStorage 性能型 / CapacityStorage 容量型
ArchVersion	1.0 单可用区（--zone-id + --vswitch-id） / 2.0 多可用区基础版 / 3.0 多可用区高可用版（2.0 和 3.0 都需要 --primary-* + --standby-* + --coordinator-*）
PayType	PREPAY 订阅（需要 --duration） / POSTPAY 按量付费
PricingCycle	Month（--duration 为 1-9） / Year（--duration 为 1-3）
V1 --cluster-storage	480-1017600 GB，实例级单可用区云盘；云盘只能扩容
V1 --core-storage	每个核心节点的磁盘，仅适用于多可用区
V1 --cold-storage	800-1000000 GB
V1 节点数量	--lindorm-num 2-90 / --tsdb-num 2-24 / --search-num 2-60

引擎类型

引擎	V1 代码	V2 代码	说明
LindormTable	lindorm	lindorm	兼容 HBase，支持 SQL（推荐）
LindormTable（列式）	—	lcolumn	仅限 V2
LindormTSDB	tsdb	tsdb	时序数据存储
LindormSearch	solr	lsearch	端口 30070（兼容 ES）；solr 是旧版 API 代码名称。Solr API（端口 10020）已弃用并离线
Lindorm Tunnel Service	bds	bds	前身为 BDS，不支持外部连接
Compute Engine	compute	compute	Flink 流式引擎，不支持外部连接
Stream Engine	stream	lstream	端口 33060（MySQL 协议）
Message Engine	—	lmessage	兼容 Kafka，支持主题管理和消息生产/消费
Vector Engine	—	lvector	仅限 V2；内置向量检索引擎，通过 Search 30070 或 Wide Table + Search 访问
AI Engine	—	lai	仅限 V2；AI 推理引擎（嵌入 / VL / 重排序 / 对话）；端口 9002
LindormDFS	file	file	兼容 OSS 的存储（HDFS 协议，端口 9000）

端口速查

引擎	协议	端口	说明
LindormTable	MySQL 协议	33060	✅ 推荐，优先用于 SQL 连接
LindormTable	HBase API	30020	兼容 HBase 原生 API
LindormTable	Avatica 协议	30060	⚠️ 仅限旧版，请迁移到 MySQL 协议
LindormTable	Cassandra CQL	9042	⚠️ 仅限旧版，兼容 Cassandra 协议
Stream Engine	MySQL 协议	33060	通过 MySQL 协议使用 Stream SQL
LindormTSDB	HTTP SQL	8242	HTTP SQL API
LindormSearch	兼容 ES	30070	兼容 Elasticsearch 的固定端口。Solr API（端口 10020）已弃用并离线
Vector Engine	内置服务	—	仅限 V2；没有直接端点；请使用 Search 30070 或 Wide Table + Search
AI Engine	兼容 DashScope 的 HTTP	9002	仅限 V2；使用 x-ld-ak / x-ld-sk 请求头
LindormDFS	HDFS	9000	NameNode 端口

云监控 API（aliyun cms）

命令	描述	示例
aliyun cms describe-metric-meta-list	列出可用的监控指标	aliyun cms describe-metric-meta-list --namespace acs_lindorm
aliyun cms describe-metric-last	获取最新监控数据（返回各节点的数据；Datapoints 是需要二次解析的 JSON 字符串）	aliyun cms describe-metric-last --namespace acs_lindorm --metric-name cpu_idle --dimensions '[{"instanceId":"ld-xxx"}]'
aliyun cms describe-metric-data	获取历史趋势数据（按周期聚合，不含主机维度）	aliyun cms describe-metric-data --namespace acs_lindorm --metric-name cpu_idle --dimensions '[{"instanceId":"ld-xxx"}]' --start-time "2026-04-14 08:00:00" --end-time "2026-04-14 09:00:00" --period 60

指标映射

用户说法	V1 指标	V2 指标	单位
CPU 使用率	100 - cpu_idle	100 - cpu_idle	%
内存使用率	mem_used_percent	1 - mem_free / mem_total	%
QPS	read_ops + write_ops	read_ops + write_ops	ops/s
延迟 / RT	read_rt / get_rt_avg	read_rt / get_rt_avg	ms
P99 延迟	get_rt_p99 / put_rt_p99	—（无数据）	ms
热存储使用率	hot_storage_used_percent	v2 instance storage	%
总存储使用率	storage_used_percent	v2 instance storage	%
热存储字节数	hot_storage_used_bytes	v2 instance storage	bytes
冷存储使用率	cold_storage_used_percent	v2 instance storage	%
冷存储字节数	cold_storage_used_bytes	v2 instance storage	bytes

指标详情：references/02-ops/monitoring-guide.md

交互指南

输出格式

监控查询：

[Summary] CPU usage 25% (normal)
[Time] <YYYY-MM-DD HH:MM–HH:MM>
[Trend] Stable (variance <10%)
[Details] avg 24.5%, max 32.1%, min 18.3%

错误排查：

[Error Code] InvalidParameter.InstanceId
[Meaning] Instance ID is invalid or does not exist
[Possible Causes] 1.xxx 2.xxx 3.xxx
[Resolution Steps] 1.xxx 2.xxx 3.xxx

实例列表：

[Region] cn-shanghai  [Count] 3

| ID | Name | Status | Engines |
|----|------|--------|---------|
| ld-xxx | prod | Running | LindormTable + LindormTSDB |

回答语言和术语（必须遵守）

1. 中文提问 → 用中文回答。 用户用中文提问时，最终答案必须使用中文（不能只用英文回答），且必须至少各原样使用一次用户的标准中文术语，例如云监控（不能只写 “CloudMonitor”）、全地域（不能只写 “cross-region”）、全量替换（不能只写 “full replacement”）、白名单（不能只写 “whitelist”/“IP whitelist”）、拓扑（不能只写 “topology”）、连接地址（不能只写 “connection address”/“endpoint”）。可以提供双语说明；只用英文回答或完全省略中文术语均属于回答失败。
2. 准确写出 API 响应字段名称。 解释查询结果或差异时，注明确切的响应字段名称，例如 region_id、ServiceType、net_type。不写字段名称而只作转述，会导致无法追溯。
3. 每个控制平面 OpenAPI 操作都必须配对 CLI 形式。 在回答中提及任何 Lindorm 控制平面 OpenAPI 操作时（不限于被阻止的场景），必须同时给出对应的 aliyun lindorm CLI 命令（例如 GetLindormInstance / aliyun lindorm v1 instance describe）。此配对规则不适用于没有对应 Lindorm 控制平面 OpenAPI 操作的数据平面 SQL、HBase Shell、兼容 Elasticsearch 的 HTTP 操作或 Gremlin 操作。

执行受阻 — 始终提供完整方案

当查询无法完成时（例如，使用当前凭证看不到实例、权限被拒绝、找不到资源、监控数据为空等），不要只报告阻碍就停止。最终回答仍然必须完整提供：

1. 完整的决策路径 — 为每个分支注明确切的 OpenAPI 操作及其 CLI 命令（始终成对提供，绝不能只给 CLI 形式），而不只是说明已尝试的分支。例如：存储分析首先需要通过 GetLindormInstance（aliyun lindorm v1 instance describe）获取 ServiceType，然后调用 GetLindormV2StorageUsage（aliyun lindorm v2 instance storage）或 GetLindormFsUsedDetail（aliyun lindorm v1 instance storage）；连接诊断需要通过 GetLindormInstance 获取实例状态，通过 GetLindormInstanceEngineList（aliyun lindorm v1 instance engine-list / v2 instance engine-list）获取引擎端点，通过 GetLindormV2InstanceDetails（aliyun lindorm v2 instance describe）获取拓扑（返回 engines[] / node_groups[] / connect_address_list[]），并确定 net_type（公网还是 VPC）。
2. 用户提出的每一项需求 — 如果用户询问实例及其引擎，就必须明确涵盖引擎；如果用户要求分析峰值，就必须明确给出峰值分析结果或方法（使用用户自己的术语，例如“峰值”）。
3. 继续处理所缺少的确切信息 — 实例 ID、所属账号、地域、时间范围。
4. 用户提供缺失信息后即可运行的命令。
5. 给出实例化示例，绝不使用空占位符。 如果无法获取真实值（例如账号中没有实例），仍须展示交付内容的具体形式：列出真实列名的拓扑表，以及包含真实端口的完整连接地址格式（例如 ld-xxx-proxy-lindorm.lindorm.rds.aliyuncs.com:30020、MySQL 协议端口 33060、TSDB HTTP 端口 8242）。只写 <待查询> / <TBD> 占位符而不展示实例化格式，属于不合格回答。

只解释为何受阻的回复不合格。

代码生成规范

通用原则

1. 优先查阅 Skill 文档：Lindorm 是特定领域的知识，信息必须来自参考文档；禁止直接依据训练知识回答。
2. Skill 未涵盖时查阅官方文档：参考文档未涵盖的场景，应查阅阿里云官方文档。

生成前检查清单

• □ 连接参数名称正确（MySQL 协议：jdbc:mysql://host:33060；HBase API：hbase.zookeeper.quorum）
• □ 端口号正确（LindormTable/Stream Engine MySQL 端口 33060，HBase API 端口 30020，LindormTSDB HTTP 端口 8242，LindormSearch 端口 30070）
• □ 包含官方文档链接