执行 SQL 和管理 SQL 元数据¶

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

前提条件¶

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

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

调用顺序¶

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

API 操作¶

执行和取得结果¶

要完成的事	API 操作	何时使用
执行 SQL	执行 SQL	需要提交 SQL 执行时使用。
查询执行状态	查看执行状态	提交后检查执行当前状态时使用。
查询执行结果	查看执行结果	执行结果可用后读取结果时使用。
下载执行结果	下载执行结果	需要取得执行结果文件时使用。
取消执行	取消执行	不再需要继续目标执行时使用。

查询 SQL 元数据¶

要完成的事	API 操作	何时使用
查询数据库	查看数据库列表	选择目标数据库时使用。
查询数据库中的表	查看数据库中的表和视图列表	在已选数据库中定位表时使用。
查询表信息	查看表信息	检查单个表的当前信息时使用。
查看表字段	查看表字段列表	需要查看表字段时使用。
查询建表语句	查看表或视图的创建语句	需要查看表定义语句时使用。

删除元数据对象¶

要完成的事	API 操作	何时使用
删除数据库	删除数据库	确认不再需要数据库后使用。
删除表	删除表	确认不再需要表后使用。
删除视图	删除视图	确认不再需要视图后使用。

结果确认¶

提交 SQL 后，先通过查看执行状态确认执行情况，再查询或下载结果。删除元数据对象前后，使用相应的数据库、表和表信息查询确认目标对象。

限制和注意事项¶

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

下一步¶

管理 SQL 工作簿和数据看板

最后更新于 2026 年 9 月 1 日