返回技能市场
开发运维 安全

阿里云 Lindorm 云原生多模数据库助手

@aliyun/alibabacloud-lindorm-agent-skill

阿里云 Lindorm 数据库助手。支持实例查询管理、监控数据分析、性能诊断、存储分析、连接问题排查、代码编写（连接代码、建表语句、SQL 开发等）。覆盖包括Lindorm SQL、宽表引擎、时序引擎、搜索引擎、HBase兼容等多模场景。

云Skills门户 热度 32v0.0.2

Lindorm Agent Skill

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

核心能力矩阵

| 类别 | Sub-Scenarios | 参考文档 | |---------|--------------|----------------| | 01-开发指南 | 连接配置、快速入门、SQL 指南、表设计、搜索引擎使用、向量检索、AI 引擎调用、多模态检索、知识库检索 | references/01-dev/ | | 02-运维管理 | 实例管理、监控、错误排查、存储分析、连接诊断、备份与恢复、迁移、权限、慢查询 | references/02-ops/ | | 03-Reference | Lindorm CLI 使用指南、HBase Shell 指南、阿里云 CLI 命令、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
│   ├── 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 management → references/02-ops/instance-management.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-management.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
    ├── Lindorm CLI (install / execute SQL / preview data / test connection) → references/03-ref/lindorm-cli-guide.md
    ├── HBase Shell (alihbase) → references/03-ref/hbase-shell-guide.md
    ├── Aliyun CLI command list (`aliyun hitsdb ...`) → references/03-ref/related-commands.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

快速映射表

| 用户表述 | 场景 | 参考文档 | |-----------|----------|---------------| | "how to connect / connection address" | 连接配置 | references/01-dev/connection-guide.md | | "create table / insert / query examples" | 快速入门 | references/01-dev/quick-start-guide.md | | "如何创建表" | 表设计 | references/01-dev/table-design.md | | "DBA / ops debugging via SQL" | 通过 CLI 进行 SQL 运维 → SQL 语法 | references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md | | "develop SQL app / code connection" | 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 | | "search engine usage / ES API / 30070" | 搜索引擎独立使用 | references/01-dev/search-guide.md | | "vector engine / KNN / RRF / IVFPQ / IVFBQ" | 通过搜索引擎或宽表引擎进行向量检索 | references/01-dev/vector-guide.md | | "AI engine / embedding / VL / rerank / 9002" | Lindorm AI 引擎模型调用 | references/01-dev/ai-guide.md | | "multimodal retrieval / image-text search / image-to-image / text-to-image" | 多模态图文检索场景 | references/01-dev/multimodal-search-scene.md | | "knowledge base retrieval / private QA / document chunking" | 知识库检索和 QA 场景 | references/01-dev/knowledge-search-scene.md | | "list instances / what instances exist" | 实例管理 | references/02-ops/instance-management.md | | "CPU / memory / QPS / latency" | 监控查询 | references/02-ops/monitoring-guide.md | | "configure alerts / alert notifications" | 监控告警 | references/02-ops/monitoring-guide.md | | "got an error / error code" | 错误排查 | references/02-ops/error-troubleshoot.md | | "slow query / query is slow" | 慢查询分析 | references/02-ops/slow-query-analysis.md | | "poor performance / high RT" | 监控查询 | references/02-ops/monitoring-guide.md | | "cannot connect / connection timeout" | 连接诊断 | references/02-ops/connection-troubleshoot.md | | "存储用量" | 存储分析 | references/02-ops/storage-analysis.md | | "hot/cold data / tiered storage" | 存储分析 | references/02-ops/storage-analysis.md | | "scale up / add nodes" | 扩缩容 | references/02-ops/instance-management.md | | "backup / restore data" | 备份与恢复 | references/02-ops/backup-restore.md | | "data migration / sync" | 数据迁移 | references/02-ops/data-migration.md | | "create account / permissions" | 权限管理 | references/02-ops/user-permission.md | | "lindorm-cli / lindormcli" | Lindorm CLI | references/03-ref/lindorm-cli-guide.md | | "execute SQL / run query" | 通过 CLI 执行 SQL | references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md | | "SHOW TABLES / DESCRIBE / view table schema / list tables" | 通过 CLI 探查表结构 | references/03-ref/lindorm-cli-guide.md | | "preview data / check data / query data" | 通过 CLI 预览数据 | references/03-ref/lindorm-cli-guide.md | | "test connection / verify connection" | 通过 CLI 进行连接探测 | references/03-ref/lindorm-cli-guide.md | | "HBase Shell / hbase shell " | HBase Shell | references/03-ref/hbase-shell-guide.md |

