ByteHouse 支持创建数据导出任务，一次性或定期导出数据至火山引擎对象存储服务（Torch Object Storage，TOS），便于您进行数据分析。

使用 ByteHouse 数据导出功能前，请准备好以下资源：

• TOS 数据源：先在 ByteHouse 创建数据源，创建一个 TOS 数据源，详情请参见批式导入。
• 请在火山引擎 TOS 中创建好数据导出后的存储桶，操作详情请参见创建存储桶。

1. 登录 ByteHouse 控制台，单击顶部任务中心，单击定时任务，在定时任务页面单击新建定时任务，选择数据导出任务。
   

2. 配置数据导出任务详情。
   

   参数	配置说明
   集群	选择您需要导出数据所在的集群。
   任务名称	自定义任务名称。名称只能包含字母数字，汉字，空格，下划线和中划线。
   执行类型	支持按指定周期导出和一次性导出任务。
   描述	自定义任务描述。
   Cron 表达式	使用 Cron 表达式配置导出任务的执行时间。配置后，您可在预览区查看 Cron 表达式对应的执行时间。 注意 若导出时系统资源不足，周期任务在指定执行时间点因待执行任务过多导致排队，实际导出任务的开始时间将延迟。

3. 填写查询 SQL，用于查询您需要导出的数据。
   

4. 配置数据导出任务。
   

   参数	配置说明
   导出文件名	系统默认生成文件名，您也可根据默认示例自定义文件名。
   源类型	选择导出目标数据源类型，当前仅支持 S3。
   数据源	选择 ByteHouse 中已添加的 TOS 数据源，建立与导出目标数据源的连接。 如果您尚未创建数据源，可单击创建按钮，系统将自动跳转至新建数据源页面，您可参考批式导入配置数据源相关信息。
   Bucket	选择需将数据导出至的目标存储桶。
   导出格式	数据导出的格式，支持 CSV 和 Parquet。 注意 当前 ByteHouse 导出 Parquet 文件暂不支持 Date 数据类型导出为日期类型，导出时该类型会自动转换为 Int 类型。若您的数据表中包含 Date 类型列，可在导出 SQL 语句中添加 toString 手动转换，示例如下： SELECT xx, xx, toString(toDate(xx)) FROM xx
   自定义参数	用于定义导出参数，支持通过单行编辑和脚本编辑。 系统默认配置了 s3_use_virtual_hosted_style 参数，用于设置存储桶的访问方式，默认值为 1，表示使用虚拟主机风格（Virtual Hosted Style）访问存储桶。当前 TOS 仅支持 Virtual Hosted Style，不支持路径访问模式（path style），使用时无需调整该参数。 您也可按需自定义参数，如超时参数 max_execution_time。

5. 配置完成后，单击保存。系统将自动创建任务，并提示“创建定时任务成功”。您可单击提示页面的任务详情查看任务配置。

6. 任务执行后，您可单击任务名称，查看任务执行状态及详情。

   • 如果状态显示为“成功”，表示任务执行成功，您可单击导出文件名后的链接按钮，系统将自动跳转到 TOS 对应的文件夹，您可通过文件名查看已导出的文件。
     
   • 如果状态显示为“失败”，您可将鼠标悬浮至“失败”字样上方，查看失败原因。确认原因后，可再次编辑任务，对应调整任务配置，再次尝试执行任务。

在定时任务列表中，单击目标任务所在行的编辑按钮，调整任务配置，您可参考创建任务中的参数说明进行配置。

您也单击任务名称，进入任务详情页面，单击编辑按钮，调整任务配置。

如果您创建的是周期性任务，您可暂停执行该任务。
在定时任务列表中，单击目标任务名称，进入任务详情页面，单击暂停。

在定时任务列表中，单击目标任务所在行的删除按钮，单击删除，即可删除当前任务。

您也单击任务名称，进入任务详情页面，单击删除按钮，删除当前任务。