@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/task_scheduling.md

@@ -0,0 +1 @@
+^

package/bin/skills/lakehouse-doc/references/task_scheduling_dependency.md

@@ -0,0 +1,74 @@
+# 任务调度依赖关系
+
+## 概述
+
+任务调度依赖是不同任务节点之间，形成上下游依赖关系的配置操作。既支持同工作空间内配置任务依赖关系，也支持配置跨工作空间依赖其它工作空间下的任务节点。您可根据实际业务逻辑所需的依赖场景，配置任务的上下游依赖，
+
+## 依赖特殊说明
+
+**当前的依赖限制**
+
+* 不支持任务类型：实时同步、多表实时同步、动态表、流式SQL。
+* 不允许配置环形依赖。
+* 当被依赖的节点未上线时，下游节点不支持上线。
+* 若当前节点被其他任务所依赖，且该节点下游的周期调度任务处于正常调度中，则当前节点不允许直接下线。
+
+## 依赖配置入口
+
+![](.topwrite/assets/image_1756107294537.png)
+进入具体的任务后，点击任务工具栏「调度」，进入调度配置弹窗页面。
+点击调度依赖可选择依赖的任务，配置依赖策略等行为操作。
+
+## 实例依赖关系说明
+
+云器Lakehouse支持分钟、小时、天三种类型的调度任务互相依赖，调度类型不同，任务执行的周期数不同。当周期任务运行时，下游周期实例会依赖上游周期实例。
+当前系统内提供三种依赖方式：
+
+**默认依赖**：系统内默认的挂载关系为区间依赖，即用下游任务实例的起止时间范围去与上游实例的起止时间范围进行重叠判断后，并基于以下规则判断具体依赖的实例范围：
+
+* 同周期：即同周期进行依赖。
+* 大周期依赖小周期：比如天任务依赖小时任务，下游实例覆盖上游任务几个实例，就依赖哪几个上游实例。
+* 小周期依赖大周期：比如小时任务依赖天任务，下游实例被上游哪个实例覆盖，就依赖哪个上游实例。
+
+**向前依赖**：下游任务实例寻找上游任务实例依赖时只会依赖距离其定义时间往前（等于或早于本实例的定时时间）的所有上游实例。
+
+**向前就近依赖**：当用户选定向前就近依赖时，下游任务实例寻找上游任务实例依赖时会遵循就近原则，即依赖距离其定时执行时间最近（等于或早于本实例的定时时间）的上游实例。
+
+> 注意：下游任务一旦挂载依赖，则需要满足两个条件才可以触发实例的正常运行，即上游任务实例正常运行成功，以及达到自身的调度时间。
+
+## 复杂依赖场景说明
+
+### 同周期依赖
+
+| 场景分类         | 任务说明                                                                                                                             | 示意图\_默认依赖                                                                                                                                                         |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 天任务B依赖天任务A   | 任务A：每天19:00生成1个实例  任务B：每天09:00生成1个实例  上游天任务未设置自依赖  默认下游天任务的周期实例挂载依赖至同周期的上游天任务周期实例。  上游天任务设置自依赖  上游天任务设置自依赖，下游天任务依赖上游天任务时存在跨周期依赖。 | ![](.topwrite/assets/7b129dadfb/98452de2e2b79fa155a55371b7f489e1d5cd5cfd.jpeg)  说明：无论任何类型的自依赖都会创建一个与上一个周期的依赖关系，若上一个周期未运行完成，会阻碍下一个周期的任务无法调度。示意图仅以天周期演示，后续类型不再重复说明。 |
+| 小时任务B依赖小时任务A | 任务A：00:31-23:59区间，每1个小时生成实例。 一共生成24个实例，首个实例为00:31。  任务B：00:10-23:59区间，每1个小时生成实例。 一共生成24个实例，首个实例为00:10。                           | ![](.topwrite/assets/7b129dadfb/ab5444530545f6680a270889074a85738a159cef.jpeg)                                                                                    |
+|              | 任务A：12:30-15:59区间，每1个小时生成实例。 一共生成4个实例，首个实例为12:31。  任务B：15:10-18:59区间，每1个小时生成实例。 一共生成4个实例，首个实例为15:10。                             | ![](.topwrite/assets/7b129dadfb/1c635dd17ece33adb3faa5ca7ee5a8ab09a05b26.jpeg)                                                                                    |
+| 分钟任务B依赖分钟任务A | 任务A：00:00-01:59区间，每5个分钟生成实例。 一共生成12个实例，首个实例为00:00。  任务B：00:10-00:59区间，每5个分支生成实例。 一共生成10个实例，首个实例为00:10。                           | ![](.topwrite/assets/7b129dadfb/8a0c5f6c04e1e9a55155bbc2724147788c169fcd.jpeg)                                                                                    |
+|              | 任务A：00:22-00:59区间，每5个分钟生成实例。 一共生成8个实例，首个实例为00:12。  任务B：00:36-00:59区间，每5个分钟生成实例。 一共生成5个实例，首个实例为00:15。                             | ![](.topwrite/assets/7b129dadfb/03495a4d20f86aec92ca75c1c49b615dba8993f7.jpeg)                                                                                    |
+
+### 大周期依赖小周期
+
+| 场景           | 依赖说明                                                                                                     | 示意图 \_默认依赖                                                                                                                            |
+| ------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| 天任务B依赖小时任务A  | 任务A：00:31点-23:59点，每1个小时生成实例。 一共生成24个实例，首个实例为00:31  任务B：每天19:00生成1个实例                                     | ![](.topwrite/assets/7b129dadfb/0668799023e06d16554eec11c4ba182153ce5f66.jpeg)                                                        |
+| 小时任务B依赖小时任务A | 任务A：00:31-23:59点区间，每1个小时生成实例。 一共生成24个实例，首个实例为00:31。  任务B：00:10-23:59点区间，每2个小时生成实例。 一共生成12个实例，首个实例为00:10。 | ![](.topwrite/assets/7b129dadfb/3d893243e925e6cfe57e9364facf592dd3ba2f07.jpeg)                                                        |
+|              | 任务A：05:31-11:59点区间，每3个小时生成实例。 一共生成3个实例，首个实例为05:31。  任务B：07:10-17:59点区间，每5个小时生成实例。 一共生成3个实例，首个实例为07:10。   | ![](.topwrite/assets/7b129dadfb/e310befdfa2f36d91bf0340f2c2c30172820f0f5.jpeg)                                                        |
+| 小时任务B依赖分钟任务A | 任务A：00:08-01:59点区间，每10分钟生成实例。 一共生成12个实例，首个实例为00:08。  任务B：00:15-00:59点区间，每1个小时生成实例。 一共生成1个实例，首个实例为00:15。  | ![](.topwrite/assets/7b129dadfb/39973d157180d8aba3a98318be2e0da080614591.jpeg)                                                        |
+| 分钟任务B依赖分钟任务A | 任务A：00:00-01:59点区间，每10个分钟生成实例。 一共生成12个实例，首个实例为00:00。  任务B：00:38-01:59点区间，每20分钟生成实例。 一共生成4个实例，首个实例为00:38。 | ![](.topwrite/assets/7b129dadfb/b291ee71ad481cd0756c1ed8bda99fa310d21639.jpeg)  说明：分钟粒度的起止范围若存在跨小时，则会自动截断，例如图例任务B自左而右第二个实例的范围为「58，60) |
+
+### 小周期依赖大周期
+
+| 场景           | 依赖说明                                                                                                     | 示意图 \_默认依赖                                                                     |
+| ------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| 小时任务B依赖天任务A  | 任务A：每天19点生成1个实例  任务B：00:31点-23:59点，每1个小时生成实例。 一共生成24个实例，首个实例为00:31。                                      | ![](.topwrite/assets/7b129dadfb/b0d5f070a0e56564e5abd3fed551c3fe5f59a98d.jpeg) |
+| 小时任务B依赖小时任务A | 任务A：00:31-23:59点区间，每2个小时生成实例。 一共生成12个实例，首个实例为00:31。  任务B：01:10-10:59点区间，每1个小时生成实例。 一共生成10个实例，首个实例为01:10。 | ![](.topwrite/assets/7b129dadfb/1f4ceabddf7f67a7857757b1df2cb2a87dc8445d.jpeg) |
+| 分钟任务B依赖小时任务A | 任务A：00:15-00:59点区间，每1个小时生成实例。 一共生成1个实例，首个实例为00:15。  任务B：00:08-01:59点区间，每10分钟生成实例。 一共生成12个实例，首个实例为00:08。  | ![](.topwrite/assets/7b129dadfb/809a2068b534db2d520a5f2fd421136cfdc17f22.jpeg) |
+| 分钟任务B依赖分钟任务A | 任务A：00:38-01:59点区间，每20分钟生成实例。 一共生成4个实例，首个实例为00:38。  任务B：00:00-01:59点区间，每10个分钟生成实例。 一共生成12个实例，首个实例为00:00。 | ![](.topwrite/assets/7b129dadfb/02eb9c9b349e305232f514e8d917769c9403d98c.jpeg) |
+
+### 常见问题
+
+问题1：已提交至生产环境中的周期任务流程中，某个节点发现发现实例运行错误后，将该任务下线后替换成其他任务再提交运行后，为什么错误的实例还是会有。
+
+回答：已运行完成的任务实例不会因为该任务的下线而下线。

