---
title: "启动异步SQL重写任务"
method: POST
path: "/v1/tasks/audits/{task_id}/sqls/{number}/rewrite"
tags: ["task"]
---

# 启动异步SQL重写任务

`POST /v1/tasks/audits/{task_id}/sqls/{number}/rewrite`

启动特定任务中某条SQL语句的异步重写任务，返回任务状态

## Path parameters

- `task_id` string, required
- `number` integer, required

## Request body

- V1RewriteSQLReq
  - `enable_structure_type` boolean — 是否启用结构化类型的重写

## Response `200`

成功启动异步重写任务

- V1AsyncRewriteTaskStatusRes
  - `code` integer
  - `data` V1AsyncRewriteTask
    - `end_time` string — 结束时间
    - `error_message` string — 错误信息
    - `result` V1RewriteSQLData
      - `business_desc` string — 重写前的SQL业务描述
      - `business_non_equivalent_desc` string — 重写前后的业务不等价性描述，为空表示等价
      - `logic_desc` string — 重写前的SQL执行逻辑描述
      - `rewritten_sql` string — 重写后的SQL
      - `rewritten_sql_business_desc` string — 重写后的SQL业务描述
      - `rewritten_sql_logic_desc` string — 重写后的SQL执行逻辑描述
      - `suggestions` V1RewriteSuggestion[] — 重写建议列表
        - `audit_level` 'normal' | 'notice' | 'warn' | 'error' — 审核规则等级
        - `ddl_dcl` string — 具体的数据库结构变更语句，需要在数据库中执行该变更语句之后再应用重写SQL（包含CREATE/ALTER/DROP等DDL语句，或SET等DCL语句）（适用于结构级重写）
        - `ddl_dcl_desc` string — 数据库结构变更建议说明（例如：建议添加索引、修改表结构等优化建议）（适用于结构级重写）
        - `desc` string — 重写描述（适用于所有类型）
        - `rewritten_sql` string — 重写后的SQL（适用于语句级重写和结构级重写）
        - `rule_name` string — 审核规则名称
        - `status` 'initial' | 'processed' — 处理状态：初始化、已处理
        - `type` 'statement' | 'structure' | 'other' — 重写建议类型：语句级重写、结构级重写、其他
    - `sql_number` string — SQL编号
    - `start_time` string — 开始时间
    - `status` 'pending' | 'running' | 'completed' | 'failed' — 任务状态
    - `task_id` string — 任务ID
  - `message` string

---

[API](https://skmtc.dev/actiontech/apis/sqle-api-docs.md) · [All operations](https://skmtc.dev/actiontech/apis/sqle-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/actiontech/sqle-api-docs/revisions/3e36a0067703/schema)