阿里云 CLI

前置条件

需要调用 CLI 时，Agent 必须验证：

  1. 已安装 CLI：aliyun version >= 3.3.3；如果未安装，请参阅 references/03-ref/cli-installation-guide.md
  2. 插件已更新至最新版本：

    3. ``bash aliyun configure set --auto-plugin-install true aliyun plugin update ``

  3. 已配置凭证：

    4. > 安全规则： > - 不得读取、回显或打印 AK/SK 的值 > - 不得要求用户在对话或命令行中直接输入 AK/SK > - 只能使用 aliyun configure list 检查凭证状态 > > 如果不存在有效的配置文件，请停止。请在此会话之外配置凭证。

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

    5. > [必须] 权限失败处理：在执行过程中的任何阶段，如果任何命令或 API 调用因权限错误而失败，必须遵循以下流程： > 1. 读取 references/03-ref/ram-policies.md，获取此 SKILL 所需的完整权限列表 > 2. 如果 ram-permission-diagnose skill 可用，请使用该 skill 指导用户完成权限申请。否则，直接输出所需的 RAM 策略/操作列表、错误码，以及指导用户通过 RAM 控制台向其管理员申请权限的分步说明 > 3. 暂停并等待，直至用户确认已授予所需权限

可观测性（每条 aliyun 命令都必须遵循）

加载此 skill 后，为整个会话生成一次随机会话 ID（由 32 个小写十六进制字符组成）。下文将其用作 {session-id}。
规则：每条调用云 API 的 aliyun CLI 命令都必须包含 --user-agent 标志。
本地实用命令（例如 configure、plugin、version）不支持此标志，应排除在此规则之外。
```
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/{session-id}
```
示例（假设 session-id 为 a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6）：
```bash
aliyun hitsdb get-lindorm-instance --instance-id ld-xxx \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6
```
调用任何 aliyun API 命令时，不得跳过 --user-agent、更改其格式或将其省略。

参数确认

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

版本检测

对于实例操作，Agent 必须先调用 get-lindorm-instance 获取 ServiceType，并确定实例版本。后续所有命令的选择均取决于此：

| ServiceType | 版本 | 部署模式 | |------------|---------|-----------| | lindorm | V1 | 单 AZ | | lindorm_multizone | V1 | 多 AZ（HA） | | lindorm_multizone_basic | V1 | 多 AZ（基础版） | | lindorm_v2 | V2 | 单 AZ | | lindorm_v2_multizone | V2 | 多 AZ（基础版） | | lindorm_v2_multizone_ha | V2 | 多 AZ（HA） |

通用策略

地域策略

| 场景 | 命令 | 是否需要 --region | |---------|---------|---------------------| | 查询所有地域概览 | get-instance-summary | ❌ 不需要 | | 查询实例列表 | get-lindorm-instance-list | ✅ 必须提供，默认值为 cn-shanghai | | 查询实例详情 / 引擎 / 存储 / 白名单 | 其他 hitsdb 命令 | ❌ 不需要，可通过 --instance-id 自动解析 | | 云监控查询 | cms 命令 | ❌ 不需要，通过 instanceId 自动解析地域 |

时间格式

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

  • ✅ 2026-04-14 08:00:00（本地时间，按北京时间（CST）解析）
  • ✅ 1773897600000（Unix 毫秒时间戳，不存在时区歧义）
  • ✅ 2026-04-14T08:00:00Z（ISO 8601 UTC 完整格式，按 UTC 解析，即 CST+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 格式查询的时间窗口不同——这是时区相关问题的常见根源

命令参考

实例管理（hitsdb——Lindorm 的产品别名）