package/bin/skills/lakehouse-doc/references/taskdevelop.md

@@ -0,0 +1,268 @@
+# 任务开发与调度配置
+
+## 概述
+
+「开发」即大数据集成开发环境（IDE），为开发者提供了高效、智能的在线工作环境。可支持用户进行任务编写、调试运行、配置调度以及提交发布等操作，完成整个大数据加工处理分析的关键流程。
+
+在左侧导航菜单，点击“开发”后可以进入主界面。
+
+## 界面总览
+
+![](.topwrite/assets/image_1735640592511.png)
+
+| 序号 | 功能                                                        |
+| -- | --------------------------------------------------------- |
+| 1  | 功能切换                                                      |
+| 2  | 切换工作空间： 该部分为您展示了当前登录的数据开发项目空间名称和所处的区域，您可单击下拉图标，切换至其他项目空间。 |
+| 3  | 开发目录树： 目录树用于有序管理任务代码。可以按照业务需要创建目录树来对任务进行分类别、分层次管理。        |
+| 4  | SQL编译区： 开发的主操作界面，不同类型的编译区的操作界面不同。                         |
+| 5  | 运行结果： 针对SQL编译区的操作结果呈现开发运行后的结果。                            |
+
+## 目录树
+
+数据开发模块以目录树的方式展现当前项目下的所有任务，方便对任务进行增删改查。
+
+在目录树上，支持的操作如下：
+
+* **切换tab**：通过点击tab，切换下方目录树的类型，即任务目录树或数据目录树。
+
+* **任务目录树**：下方呈现的是当前空间下的所有任务列表。
+
+* **数据目录树**：下方呈现的是用户所在Region下的所有数据目录树，按照工作空间-schema-表/视图的层级进行呈现。
+
+* **新建**：通过点击目录树的 + 按钮，来新建文件夹和各类开发任务。
+
+* **开发任务类型**：实时同步、离线同步、SQL脚本、Python脚本、shell脚本
+
+* **筛选任务**：支持用户按照开发任务类型、提交状态、责任人进行过滤筛选
+
+* **刷新**：刷新当前目录树信息。
+
+* **搜索任务**：根据任务名称或者路径进行搜索定位到具体任务
+
+* **任务名称**：将关键词与“任务名称”进行模糊匹配，返回符合条件的文件目录或者任务。
+
+* **路径**：将关键字与任务所在的路径进行模糊匹配，返回符合条件的文件目录或者任务。
+
+* **创建子目录&创建子任务**：鼠标悬浮在子目录上方时，会出现更多的图标，点击可执行以下操作：
+
+* **当前目录为文件夹**：在当前层级下可创建任意任务类型、新建文件夹、删除、重命名
+
+* **当前目录为任务**：在当前层级下可打开任务、创建副本、复制名称、重命名、移动、删除
+
+**操作说明**：
+
+* 创建副本：复制当前任务，包括任务内的调度配置。
+* 复制名称：复制当前目录名称。
+* 重命名：重命名目录名称。
+* 移动：将该目录进行移动至本项目下的其它目录中，若该目录中包含子目录或任务，则一起移动。
+* 删除：删除该目录。
+* **任务目录树**：列表上用icon区分任务类型，颜色区分上线状态。
+
+![](.topwrite/assets/43961fb877/97e53c195a68bc32dc20f8d05406a65814f50ebf.png =283)
+
+| 状态图例                                                                              | 说明                       |
+| --------------------------------------------------------------------------------- | ------------------------ |
+| ![](.topwrite/assets/43961fb877/cf868103bc526077f03e907734acc40282147b16.png =54) | 任务提交后，但保存的版本与提交版本有区别。   |
+| ![](.topwrite/assets/43961fb877/c09176dc520bc8b67fd0332486a742f98c996e4c.png =52) | 任务提交后，服务端保存的版本与提交版本一致。 |
+| ![](.topwrite/assets/43961fb877/3c8f88221d1cb5096a50fe2f871717264c355624.png =50) | 任务提交后，点击下线操作。            |
+| ![](.topwrite/assets/43961fb877/4ffcc5e1d5ceda6d460b753cce8e713d4cd1eb58.png =45) | 其他状态类型。                  |
+
+| 标识图例                                                                              | 说明       |
+| --------------------------------------------------------------------------------- | -------- |
+| ![](.topwrite/assets/43961fb877/c09176dc520bc8b67fd0332486a742f98c996e4c.png =45) | 实时同步     |
+| ![](.topwrite/assets/43961fb877/c7a4258cc7c3fffb428b3393d189d5b56d1352b8.png =40) | 离线同步     |
+| ![](.topwrite/assets/43961fb877/b0a4f31a60e860ec4168f2a6aa6c75bd349882ff.png =46) | SQL脚本    |
+| ![](.topwrite/assets/43961fb877/a34b52a1a518262075162653a0e7bd5efdf8373d.png =43) | shell脚本  |
+| ![](.topwrite/assets/43961fb877/9a58c3506c9ddc8c176f67d1224b55de6a08ebb0.png =40) | python脚本 |
+
+## 任务开发流程
+
+数据开发模块基于Lakehouse底层的引擎能力，提供多种开发类型，用户可以自己选择任务类型进行交互式数据开发工作。
+
+### 新建任务
+
+当前支持两类任务节点：数据集成、数据开发。
+
+点击「新建」后，选择具体的开发类型后，弹出弹窗，输入任务名称，选择当前任务需要保存的具体目录层级后，进入开发界面。
+
+![](.topwrite/assets/image_1690523560494.png =210)
+
+### 操作栏说明
+
+#### 任务页签
+
+![](.topwrite/assets/43961fb877/904d8da4a2bade280ba2901837430ed51d2f5fdd.png)
+
+用户点击左侧任务目录树或者新建任务节点后，会打开（或定位）该任务页签。在任务页签栏，用户可进行以下操作：
+
+**新建**：支持用户点击页签状态栏的“+”号快捷新建一个任务，该任务默认保存在当前空间的根节点下。
+
+**关闭页签**：鼠标悬浮在页签上方，出现向下的按钮时，可对该任务页签进行批量关闭的操作。
+
+页签颜色状态对应关系：
+
+| 状态图例 | 说明   |
+| ---- | ---- |
+| 绿色   | 运行成功 |
+| 红色   | 运行失败 |
+| 蓝色   | 正在运行 |
+| 灰色   | 暂无运行 |
+
+#### SQL功能区
+
+![](.topwrite/assets/43961fb877/d87ab875a66382a674db74e3afeeeb3b722100d6.png)
+
+| 序号 | 功能名称   | 说明                                                                                                     |
+| -- | ------ | ------------------------------------------------------------------------------------------------------ |
+| 1  | 保存     | 将任务进行保存操作，保存当前节点代码及相关配置。                                                                               |
+| 2  | 格式化    | 格式化书写的代码，使其语法结构看起来简洁明了                                                                                 |
+| 3  | 参数     | 暂未上线。                                                                                                  |
+| 4  | 版本     | 点击版本，可查看当前任务上的提交版本和保存版本。 支持版本之间的代码查看和代码回滚。                                                             |
+| 5  | 调度     | 点击弹出侧边栏弹窗，进行调度设置，具体配置方式详见调度设置                                                                          |
+| 6  | 提交     | 仅对要定时调度的任务才需要使用“提交”功能。“提交”后，任务会提交发布到运维中心、按照配置的调度时间定时调度运行 任务在提交前，需要进行调度配置，具体配置方式详见调度设置                  |
+| 7  | 运维     | 点击进入「运维」中心                                                                                             |
+| 8  | 任务流程说明 | 鼠标悬浮在任务流程的tips上方，显示开发任务的上线流程图。                                                                       |
+| 9  | 集群筛选   | 图中所示的“default”，表示任务执行需要使用的Virtual Cluster，可点击进行切换来选择其它Virtual Cluster 如果要新增Virtual Cluster，可在“计算”中进行操作 |
+| 10 | 运行/停止  | 运行/终止当前节点的代码。运行 SQL 代码时，支持选中部分代码后运行。                                                                   |
+
+#### SQL编辑区
+
+![](.topwrite/assets/43961fb877/daf1fe91a75052ac12b25b198449827de8d56ff5.png)
+
+* schema切换：点击下拉框可切换当前工作空间下的schema，默认使用的public
+* 快捷方式：快捷方式在Studio开发编译区支持的各种能力，具体见其他：常用快捷操作
+* SQL编辑区：Studio开发功能的SQL编译器向用户提供了以下功能用以提升数据开发，数据分析的工作效率
+
+| 功能       | 功能介绍                                        |
+| -------- | ------------------------------------------- |
+| 代码折叠     | 将代码块收起以减少阅读时的干扰                             |
+| 语法错误实时提示 | 编写代码的过程中，及时提示用户发现的语法错误，帮助用户避免出错             |
+| 语法高亮     | 在编辑器或IDE中，使用不同的颜色或字体高亮显示代码中的关键字和语法结构，以增强可读性 |
+| 智能补全     | 根据上下文和已知信息，自动补全代码中的关键字、函数名、变量名等，提高编码效率和精度   |
+| 局部代码执行   | 只运行代码的一部分而非整个程序，以便快速测试小段代码或排除错误             |
+
+### 调度设置
+
+在任务测试完成一切正常后，如果要将该任务定时调度运行，需要配置任务的调度属性，可点击SQL功能区的「调度」按钮。
+
+#### 基本信息
+
+| 参数     | 说明                                                                                                                                         |
+| ------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| 负责人    | 必填。仅限一个成员，默认为任务创建人，可根据实际需要，修改为工作空间下的其他成员。                                                                                                  |
+| 描述     | 非必填，可对任务进行详细描述，方便后续查看和管理。                                                                                                                  |
+| 运行属性   | 必选。正常调度：按照用户设置的调度规则进行调度。 空跑调度：当某任务逻辑暂时无需运行，但又不想改动整个数据链路关系时，可将其设置为空跑，此时该任务会直接置为成功。 暂停：任务设置为“暂停调度”后，发布到运维中心，整个任务的状态为“暂停”状态，不生成任务实例、可以进行补数据操作 |
+| 集群     | 必填。用于定义该任务发布至生产环境调度运行时使用的调度资源组。                                                                                                            |
+| schema | 必填。用于定义该任务发布至生产环境运行时使用的前缀schema                                                                                                            |
+| 任务优先级  | 可选。用于设定Lakehouse SQL任务的调度优先级，支持0-9十个级别，数字越大优先级越高。                                                                                          |
+| 参数配置   | 点击“新增参数”可以新增一个参数 点击加载代码中参数，会自动加载在代码中已经使用的参数 代码中，引用参数的方式为：'${bizdate}' ，注意这里的引号是英文的引号 备注：更多的系统内置参数，会在后续版本中支持                                |
+
+#### 调度时间
+
+![](.topwrite/assets/image_1756191463019.png =379)
+
+| 参数       | 说明                                                                                |
+| -------- | --------------------------------------------------------------------------------- |
+| 调度周期     | 每天调度：选中后该调度每天都会执行。 每月指定天调度：用户可自行选择每月指定的日期执行调度。 每周指定天调度：用户按照周粒度指定具体日期执行。           |
+| 调度频率     | 执行1次：用户选择执行1次后，只需要配置开始调度时间即可。
执行多次：用户选择执行多次后，还需要配置调度间隔时长、开始调度时间、结束调度时间，排除时间设置 |
+| 每次调度间隔时长 | 选择执行多次时，可支持用户自定义每次执行的间隔时长，从1分钟，到12个小时的跨度均支持选择                                     |
+| 开始调度时间   | 每天实例开始执行的时间                                                                       |
+| 结束调度时间   | 每天实例结束执行的时间                                                                       |
+| 排除时间设置   | 若包含了用户设定了排除时间，那么在该时间范围内不会生成相应的周期调度实例                                              |
+| 生效时间     | 任务从哪一天开始生效                                                                        |
+| 失效时间     | 任务从哪一天开始失效                                                                        |
+| 预览调度时间   | 点击预览调度时间，可查看配置调度后具体的运行时间。                                                         |
+
+#### 实例信息
+
+Studio支持**次日生效**、**发布后生效**两种实例生成方式。
+
+| 参数         | 说明                                                                                                          |
+| ---------- | ----------------------------------------------------------------------------------------------------------- |
+| 实例生成方式     | 发布后生效：即时转实例的方式，发布后，会即刻生成当天的任务实例、按照配置的调度时间运 次日生效：在隔天再调度运行任务的实例                                               |
+| 实例遇错重跑     | 实例重跑属性，主要从数据幂等性等考虑，设定任务实例是否可以被重跑。请按需设置。 运行成功或失败后皆可重跑 运行成功后不可重跑，运行失败后可重跑 运行成功或失败皆不可重跑                        |
+| 自动重跑次数     | 自定义重跑次数                                                                                                     |
+| 实例超时时长     | 不开启 自定义
任务的实例运行时间超过设定时长后，则会直接置为失败。取值改动后，只对定时时间在任务提交时间之后的新实例生效                                           |
+| 预览调度时间     | 点击预览调度时间，可查看配置调度后具体的运行时间。                                                                                   |
+| 参数配置       | 点击“新增参数”可以新增一个参数 点击加载代码中参数，会自动加载在代码中已经使用的参数 代码中，引用参数的方式为：'${bizdate}' ，注意这里的引号是英文的引号 备注：更多的系统内置参数，会在后续版本中支持 |
+| 调度等待时长     | 任务实例在到达调度定时时间后，若等待时长超过设定值，且仍处于等待上游任务结束的状态（即未进入运行状态，也未运行结束），系统将直接判定该任务实例运行失败，以防止其长时间不运行、产生调度堆积。              |
+| 延迟运行空跑跳过时长 | 基于任务实例进入运行状态的时间与配置的定时时间之间的差异进行判断。若该差值超过设定时间，择直接进行空跑跳过操作，并将该实例状态置为成功。                                        |
+
+#### 调度依赖
+
+复杂的生产任务，通常存在上下游的依赖关系，比如DWD加工任务需要依赖ODS层任务。在“调度依赖”配置，可以添加当前任务的依赖上游任务。支持的方式有两种：父节点的文件名称、父节点产出的表名
+
+依赖策略：当前支持默认策略、向前依赖、向前就近依赖策略。具体策略对应的实例生成方式可见[任务调度依赖关系](task_scheduling_dependency.md)
+
+![](.topwrite/assets/image_1756191826292.png =660)
+
+#### 任务产出
+
+有两种方式配置任务的产出信息
+
+方式一：通过上文提及的代码自动解析，可自动生成输出表名
+
+方式二：通过搜索表名、手动添加
+
+![](.topwrite/assets/image_1690523641208.png =437)
+
+关于任务调度的更多信息，请参考：[任务调度依赖](task_scheduling_dependency.md)、[任务调度和实例执行方式](f6fc6447ee.md)
+
+### 提交上线
+
+单击编辑器上方功能栏中的**提交上线**按钮，进行提交任务。
+
+### 运维查看
+
+点击跳转至「运维」中心查看任务运维。
+
+## 运行结果
+
+### 运行历史
+
+运行历史提供了当前任务页签下7天内近20条运行结果数据
+
+![](.topwrite/assets/43961fb877/5356056744906f50b383683a6665b649efc6178d.png)
+
+### 运行结果
+
+#### 日志
+
+SQL作业可以根据日志进行诊断，详情请查看[JOB PROFILE](web-job-history.md)
+点击任务运行后，在页面下方的日志区域，可以查看任务运行的详细日志信息
+
+通过展开和收起按钮，可以调整日志展示区域的展开和收起
+
+通过刷新按钮，可对日志进行强制刷新
+
+![](.topwrite/assets/43961fb877/e3e8ee2c80e29d7dc8bcc52df9c14e68564c9cc3.png)
+
+#### 数据
+
+任务运行完成后，对于有结果返回的（比如SELECT语句），会通过“数据”Tab来展示返回的结果：
+
+![](.topwrite/assets/43961fb877/2b76b47e9714fd6d8ae4276a935f173a971296e1.png)
+
+## 其他：常用快捷操作
+
+在代码编辑框中，当前支持如下快捷键来帮助提升编辑效率：
+
+* **保存**
+  * MAC：CMD + s
+  * Windows：Ctrl + s
+* **注释或解除注释光标所在行或代码块**
+  * MAC：CMD + /
+  * Windows：Ctrl + /
+* **剪切光标所在行或代码块**
+  * MAC：CMD + x
+  * Windows：Ctrl + x
+* **复制光标所在行或代码块**
+  * MAC：CMD + c
+  * Windows：Ctrl + c
+* **粘贴**
+  * MAC：CMD + v
+  * Windows：Ctrl + v
+* **批量操作行**
+  * Mac：⇧ + Option
+  * Windows：按住 Shift + Alt

