文档反馈
问问助手ByteHouse 云数仓版支持通过定时任务管理计算组伸缩和执行 SQL 查询。本文将介绍如何管理定时任务。
ByteHouse 定时任务支持两类核心能力，满足运维和查询需求：
- 计算组定时伸缩：根据任务设置的执行时间，自动调整计算组的弹性伸缩，匹配不同时段的查询流量和工作负载。
- SQL 查询定时执行：在预设时间自动化执行提前配置好的 SQL 语句。
其中，通过定时任务调整计算组规格，可带来以下价值：
- 节约成本：利用定时任务来管理计算组规格，降低成本。
- 提升运维效率：无需维护外部工具，也无需手动修改计算组配置，减少人工操作成本。
新建定时任务
登录 ByteHouse 云数仓版控制台，单击顶部任务中心，单击定时任务页签下的新建定时任务，进入新建定时任务页面。
配置任务基本信息。填写任务名称，选择任务类型，按需填写任务描述。
任务类型支持设置为计算组伸缩或 SQL 查询：- 计算组伸缩：根据任务设置的规格和执行计划，ByteHouse 将按时自动调整计算组的规格。
- SQL 查询：根据任务设置的 SQL 查询，ByteHouse 将按时自动执行该查询。
设置执行任务内容。根据您选择的任务类型不同，需配置的参数也不同，您可根据任务类型查看对应的参数配置说明。
参数项
配置说明
计算组伸缩参数
计算组
选择需调整的计算组。
伸缩行为
从下拉列表中选择目标计算组规格。当前仅支持按量计费，扩容或缩容后，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;设置任务的执行计划。
参数说明如下：参数项
配置说明
开始时间
选择任务的开始时间。
结束时间
选择任务的结束时间，任务执行周期不得超过该时间。
时区
选择任务执行时间对应的时区。
执行周期
选择任务的有效周期，支持选择为每天、每周、每月、自定义。不同周期后续需配置的参数不同，详见下述参数说明。
- 每天：需配置执行时间。
- 每周：需配置执行天和执行时间。
- 每月：需配置执行天和执行时间。
- 自定义：需配置 Cron 表达式。
执行天
执行周期设置为每周、每月时需配置该参数。
- 每周：选择任务在每周的哪一天或哪几天执行。
- 每月：选择任务在每月的哪一天或哪几天执行。该设置仅支持设置为 1-28 日，如果您需要设置为每月的其他日期，请使用 Cron 表达式。
执行时间
选择任务在指定执行天的具体执行时间。
Cron 表达式
指定周期选择为自定义时需配置该参数，用于设置执行计划任务的时间/频率。
将日期设置为 29、30、31 时，当月如果不存在该日期，ByteHouse 将在当月最后一天执行任务。恢复时间
可选，设置后，任务将在指定时间恢复至执行前的状态。
创建后状态
选择任务创建后的初始状态。
- 活动：任务创建后保持活跃状态，并将在设置的下个执行时间执行该任务。
- 暂停：任务创建后，该任务处于非活跃状态，在下个执行时间也不执行。如需启用该任务，可使用以下两种方式
- 单次执行：在任务中心页面，单击操作列的立即执行，任务将立即执行一次。
- 周期执行：编辑任务，将任务状态调整为活动，编辑任务操作请参见编辑任务。
单击保存，完成新建定时任务。您可以在任务中心查看到所有定时任务。
（可选）任务创建完成后，您可单击任务操作列的立即执行按钮，立即执行一次当前任务。
查看任务详情
在任务中心页面，单击任务名称，进入任务详情页。您可查看任务的执行记录，包括任务类型、UUID、状态、消息、query ID、执行开始时间、时长等信息。
如果任务执行失败，您可单击消息列的详情按钮，查看任务失败的具体原因，协助排障。
编辑任务
在任务中心页面，单击任务操作列的编辑按钮。
删除定时任务
在任务中心页面，单击任务操作列的删除按钮。
创建任务后，您可以在租户管理 > 监控告警页面查看任务的监控指标数据。
当前支持的计算组监控指标详情，以及通过火山引擎云监控创建监控告警的操作指导请参见监控告警。