# 执行 SQL 和管理 SQL 元数据

执行 SQL、跟踪执行状态和结果，并查询或删除相关数据库、表和视图元数据。本页不管理已保存 SQL 或数据看板；这些对象请参阅[管理 SQL 工作簿和数据看板](sql-workbooks-dashboards.md)。

## 前提条件

准备可访问目标工作区的凭据，以及待执行 SQL 或待查询对象所在的数据库信息。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

查询或删除元数据前，先通过数据库和表查询确定目标对象。

## 调用顺序

1. 需要了解已有对象时，查询数据库、数据库中的表、表信息、表字段或建表语句。
2. 提交 SQL 执行后，保留执行标识，并查询执行状态。
3. 在执行结果可用后查询或下载结果；不再需要继续执行时使用取消操作。
4. 删除数据库、表或视图前，先确认对象和影响范围。

## API 操作

### 执行和取得结果

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 执行 SQL | [执行 SQL](../../../../reference/api/ai-studio/data-processing/sql-execution/execute-sql.md) | 需要提交 SQL 执行时使用。 |
| 查询执行状态 | [查看执行状态](../../../../reference/api/ai-studio/data-processing/sql-execution/get-execution-status.md) | 提交后检查执行当前状态时使用。 |
| 查询执行结果 | [查看执行结果](../../../../reference/api/ai-studio/data-processing/sql-execution/get-execution-result.md) | 执行结果可用后读取结果时使用。 |
| 下载执行结果 | [下载执行结果](../../../../reference/api/ai-studio/data-processing/sql-execution/download-execution-result.md) | 需要取得执行结果文件时使用。 |
| 取消执行 | [取消执行](../../../../reference/api/ai-studio/data-processing/sql-execution/cancel-execution.md) | 不再需要继续目标执行时使用。 |

### 查询 SQL 元数据

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询数据库 | [查看数据库列表](../../../../reference/api/ai-studio/data-processing/sql-metadata/list-databases.md) | 选择目标数据库时使用。 |
| 查询数据库中的表 | [查看数据库中的表和视图列表](../../../../reference/api/ai-studio/data-processing/sql-metadata/list-database-tables.md) | 在已选数据库中定位表时使用。 |
| 查询表信息 | [查看表信息](../../../../reference/api/ai-studio/data-processing/sql-metadata/get-table-info.md) | 检查单个表的当前信息时使用。 |
| 查看表字段 | [查看表字段列表](../../../../reference/api/ai-studio/data-processing/sql-metadata/list-table-columns.md) | 需要查看表字段时使用。 |
| 查询建表语句 | [查看表或视图的创建语句](../../../../reference/api/ai-studio/data-processing/sql-metadata/get-table-ddl.md) | 需要查看表定义语句时使用。 |

### 删除元数据对象

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 删除数据库 | [删除数据库](../../../../reference/api/ai-studio/data-processing/sql-metadata/delete-database.md) | 确认不再需要数据库后使用。 |
| 删除表 | [删除表](../../../../reference/api/ai-studio/data-processing/sql-metadata/delete-table.md) | 确认不再需要表后使用。 |
| 删除视图 | [删除视图](../../../../reference/api/ai-studio/data-processing/sql-metadata/delete-view.md) | 确认不再需要视图后使用。 |

## 结果确认

提交 SQL 后，先通过[查看执行状态](../../../../reference/api/ai-studio/data-processing/sql-execution/get-execution-status.md)确认执行情况，再查询或下载结果。删除元数据对象前后，使用相应的数据库、表和表信息查询确认目标对象。

## 限制和注意事项

- SQL 已提交不等于结果已可用；请以执行状态和结果查询为准。
- 删除数据库、表或视图前，先在相应动作页确认影响和条件。

## 下一步

- [管理 SQL 工作簿和数据看板](sql-workbooks-dashboards.md)