package/bin/skills/lakehouse-doc/references/tencentcloud_arn_and_externalid.md

@@ -0,0 +1,29 @@
+# 获取腾讯云ARN和ExternalID
+
+在配置 Private Link 访问 Lakehouse 网络时，为保障 Lakehouse 能够正常读取您云平台账号内的终端节点状态，并增强该获取方式的安全性，请在云服务平台内创建独立的访问控制角色，并授权及添加 External ID。具体操作如下：
+
+^
+
+## 腾讯云
+
+**获取 ARN 方式**：
+
+您需要在腾讯云访问控制页面（<https://console.cloud.tencent.com/cam/role>）点击“新建角色”，并选择角色载体为“腾讯云账户”：
+
+:-: ![](.topwrite/assets/image_1733066596983.png =383)
+
+“云账号类型”选择“其他主账号”；
+
+在“账号ID”内填入 Lakehouse 页面上显示的 UID；
+
+在“外部ID”选项中勾选“开启校验”，并自定义一串字符用于后续校验。
+
+:-: ![](.topwrite/assets/image_1733066790847.png =660)
+
+在“配置角色策略”中找到“私有网络（VPC）只读访问权限”策略并勾选（Lakehouse 需要通过该角色调用 DescribeVpcEndpoint 和 DescribeVpcEndpointService 接口）；
+
+:-: ![](.topwrite/assets/image_1733067463964.png =665)
+
+定义角色名称，并点击“完成”按钮，完成角色创建。
+
+:-: ![](.topwrite/assets/image_1733067522805.png =675)

