> 功能说明: 本技能涵盖 时使用、化工作流场景 等核心能力。

数据库设计与运维

参数说明

前置条件

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力清单

连接管理陷阱

事务陷阱

Schema变更安全策略

备份与恢复

复制陷阱

查询性能模式

数据完整性

扩展性限制

使用方法

1. 场景识别：判断当前属于连接、事务、Schema、备份、复制、查询、完整性还是扩展性问题
2. 陷阱匹配：在对应类别中查找匹配的陷阱描述与规避方案
3. 方案选择：根据数据库类型（数据库/MySQL）选择具体实现命令
4. 风险评估：评估方案对现有系统的影响（锁表时间、连接数变化、复制延迟）
5. 逐步执行：按安全方案顺序执行，每步验证后再进行下一步

结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

详细示例

示例1：安全添加带默认值的列

-- 错误做法（旧版Postgres会全表重写，锁表数小时）:
-- ALTER TABLE orders ADD COLUMN status VARCHAR(20) DEFAULT 'pending';
# ...
-- 安全做法（分三步）:
-- 领先步: 添加NULL列（瞬时完成，不锁表）
ALTER TABLE orders ADD COLUMN status VARCHAR(20);
# ...
-- 第2步: 分批回填数据
UPDATE orders SET status = 'pending' WHERE id BETWEEN 1 AND 100000;
UPDATE orders SET status = 'pending' WHERE id BETWEEN 100001 AND 200000;
# ...
-- 第3步: 设置默认值与非空约束
ALTER TABLE orders ALTER COLUMN status SET DEFAULT 'pending';
ALTER TABLE orders ALTER COLUMN status SET NOT NULL;

示例2：并发创建索引

-- Postgres: CONCURRENTLY 不阻塞写入（但不能在事务块中使用）
CREATE INDEX CONCURRENTLY idx_orders_customer_id ON orders(customer_id);
# ...
-- MySQL 8+: ONLINE DDL
ALTER TABLE orders ADD INDEX idx_customer_id (customer_id), ALGORITHM=INPLACE, LOCK=NONE;

示例3：避免N+1查询

# 错误: N+1查询（100个订单 = 101次查询）
orders = Order.objects.all()  # 1次查询
for order in orders:
    print(order.customer.name)  # 每次循环1次查询
# ...
# 正确: 预加载（2次查询）
orders = Order.objects.select_related('customer').all()  # JOIN一次查出
for order in orders:
    print(order.customer.name)  # 无额外查询

示例4：避免丢失更新

-- 错误: 读-改-写无锁，并发下丢失更新
SELECT balance FROM accounts WHERE id = 1;  -- 读到 balance=100
-- 另一事务同时读到100，各自扣减20
UPDATE accounts SET balance = 80 WHERE id = 1;  -- 丢失了另一事务的扣减
# ...
-- 正确: 使用 SELECT FOR UPDATE 悲观锁
BEGIN;
SELECT balance FROM accounts WHERE id = 1 FOR UPDATE;  -- 加行锁
UPDATE accounts SET balance = balance - 20 WHERE id = 1;
COMMIT;

示例5：金额存储与计算

-- 错误: 浮点数存金额（舍入误差）
CREATE TABLE bad_orders (total FLOAT);  -- 0.1+0.2 = 0.30000000000000004
# ...
-- 正确: DECIMAL 精确存储
CREATE TABLE good_orders (total DECIMAL(10,2));  -- 0.10+0.20 = 0.30
# ...
-- 或: 整数分存储
CREATE TABLE cent_orders (total_cents INT);  -- 10分+20分=30分

示例6：大表COUNT(*)优化

-- 慢: COUNT(*) 全表扫描（1亿行需数十秒）
SELECT COUNT(*) FROM huge_table;
# ...
-- 快: 近似计数（毫秒级，误差约5%）
SELECT reltuples::BIGINT FROM pg_class WHERE relname = 'huge_table';
# ...
-- 或: 缓存计数
SELECT count FROM table_count_cache WHERE table_name = 'huge_table';

故障恢复

热门问题

Q1: 连接池应该设置多大？

A: 公式：pool_size = (核心数 * 2) + 有效磁盘数。但连接数不是越多越好——连接越多锁竞争越激烈。建议从 pool_size = 10 开始，根据监控调整。Serverless 环境必须使用 RDS Proxy 或 PgBouncer.

Q2: 事务应该保持多短？

A: 事务应只包含数据库操作，不包含HTTP调用、文件IO等耗时操作。Postgres 中长事务会持有 MVCC 快照，阻塞 VACUUM 清理死元组。建议设置 idle_in_transaction_session_timeout = 60s.

Q3: 单表超过1亿行就必须分片吗？

A: 不一定。如果查询都命中索引，1亿行仍可高效运行。需要分片的信号：(1) 写入QPS超过单库极限；(2) 索引维护成本过高；(3) 维护窗口不足以完成 VACUUM。可以先尝试分区表（按时间或哈希），分片是最后手段.

Q4: 为什么浮点数不能存金额？

A: IEEE 754浮点数无法精确表示十进制小数。0.1 + 0.2 在浮点数中等于 0.30000000000000004。大量累加后误差会累积，导致账目不平。必须使用 DECIMAL(10,2) 或整数分（INT 存分）.

Q5: CREATE INDEX CONCURRENTLY 失败了怎么办？

A: CONCURRENTLY 失败后会留下 INVALID 索引。需要先 DROP INDEX 删除无效索引，再重新执行 CREATE INDEX CONCURRENTLY。注意：CONCURRENTLY 不能在事务块中使用.

Q6: 如何监控复制延迟？

A: 数据库数据库 中查询 pg_stat_replication 视图：SELECT application_name, replay_lag FROM pg_stat_replication;。延迟超过30秒应告警。大事务是延迟的主要原因，建议将大事务拆分为小批次.

限制条件

• 主要覆盖 数据库 与 MySQL 场景，其他数据库（如 MongoDB、Redis）的陷阱需另行参考
• 扩展性建议基于单机房架构，跨地域多活场景需额外考虑
• 分片策略需结合具体业务场景设计，本技能提供原则而非具体方案
• 备份恢复验证需要额外测试环境，资源受限时可能无法定期执行

输出说明

{
  "success": true,
  "data": {
    "result": "数据库设计与运维处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "db"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

安全提示

差异化分析

用户咨询

Q1: 数据库设计与运维支持哪些输入格式？

A1: 识别并规避数据库连接、事务、Schema变更、备份恢复、复制、查询、数据完整性与扩展性陷阱。数据库设计与运维——帮助设计和操作数据库时避免常见的扩展性、可靠性和。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

性能数据

差异分析

数据库设计与运维通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块