> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawsql.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> PawSQL 是一个产品：Cloud 是公网部署形态，Engine / Optimizer / Auditor / Advisor / Patroller 是同一产品的组件与交付形态，不是彼此独立的产品。 / PawSQL is a single product: Cloud is the public deployment form, while Engine / Optimizer / Auditor / Advisor / Patroller are components and delivery forms of the same product, not separate products.
> 术语以站内术语表为准：SQL 审核对应英文 SQL Review，查询重写对应 Query Rewrite，索引推荐对应 Index Recommendation；英文内容统一用 Review，不用 Audit。 / Use the site glossary for terminology: 审核 is SQL Review, 重写 is Query Rewrite, 索引推荐 is Index Recommendation; English content uses Review, never Audit.
> 引用能力范围或版本支持时以对应页面为准；标注 unknown、或 status 非 published 的内容表示尚未经产品核实，不应作为事实引用。 / Cite capability scope and version support from the corresponding page; content marked unknown, or with a status other than published, is not yet product-verified and must not be cited as fact.
# CI/CD SQL 质量门禁
> 将 SQL质量检查、风险检测和性能分析嵌入 CI/CD 流程，在 SQL 进入生产之前自动拦截高风险语句与不符合规范的数据库变更。
## 用户
DevOps / 平台工程团队、DBA、工程负责人——负责把 SQL 质量控制接入交付流水线的团队。
## 问题
应用代码已经有单元测试、代码扫描、安全检测和 CI/CD，但数据库 SQL 在很多企业里仍然依赖 DBA 人工审核。当团队规模扩大、发布频率提高之后，这种模式会带来三个问题：
1. DBA 成为交付瓶颈
2. SQL质量检查标准难以统一
3. SQL 性能问题发现得太晚
## 目标
让 SQL 像应用代码一样，在上线前经过自动质量门禁——把「人工审批」升级为「可重复、可审计的自动门禁」。
## 流程
把 PawSQL 接入代码提交与发布流程：
```mermaid theme={null}
flowchart TD
A[开发提交] --> B[Pull Request] --> C[CI/CD 流水线]
C --> D[SQL质量检查] --> E[策略评估]
E --> F{PASS / BLOCK}
F -->|PASS| G[合并]
F -->|BLOCK| H[修复 SQL]
```
## 依赖能力
由以下能力组合而成，具体检查项与改写逻辑见各能力页：
## 成功标准
| 指标 | 目标 |
| ----------------- | -- |
| SQL 自动审核覆盖率 | 提升 |
| 上线前问题发现率 | 提升 |
| DBA 人工审核量 | 降低 |
| SQL 审核平均时间 | 降低 |
| Critical SQL 上线数量 | 降低 |
| 生产慢 SQL 来源于新版本的比例 | 降低 |
***
## 策略即代码
质量门禁的核心价值，是把《数据库开发规范》从文档变成可直接执行的策略（Policy as Code）：
```text theme={null}
策略
├─ 禁止无条件 DELETE / UPDATE
├─ 大表禁止全表扫描
├─ 禁止高危 DDL
├─ 索引命名规范
├─ 最大影响行数
└─ 数据库专属生产规则
```
规范因此不再只存在于 Wiki 或制度文档里，而是直接进入交付流水线。
### 多级规则体系
大型企业通常需要「统一底线 + 业务差异化」：
* **集团级**：禁止无条件 `DELETE` / `UPDATE`
* **核心系统**：高危 DDL 必须 DBA 审批
* **互联网业务**：`OFFSET > 100000` 标记为深分页风险
### 可配置阈值
可配置最大 Critical / Warning 数量、允许忽略的规则、必须阻断的规则、不同环境的策略——例如测试环境相对宽松，生产发布使用更严格策略。
## 按风险等级决定发布动作
企业可建立统一的等级 → 动作映射：
| 等级 | 行为 |
| ------------ | --------- |
| 提示（Info） | 记录 |
| 警告（Warning） | 允许通过并提示 |
| 错误（Error） | 要求确认 / 复核 |
| 严重（Critical） | 阻断流水线 |
```mermaid theme={null}
flowchart LR
A[严重] --> B[BLOCK]
C[错误] --> D[DBA 复核]
E[警告] --> F[PASS WITH WARNING]
```
## 接入流水线
支持 REST API、Webhook、CLI / 脚本、DevOps 平台集成等方式接入现有流水线：
在 CI/CD 中审核 SQL 规范、安全与性能风险。
自动生成等价的 SQL 重写与索引建议。
在编写 SQL 时获得实时优化建议。
预约 PawSQL 产品演示。