package/bin/skills/lakehouse-doc/references/time-function.md

@@ -0,0 +1,67 @@
+### 日期时间格式说明
+
+#### 概述
+
+在处理和展示日期时间信息时，我们通常需要按照一定的格式来组织和格式化这些信息。本文档提供了一套常用的日期时间格式符号，以及它们的含义、格式和示例，以帮助您更好地理解和使用这些符号。
+
+#### 格式符号详解
+
+| 符号 | 描述         | 格式示例       | 示例值        |
+|------|--------------|----------------|---------------|
+| G    | 纪元         | AD; Anno Domini | 公元           |
+| y    | 年           | year           | 2020; 20       |
+| D    | 一年中的第几天 | number(3)     | 189           |
+| M    | 月份         | month          | 7; 07; Jul; July |
+| d    | 月份中的天   | number(2)     | 28            |
+| Q    | 季度         | number/text    | 3; 03; Q3; 3rd quarter |
+| E    | 星期中的天   | text           | Tue; Tuesday   |
+| a    | 上午/下午     | am-pm          | PM            |
+| h    | 12小时制小时  | number(2)     | 12            |
+| K    | 上午/下午小时 | number(2)     | 0              |
+| k    | 24小时制小时  | number(2)     | 0              |
+| H    | 24小时制小时  | number(2)     | 0              |
+| m    | 分钟         | number(2)     | 30            |
+| s    | 秒           | number(2)     | 55            |
+| S    | 毫秒/微秒    | fraction       | 978           |
+| V    | 时区ID       | zone-id        | America/Los_Angeles; Z; -08:30 |
+| z    | 时区名称     | zone-name      | Pacific Standard Time; PST |
+| O    | 本地化时区偏移量 | offset-O      | GMT+8; GMT+08:00; UTC-08:00; |
+| X    | 时区偏移量   | offset-X       | Z; -08; -0830; -08:30; -083015; -08:30:15; |
+| Z    | 时区偏移量   | offset-Z       | +0000; -0800; -08:00; |
+| ''  | 单引号       | literal        | ’              |
+
+#### 符号使用示例
+
+- 年份:
+  - `yyyy`: 四位数年份表示法，例如 2022。
+  - `yy`: 两位数年份表示法，例如 22。
+
+- 月份:
+  - `M`: 单位数月份表示法，例如 3、12。
+  - `MM`: 双位数月份表示法，例如 03、12。
+
+- 当月天数:
+  - `d`: 单位数当月日期表示法，例如 5、20。
+  - `dd`: 双位数当月日期表示法，例如 05、20。
+
+- 小时 (24小时制):
+  - `H`: 单位数24小时制小时表示法，例如 1、23。
+  - `HH`: 双位数24小时制小时表示法，例如 01、23。
+
+- 分钟:
+  - `m`: 单位数分钟表示法，例如 4、59。
+  - `mm`: 双位数分钟表示法，例如 04、59。
+
+- 秒:
+  - `s`: 单位数秒钟表示法，例如 8、59。
+  - `ss`: 双位数秒钟表示法，例如 08、59。
+
+- 毫秒/微秒:
+  - `S`: 支持1-9位数字，表示毫秒（前3位）、微秒（中间3位）和纳秒（后3位）。CZ目前只支持微秒精度，因此解析时间字符串时纳秒会被丢弃，生成时间字符串时纳秒部分则会置零。不足9位时，从右向左降低精度。
+
+#### 示例
+
+以下是一些使用上述符号的日期时间格式示例：
+
+- `yyyy-MM-dd HH:mm:ss.SSSS`: 2022-01-10 10:05:02.1232
+- `yyyy/MM/dd HH:mm:ss.SSSS`: 2022/01/10 10:05:0

