# 保存 SQL 和管理版本

使用这些接口保存 SQL 内容，并创建、修改、查看或定稿不同版本。这些接口不会执行 SQL；需要执行 SQL 时，使用 [SQL 执行](../sql-execution/index.md) 接口。

- `workbook_id` 标识一条已保存 SQL 的记录。创建记录或查看已保存 SQL 的列表时会返回该值。
- `version_id` 标识该记录中的一个 SQL 版本。创建草稿或查看版本列表时会返回该值。

接口路径、字段名和部分错误响应仍使用 `workbook` 或“SQL 工作簿”，它们都指上述 SQL 保存记录。

```{toctree}
:hidden:
:maxdepth: 1

查看已保存的 SQL <list-workbooks>
查看已保存 SQL 的版本内容 <get-workbook>
创建 SQL 保存记录 <create-workbook>
修改 SQL 保存记录名称 <update-workbook>
删除 SQL 保存记录 <delete-workbook>
查看已保存 SQL 的版本 <list-workbook-versions>
创建草稿版本 <create-workbook-draft>
修改草稿版本 <update-workbook-draft>
定稿 SQL 版本 <finalize-workbook-version>
```