即席查询任务SKILL

功能介绍

即席查询任务能力支持您通过自然语言指令，临时运行一段SQL、脚本或元信息查询，快速拿到结果，而不会在项目中留下持久化的调度任务。能力覆盖多种任务类型，包括MaxCompute SQL、关系型数据库SQL（如MySQL、Oracle、PostgreSQL、SQLServer）、Hologres、StarRocks、Shell、Python等，并支持在提交后查询运行状态、获取执行结果与日志。

适用场景：

• 临时验证一段SQL或脚本的运行结果，无需为此创建正式任务。

• 执行建表、查数据、查元信息等一次性操作。

• 查询某个数据库或数据源下的表结构、字段信息。

• 在把逻辑固化为持久化任务前，先通过即席查询验证正确性。

使用前提

• 目标Dataphin项目已存在，且当前用户为该项目成员。

• 已准备好要执行的SQL或脚本内容。

• 执行关系型数据库（如MySQL、Oracle、PostgreSQL、SQLServer）的SQL时，需准备好目标数据源以及对应的库名或Schema；执行MaxCompute SQL、Shell、Python等类型时，通常只需指定项目即可。

使用示例

您可以直接用自然语言向Agent描述需求，以下为可直接复制的指令示例：

• 「在这个项目里跑一段MaxCompute SQL：SELECT COUNT(*) FROM my_table。」

• 「查一下这个MySQL数据源public库下company表的字段结构。」

• 「临时执行一句Shell：echo hello world，把结果给我。」

• 「帮我在生产环境即席跑这段SQL，跑完把结果贴出来。」

交互步骤：

1. Agent通常会先与您确认运行环境、目标项目、任务类型与要执行的代码，缺失时会向您询问。

2. 执行关系型数据库SQL时，Agent一般会先协助确认目标数据源与库名，再提交查询。

3. 提交后，Agent会等待任务运行完成，再获取执行结果。

4. 若结果为空或运行异常，Agent通常会查看运行状态与日志，确认任务是否成功后再向您反馈。

执行结果

操作完成后，您可以获得以下结果：

• 返回内容：查询类任务返回结构化的结果数据，通常首行为列名、其后为数据行；脚本类任务返回运行输出。

• 完成状态：任务提交受理后会进入运行，运行成功后即可获取结果；刚结束时结果可能略有延迟，Agent通常会稍候重试或先确认运行状态。

• 查看与验证：您可以将返回结果与预期核对；如需排查异常，可请Agent进一步查看运行日志定位原因。

附录：输入信息

以下为执行即席查询任务时可能涉及的信息项，仅供参考。实际使用时，Agent会根据您的指令自动识别所需信息，缺失时再向您询问；标注为无需提供的信息项由系统自动生成，您无需准备。