package/bin/skills/lakehouse-doc/references/timetravel-summary.md

@@ -0,0 +1,47 @@
+# Time Travel
+
+Time Travel功能可以让您像时间旅行一样访问时间窗口中的任何时间点的数据，包括已更新或删除的数据、恢复已删除的表或恢复已过期的表。通过Time Travel，您可以轻松查看历史版本数据，从而更好地了解数据的变更历史。
+
+![Time Travel示意图](.topwrite/assets/image_1708936936399.png)
+
+如上图所示，表中原来有一条数据，经过insert、update、delete等操作后，共有四个版本。当指定的版本在v0-v1之间时，Time Travel将返回v0的数据。通过指定版本，您可以查看历史版本数据。
+
+## Time Travel功能支持的操作
+
+* 使用undrop命令恢复已删除的表
+* 使用restore命令恢复现有表或dynamic表到指定版本
+* 查询表或dynamic表已更新或删除之前的数据
+* 查看表或dynamic表的版本历史
+* 创建表流（table stream）或使用table\_changes获取表或dynamic表的变化
+
+# Time Travel保留期限设置
+
+Time Travel保留期限决定了您可以访问多久以前的数据。例如，如果Time Travel保留期限设置为7天，那么您可以访问过去7天内的任何时间点的数据。超过7天后，您将无法使用Time Travel访问过期的数据，且数据会被物理删除。
+Lakehouse表的历史状态默认保留周期1天(24小时），您可以通过Time Travel查询1天内的历史版本。请注意如果设置的时间更长存储费用会增加
+
+如需保留更长周期的历史版本，您可以为每个表设置不同的数据保留周期，以满足不同的业务需求。num的设置范围为0-90。
+
+  * ```SQL
+    ALTER TABLE tablename SET PROPERTIES ('data_retention_days'='num');
+    ```
+
+## 恢复删除的对象
+
+请参考[恢复删除数据](UNDROP-TABLE.md)文档，了解如何使用undrop命令恢复已删除的表。
+
+## 恢复数据到指定版本
+
+请参考[RESTORE命令](restore.md)文档，了解如何使用restore命令将现有表或dynamic表恢复到指定版本。
+
+## 查询历史数据
+
+请参考[TIME TRAVEL](TIMETRAVEL.md)文档，了解如何查询表或dynamic表已更新或删除之前的数据。
+
+## 查看对象的版本历史
+
+请参考[DESC HISTORY](desc-history.md)文档，了解如何查看表或dynamic表的版本历史。
+
+## 使用table stream和table\_changes获取表的变化
+
+* 请参考[使用TABLE CHANGES获取数据变化](sql_functions/table_functions/table_changes.md)文档，了解如何使用table\_changes获取表或dynamic表的变化。
+* 请参考[使用TABLE STREAM获取数据变化](tablestream_summary.md)文档，了解如何使用table stream获取表或dynamic表的变化。

package/bin/skills/lakehouse-doc/references/tools_AI.md

@@ -0,0 +1 @@
+^

package/bin/skills/lakehouse-doc/references/tools_BI.md

@@ -0,0 +1 @@
+^