AskTable 现已支持 Claude Code：让 AI 助手管理你的数据

我们做了什么

AskTable 现已支持通过 Claude Code 进行配置和管理。

你可以直接在 Claude Code 中对话，让 AI 助手帮你：

• •上传和管理数据源
• •优化元数据，提升查询准确率
• •配置权限策略
• •创建值索引和业务术语表

一句话理解：用自然语言管理 AskTable，不需要记命令、不需要打开网页。

---

什么是 AskTable Skill

Skill 是 Claude Code 的扩展机制，让 AI 助手拥有特定领域的能力。

AskTable Skill 让 Claude Code 可以：

• •调用 AskTable CLI 的所有功能
• •理解数据管理的最佳实践
• •自动优化数据源配置
• •智能建议索引和术语

就像给 Claude Code 装上了"数据管理专家"的大脑。

---

如何获取 AskTable Skill

复制以下指令，粘贴到 Claude Code 对话框：

使用 npm i -g @datamini/asktable-cli 安装工具，然后执行 asktable get-skill 获取并安装 skill

Claude Code 会自动帮你完成安装。根据安装 Skill 提示，输入相关的 API Key 就可以开始操作你的 AskTable 了。

API Key 获取地址：AskTable 控制台

---

实际案例：批量配置多数据源，一站式搞定

让我们看一个真实的企业场景。

场景：整合企业全部数据，创建统一查询入口

你的需求：

• •1 个 MySQL 数据库（生产环境的订单数据）
• •1 个 PostgreSQL 数据库（用户行为数据）
• •3 个 Excel 文件（销售报表、员工信息、产品目录）
• •需要统一查询入口
• •需要配置权限：普通员工只能看自己的数据，管理层可以看全部

传统方式：

1. •逐个打开 AskTable 网页
2. •手动创建 5 个数据源
3. •分别配置数据库连接
4. •上传 3 个 Excel 文件
5. •等待 5 次元数据同步
6. •手动优化每个数据源
7. •创建 Bot 并关联数据源
8. •配置角色和权限策略
9. •测试权限是否生效

预计耗时：1-2 小时

---

使用 Claude Code + AskTable Skill：

你：帮我配置以下数据源，并创建一个统一的查询 Bot：
    1. MySQL 数据库（订单数据）
       - Host: db.company.com
       - Database: orders
       - User: readonly
    2. PostgreSQL 数据库（用户行为）
       - Host: analytics.company.com
       - Database: user_events
    3. 三个 Excel 文件：
       - sales_2024.xlsx（销售报表）
       - employees.xlsx（员工信息）
       - products.xlsx（产品目录）

    权限要求：
    - 普通员工只能看自己的数据（通过 employee_id 过滤）
    - 管理层可以看全部数据

Claude Code：
好的，我来批量配置这些数据源。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第一步：创建数据源
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[1/5] MySQL 订单数据
$ asktable ds create --name "订单数据" --engine mysql \
  --config '{"host":"db.company.com","database":"orders","user":"readonly","password":"***"}'
✓ 数据源创建成功 (ID: ds_mysql_001)

[2/5] PostgreSQL 用户行为
$ asktable ds create --name "用户行为数据" --engine postgres \
  --config '{"host":"analytics.company.com","database":"user_events","user":"readonly","password":"***"}'
✓ 数据源创建成功 (ID: ds_pg_001)

[3/5] Excel - 销售报表
$ asktable ds create --name "销售报表" --engine excel
✓ 数据源创建成功 (ID: ds_excel_001)
$ asktable ds upload ds_excel_001 sales_2024.xlsx
✓ 文件上传完成 (3.2 MB)

[4/5] Excel - 员工信息
$ asktable ds create --name "员工信息" --engine excel
✓ 数据源创建成功 (ID: ds_excel_002)
$ asktable ds upload ds_excel_002 employees.xlsx
✓ 文件上传完成 (1.1 MB)

[5/5] Excel - 产品目录
$ asktable ds create --name "产品目录" --engine excel
✓ 数据源创建成功 (ID: ds_excel_003)
$ asktable ds upload ds_excel_003 products.xlsx
✓ 文件上传完成 (0.8 MB)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第二步：同步元数据
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

$ asktable ds meta sync ds_mysql_001 --wait
✓ MySQL 元数据同步完成 (15 张表, 127 个字段)

$ asktable ds meta sync ds_pg_001 --wait
✓ PostgreSQL 元数据同步完成 (8 张表, 64 个字段)

$ asktable ds meta sync ds_excel_001 --wait
✓ 销售报表元数据同步完成 (1 张表, 12 个字段)

$ asktable ds meta sync ds_excel_002 --wait
✓ 员工信息元数据同步完成 (1 张表, 8 个字段)