| 命令 | 说明 | 示例 | |---------|-------------|---------| | aliyun hitsdb describe-regions | 列出支持的地域 | aliyun hitsdb describe-regions | | aliyun hitsdb get-instance-summary | 所有地域的实例概览（无需 --region） | aliyun hitsdb get-instance-summary | | aliyun hitsdb get-lindorm-instance-list | 列出实例（ID、状态、引擎标志；可按地域/类型筛选） | aliyun hitsdb get-lindorm-instance-list --region cn-shanghai | | aliyun hitsdb get-lindorm-instance | 获取 config/version/status（ServiceType、引擎节点数、规格；不含连接地址） | aliyun hitsdb get-lindorm-instance --instance-id ld-xxx | | aliyun hitsdb get-lindorm-instance-engine-list | 获取连接地址（每个引擎对应的 host:port，包括公网/私网） | aliyun hitsdb get-lindorm-instance-engine-list --instance-id ld-xxx | | aliyun hitsdb get-lindorm-fs-used-detail | V1 存储使用详情 | aliyun hitsdb get-lindorm-fs-used-detail --instance-id ld-xxx | | aliyun hitsdb get-lindorm-v2-storage-usage | V2 存储使用详情 | aliyun hitsdb get-lindorm-v2-storage-usage --instance-id ld-xxx | | aliyun hitsdb get-instance-ip-white-list | 获取 IP 白名单 | aliyun hitsdb get-instance-ip-white-list --instance-id ld-xxx |

引擎类型

| 引擎 | V1 代码 | V2 代码 | 说明 | |--------|---------|---------|-------| | LindormTable | lindorm | lindorm | 兼容 HBase，支持 SQL（推荐） | | LindormTable（列式） | — | lcolumn | 仅限 V2 | | LindormTSDB | tsdb | tsdb | 时序数据存储 | | LindormSearch | solr | lsearch | 端口 30070（兼容 ES）；solr 是旧版 API 代码名称。Solr API（端口 10020）已弃用/下线 | | Lindorm 隧道服务 | bds | bds | 原称 BDS，不提供外部连接 | | 计算引擎 | compute | compute | Flink 流式引擎，无外部连接 | | 流引擎 | stream | lstream | 端口 33060（MySQL 协议） | | 消息引擎 | — | lmessage | 兼容 Kafka，支持主题管理以及消息生产/消费 | | 向量引擎 | — | lvector | 仅限 V2；内置向量检索引擎，可通过搜索引擎 30070 或宽表 + 搜索引擎访问 | | AI 引擎 | — | lai | 仅限 V2；AI 推理引擎（embedding / VL / rerank / chat）；端口 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 协议 | | 流引擎 | MySQL 协议 | 33060 | 通过 MySQL 协议使用流式 SQL | | LindormTSDB | HTTP SQL | 8242 | HTTP SQL API | | LindormSearch | 兼容 ES | 30070 | 兼容 Elasticsearch 的端口，固定不变。Solr API（端口 10020）已弃用/下线 | | 向量引擎 | 内置服务 | — | 仅限 V2；无直接端点；使用搜索引擎 30070 或宽表 + 搜索引擎 | | AI 引擎 | 兼容 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 | | Latency / RT | read_rt / get_rt_avg | read_rt / get_rt_avg | 毫秒 | | P99 延迟 | get_rt_p99 / put_rt_p99 | —（无数据） | 毫秒 | | 热存储使用率 | hot_storage_used_percent | get-lindorm-v2-storage-usage | % | | 总存储使用率 | storage_used_percent | get-lindorm-v2-storage-usage | % | | 热存储字节数 | hot_storage_used_bytes | get-lindorm-v2-storage-usage | 字节 | | 冷存储使用率 | cold_storage_used_percent | get-lindorm-v2-storage-usage | % | | 冷存储字节数 | cold_storage_used_bytes | get-lindorm-v2-storage-usage | 字节 |

完整指标详情：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. 优先参考 Skill 文档：Lindorm 属于特定领域知识——信息必须来自参考文档；禁止直接根据训练知识作答
  2. 当 Skill 未涵盖相关内容时查阅官方文档：对于参考文档未涵盖的场景，请查阅阿里云官方文档

生成前检查清单

  • □ 连接参数名称正确（MySQL 协议：jdbc:mysql://host:33060，HBase API：hbase.zookeeper.quorum）
  • □ 端口号正确（LindormTable/流引擎 MySQL 33060，HBase API 30020，LindormTSDB HTTP 8242，LindormSearch 30070）
  • □ 包含官方文档链接
qianwen skills install @aliyun/alibabacloud-lindorm-agent-skill