archery-database-search

Files (4)

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

SKILL.md (first lines)

# Archery 数据库搜索

## 何时使用

- 只知道库名片段，需要模糊搜索
- 需要正则批量匹配库名
- 需要查看库所在的实例、引擎类型、实例角色（master/slave）

**前置条件：** 先运行 `archery instance refresh`（见 `archery-instance` skill）。

**不要使用本 Skill：**

- 已知完整库名、只需反查实例 → `archery-instance`（`instance find`）
- 执行 SQL → `archery-query`
- 刷新/列出实例列表 → `archery-instance`

## 推荐工作流

```bash
# 1. 确保缓存已刷新
archery instance refresh

# 2. 模糊搜索（默认 mysql + slave 从库）
archery database search devops --table

# 3. 搜索全部实例角色
archery database search devops --type all --table

# 4. 正则搜索
archery database search --pattern "^report_.*" --regex --type all

# 5. 拿到 instance + db 后查库
archery query --instance <实例> --db <库> --sql "SELECT 1" --full
```

## 命令速查

```bash
archery database search <pattern> [--table]
archery database search --pattern "<pattern>" [--regex] [--db-type mysql|tidb|all] [--type slave|master|RO|RW|all] [--instance <实例>] [--table]
```

## 过滤参数

### `--db-type`（数据库引擎）

| 值 | 说明 |
|------|------|
| `mysql` | **默认**。按 Archery 引擎类型过滤 |
| `tidb` 等 | 其他引擎类型 |
| `all` | 不过滤引擎 |

### `--type`（实例角色）

| 值 | 说明 |
|------|------|
| `slave` | **默认**。从库/slave |
| `master` / `RW` | 主库/master |
| `RO` | 同 `slave` |
| `all` | 不过滤角色 |

过滤依据 catalog 中存储的 `DbType` / `InstanceType` 字段，不从实例名推断。

## 输出

JSON 默认，每行包含：`database`、`instanceName`、`dbType`（引擎）、`instanceType`（master/slave）。

`--table` 输出四列表格。

## 约束

1. 基于本地 catalog，非实时 API
2. 默认 `mysql` + `slave` 双过滤；主库需 `--type master` 或 `--type all`
3. 与 `instance find` 区别：search 支持模糊/正则；find 仅精确库名

## 参考

- 完整参数表：[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