核心用法
postgres-db 是一套面向 PostgreSQL 的综合性数据库运维技能，封装了日常高频操作：
1. SQL 查询执行：通过 query.py 脚本执行 SELECT/INSERT/UPDATE/DELETE，支持事务控制与结果导出（JSON/CSV），适用于即席查询与数据变更场景。
2. 结构导出：schema_export.py 可提取表结构、索引、外键、视图、触发器等元数据，支持 JSON/Markdown 输出，便于文档化或迁移评估。
3. 备份恢复：基于 pg_dump 实现全库或单表备份，支持定时轮转与时间点恢复策略，满足 RPO 要求。
4. 性能监控：集成 EXPLAIN ANALYZE、索引使用率、表空间统计及连接池状态检查，辅助性能调优。
显著优点
- 标准化操作：封装命令行复杂度，降低人工输入 SQL 或 shell 命令的错误率。
- 多格式输出：查询结果与结构信息均支持机器可读格式，便于对接 CI/CD 或生成文档。
- 开源生态兼容：依赖 psycopg2/asyncpg 与标准 PostgreSQL 客户端工具，无供应商锁定。
潜在缺点与局限性
- 权限风险：脚本需具备数据库登录凭证（PGPASSWORD 等环境变量），在共享环境或日志中可能存在泄露风险。
- 无审计追踪：当前设计未提及操作日志与变更审计，难以满足合规场景的溯源要求。
- 网络暴露：若 PGHOST 指向公网地址且无 SSL 强制，存在中间人攻击面。
- 备份可靠性：依赖本地
pg_dump版本与目标库版本匹配，跨大版本备份可能遇到兼容性问题。
适合人群
- DBA / SRE：需要快速巡检、备份或导出结构的运维人员。
- 后端开发者：在开发/测试环境执行数据查询与 schema 变更。
- 数据工程师：进行轻量级 ETL 前置探索或元数据采集。
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 环境变量存储密码可能被 `ps` 或容器日志捕获 |
| 误操作 | 无交互式确认即执行 UPDATE/DELETE 可能导致数据丢失 |
| 备份失效 | 未验证备份文件完整性，实际恢复时可能失败 |
| 性能冲击 | 大表 EXPLAIN ANALYZE 或全量备份可能锁定资源 |
建议在生产环境启用 SSL、使用只读账号执行查询、并将备份定期做恢复演练。