ByteHouse 云数仓版支持通过定时任务管理计算组伸缩和执行 SQL 查询。本文将介绍如何管理定时任务。

ByteHouse 定时任务支持两类核心能力，满足运维和查询需求：

1. 计算组定时伸缩：根据任务设置的执行时间，自动调整计算组的弹性伸缩，匹配不同时段的查询流量和工作负载。
2. SQL 查询定时执行：在预设时间自动化执行提前配置好的 SQL 语句。

其中，通过定时任务调整计算组规格，可带来以下价值：

• 节约成本：利用定时任务来管理计算组规格，降低成本。
• 提升运维效率：无需维护外部工具，也无需手动修改计算组配置，减少人工操作成本。

新建定时任务 #

1. 登录 ByteHouse 云数仓版控制台，选择数据开发 > 定时任务，单击新建定时任务，进入操作页面。
   

2. 配置任务基本信息。填写任务名称，选择任务类型，按需填写任务描述。
   任务类型支持设置为计算组伸缩或 SQL 查询：

   • 计算组伸缩：根据任务设置的规格和执行计划，ByteHouse 将按时自动调整计算组的规格。
   • SQL 查询：根据任务设置的 SQL 查询，ByteHouse 将按时自动执行该查询。

3. 设置执行任务内容。根据您选择的任务类型不同，需配置的参数也不同，您可根据任务类型查看对应的参数配置说明。

   参数项	配置说明
   计算组伸缩参数
   计算组	选择需调整的计算组。
   扩缩容方式	扩缩容方式支持目标规格和弹性规格。其中弹性规格支持负载弹性和潮汐集群。 当前仅支持按量计费，扩容或缩容后，ByteHouse 将按照新规格计费。
   SQL 查询参数
   计算组	选择执行 SQL 查询的计算资源。
   SQL 方言	选择您后续输入的 SQL 语句使用的方言，支持设置为 ANSI SQL、ClickHouse SQL、MySQL。
   SQL 语句	在代码块中输入需执行的 SQL 语句，指明需查询的数据对象，无需配置连接信息。支持设置为多条 SQL 语句，ByteHouse 在执行时将生成多个查询 ID，您可通过任务详情查看，操作详情请参见查看任务详情。 SELECT * FROM demo_db.demo_table LIMIT 10; SELECT * FROM demo_db2.demo_table2 LIMIT 10;

4. 设置任务的执行计划。
   
   参数说明如下：

   参数项	配置说明
   开始时间	选择任务的开始时间。
   结束时间	选择任务的结束时间，任务执行周期不得超过该时间。
   时区	选择任务执行时间对应的时区。
   执行周期	选择任务的有效周期，支持选择为每天、每周、每月、自定义。不同周期后续需配置的参数不同，详见下述参数说明。 每天：需配置执行时间。 每周：需配置执行天和执行时间。 每月：需配置执行天和执行时间。 自定义：需配置 Cron 表达式。
   执行天	执行周期设置为每周、每月时需配置该参数。 每周：选择任务在每周的哪一天或哪几天执行。 每月：选择任务在每月的哪一天或哪几天执行。该设置仅支持设置为 1-28 日，如果您需要设置为每月的其他日期，请使用 Cron 表达式。
   执行时间	选择任务在指定执行天的具体执行时间。
   Cron 表达式	指定周期选择为自定义时需配置该参数，用于设置执行计划任务的时间/频率。 将日期设置为 29、30、31 时，当月如果不存在该日期，ByteHouse 将在当月最后一天执行任务。
   恢复时间	可选，设置后，任务将在指定时间恢复至执行前的状态。
   创建后状态	选择任务创建后的初始状态。 活动：任务创建后保持活跃状态，并将在设置的下个执行时间执行该任务。 暂停：任务创建后，该任务处于非活跃状态，在下个执行时间也不执行。如需启用该任务，可使用以下两种方式 单次执行：在任务中心页面，单击操作列的立即执行，任务将立即执行一次。 周期执行：编辑任务，将任务状态调整为活动，编辑任务操作请参见编辑任务。

5. 单击保存，完成新建定时任务。您可以在任务中心查看到所有定时任务。

6. （可选）任务创建完成后，您可单击任务操作列的立即执行按钮，立即执行一次当前任务。

查看任务详情 #

在定时任务页面，单击任务名称，进入任务详情页。您可查看任务的执行记录，包括任务类型、UUID、状态、消息、query ID、执行开始时间、时长等信息。
如果任务执行失败，您可单击消息列的详情按钮，查看任务失败的具体原因，协助排障。

编辑/删除定时任务 #

在定时任务页面，单击任务操作列的编辑/删除按钮。

创建任务后，您可以在租户管理 > 监控告警页面选择任务中心查看相关指标数据。

当前支持的计算组监控指标详情，以及通过火山引擎云监控创建监控告警的操作指导请参见监控告警。