archery-instance

Files (4)

• SKILL.md
• commands.md · reference/
• errors.md · reference/
• mcp.md · reference/

SKILL.md (first lines)

# Archery 实例与库缓存

## 何时使用

- 首次查库前刷新实例/库映射
- 列出有哪些实例、某实例下有哪些库、某库下有哪些表
- 已知**完整库名**，精确反查实例

**查看表结构（列名/类型）→ `archery-table-schema` skill**

**库名不完整或需模糊/正则搜索 → `archery-database-search` skill**

**不要使用本 Skill：**

- 模糊/正则搜库 → `archery-database-search`
- 查看表结构 → `archery-table-schema`
- 执行 SQL → `archery-query`
- 提交 DDL/DML 工单 → `archery-workflow`

## 推荐工作流

```bash
# 1. 配置白名单（可选）
archery config set --instance-include "RZ_BJ_OPS_ADMIN,OL_SET_PMS_RO"

# 2. 刷新缓存（TTL 7 天）
archery instance refresh

# 3. 查看实例/库
archery instance ls --table
archery instance databases OL_SET_PMS_RO --table

# 4. 精确反查（完整库名）
archery instance find --db devops_center

# 5. 列出库下所有表（实时 API，实例可省略）
archery instance tables --db devops_center --table

# 6. 查看表结构 → archery-table-schema skill
# archery instance table-schema --db devops_center --table users

# 7. 库名片段未知时 → archery-database-search（默认 mysql + slave 从库）
archery database search devops --table
archery database search devops --type all --table
```

## 命令速查

```bash
archery instance refresh [--force]
archery instance ls [--db-type mysql] [--table]
archery instance databases <实例> [--table]
archery instance tables [<实例>] --db <库> [--schema <s>] [--table]
archery instance find --db <完整库名> [--table]
archery group ls
archery group instances <资源组>
```

## 约束

1. 缓存 TTL 默认 7 天，`instance refresh --force` 强制重建
2. 白名单非空时仅缓存/拉取指定实例
3. `instance tables` / `instance table-schema` / `archery query` 可省略实例（库名在缓存中唯一匹配时；多实例匹配时需显式指定）

## 参考

- 完整参数表：[reference/commands.md](reference/commands.md)
- MCP 工具：[reference/mcp.md](reference/mcp.md)
- 常见错误：[reference/errors.md](reference/errors.md)

From xqdgithub/archery-cli, MIT.

More from xqdgithub/archery-cli