$ asktable ds meta sync ds_excel_003 --wait
✓ 产品目录元数据同步完成 (1 张表, 10 个字段)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第三步：智能优化
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分析关键字段，创建值索引...

$ asktable ds index create ds_mysql_001 --schema orders --table orders --field customer_id
$ asktable ds index create ds_mysql_001 --schema orders --table orders --field product_id
$ asktable ds index create ds_pg_001 --schema public --table events --field user_id
$ asktable ds index create ds_excel_002 --schema public --table employees --field employee_id
$ asktable ds index create ds_excel_003 --schema public --table products --field product_name
✓ 已为 5 个关键字段创建值索引

添加业务术语...

$ asktable glossary create --term "活跃用户" --definition "近30天内有登录行为的用户"
$ asktable glossary create --term "高价值订单" --definition "订单金额超过10000元的订单"
$ asktable glossary create --term "华东" --definition "包括上海、江苏、浙江、安徽、福建、江西、山东"
✓ 已添加 3 个业务术语

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第四步：创建统一 Bot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

$ asktable bot create --name "企业数据助手" \
  --datasources ds_mysql_001,ds_pg_001,ds_excel_001,ds_excel_002,ds_excel_003
✓ Bot 创建成功 (ID: bot_unified_001)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第五步：配置权限
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[创建策略 - 员工自查]
$ asktable policy create \
  --name "员工自查策略" \
  --permission allow \
  --datasources ds_mysql_001,ds_pg_001,ds_excel_001,ds_excel_002,ds_excel_003 \
  --rows-filter '{"*.*.employee_id": "{{employee_id}}"}'
✓ 策略创建成功 (ID: policy_employee)

[创建策略 - 管理层全览]
$ asktable policy create \
  --name "管理层全览策略" \
  --permission allow \
  --datasources ds_mysql_001,ds_pg_001,ds_excel_001,ds_excel_002,ds_excel_003
✓ 策略创建成功 (ID: policy_manager)

[创建角色]
$ asktable role create --name "普通员工" --policies policy_employee
✓ 角色创建成功 (ID: role_employee)

$ asktable role create --name "管理层" --policies policy_manager
✓ 角色创建成功 (ID: role_manager)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
完成！配置总结
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ 5 个数据源已配置并优化
  - MySQL: 15 张表, 127 个字段
  - PostgreSQL: 8 张表, 64 个字段
  - Excel: 3 个文件, 30 个字段

✓ 1 个统一查询 Bot
  - 支持跨数据源查询
  - 自动关联相关数据

✓ 2 个角色 + 2 个权限策略
  - 普通员工：只能查询自己的数据
  - 管理层：可以查询全部数据

现在你可以这样使用：

[普通员工查询]
$ asktable query bot_unified_001 "我上个月的销售额" \
  -r role_employee -V employee_id=E001
→ 只返回 E001 员工的数据

[管理层查询]
$ asktable query bot_unified_001 "上个月全公司的销售额" \
  -r role_manager
→ 返回全部数据

[跨数据源查询]
$ asktable query bot_unified_001 "销售额最高的 10 个产品的详细信息"
→ 自动关联订单数据（MySQL）和产品目录（Excel）

总耗时：约 3 分钟

对比：

• •传统方式：1-2 小时，需要逐个配置
• •Claude Code：3 分钟，一次性批量完成

---

核心能力

1. 智能优化数据源

Claude Code 会自动：

• •识别关键字段（ID、名称、金额、日期等）
• •为高频查询字段创建值索引
• •添加业务术语到术语表
• •优化字段描述和单位

效果：查询准确率提升 30%+，响应速度提升 3-5 倍。

2. 自然语言管理

不需要记命令，直接说需求：

• •"帮我上传这个文件"
• •"优化一下员工字段"
• •"配置权限，让员工只能看自己的数据"

3. 全流程自动化

从数据上传到查询优化，一条指令完成：

帮我接入 data.xlsx 并优化

---

立即开始

复制以下指令，粘贴到 Claude Code 对话框：

使用 npm i -g @datamini/asktable-cli 安装工具，然后执行 asktable get-skill 获取并安装 skill

然后说：

帮我把 data.xlsx 上传到 AskTable 并优化

就这么简单。

---

为什么选择 Claude Code + AskTable

传统数据管理：

• •需要学习复杂的界面
• •手动配置每个细节
• •优化依赖经验

Claude Code + AskTable：

• •自然语言交互
• •AI 自动优化
• •最佳实践内置

数据管理，从此变得简单。

---

了解更多：

• •AskTable CLI 完全指南
• •GitHub: AskTable CLI
• •获取 API Key