@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,259 @@
+# Lakehouse对象命名规则
+
+在Lakehouse中，为了确保元数据（如数据库、表、视图、用户等）的命名一致性和可读性，避免潜在的问题，我们制定了一套命名规则。本文档将详细介绍这些规则，帮助您更好地理解和使用Lakehouse。
+
+## 标识符类型
+
+Lakehouse支持以下类型的标识符命名：
+
+* **常规标识符**：不需要引号，但必须符合特定的命名规则。
+* **双引号标识符**：需要使用双引号（"）包围起来，可以对关键字进行转译。
+* **反引号标识符**：需要使用反引号（\`）包围起来，可以包含任何字符，但不能包含反引号本身。默认是反引号，可以通过设置切换为双引号（set `cz.sql.double.quoted.identifiers=true`）。
+
+## 命名规则
+
+### 常规标识符的命名规范
+
+1. **开头字符**：标识符必须以字母（包括大写A-Z、小写a-z）或下划线（"\_"）作为起始字符。不允许以数字或其他特殊字符开始。
+2. **字符组成**：标识符中只能包含字母、下划线和十进制数字（0-9）。不允许使用其他特殊字符和关键字，如连字符（-）、空格或其他非字母数字字符。
+3. **大小写敏感性**：虽然在创建时可以指定大小写，但元数据在存储时会被解析为小写字符。在Lakehouse中，所有对象的名称都是不区分大小写的。这意味着，"MyTable"和"mytable"会被视为相同的标识符。
+4. **语言限制**：不支持中文字符
+5. **长度限制**： 长度为1～256个字符，WORKSPACE NAME长度限制3～28个字符
+
+以下是几个合法的标识符示例：
+
+```SQL
+my_table
+table1
+table_2
+```
+
+### 反引号标识符
+
+如果在对象命名时加上反引号，则遵循以下规则：
+
+* 允许用户使用关键字。
+* 列名允许特殊字符、中文等。
+
+对于需要使用关键字命名的标识符名称，可以使用双引号或反引号将其包围，例如：
+
+```SQL
+-- 允许数字
+create schema `123`;
+-- 使用关键字作为对象的命名
+create schema `select`;
+-- 列名使用关键字作为对象的命名
+create table my_table(`中文` string)
+```
+
+请注意，反引号都可以用来包围标识符，但在某些情况下，它们的行为可能不同。通常，建议只在必要时才使用反引号。
+
+### 双引号标识符
+
+在SQL的ANSI/ISO标准中，双引号中的标识符（分隔标识符）允许用户使用关键字。Lakehouse也可以兼容此行为。开启后，双引号为分隔符标识符，通过设置`cz.sql.double.quoted.identifiers=true`当前只支持会话级别开启。需要注意的是，如果开启双引号为分隔符标识符后，Lakehouse将不再把双引号括起来的数据认为是一个字符串类型。
+
+```SQL
+"[ ... ]"
+```
+
+**注意事项**
+
+* 如果使用双引号标识符创建对象，则在查询或任何其他SQL语句中引用该对象时，如果是关键字必须完全按照创建时指定标识符，包含双引号。不包含双引号可能会导致错误。
+
+  ```SQL
+   --需要使用关键字作为对象的命名
+   create schema "select"
+  ```
+
+# 各个对象的命名规范
+
+## 实例INSTANCE NAME
+
+|      | 约束       | 约束条件                                    |
+| ---- | -------- | --------------------------------------- |
+| 名字规则 | 命名规则     | 由系统生成，以字母（AZ、az）或下划线（"\_"）开头。大写字符会转成小写。 |
+|      | 长度限制     | 长度为3\~28个字符                             |
+|      | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格           |
+|      | 是否支持中文   | 不支持                                     |
+|      | 是否有保留字   | 无保留字                                    |
+|      | 是否允许重复   | 用户lakehouse的唯一标示                        |
+
+## WORKSPACE
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为3\~28个字符                      |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否有保留字   | 保留字sys                           |
+|         | 是否允许重复   | 在当前实例下不允许重复                      |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 长度不能超过1024个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，允许中间有空格   |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## SCHEMA
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否有保留字   | 有保留字 information\_schema、public  |
+|         | 是否允许重复   | 在当前WORKSPACE下不允许重复不允许和volume 重复  |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9)           |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## TABLE
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否允许重复   | 在当前schema下不允许重复                  |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## VIEW
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否允许重复   | 在当前schema下不允许重复                  |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## VIRTUAL CLUSTER
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否允许重复   | 在当前workspace不重复                  |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## COLUMN
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 支持                               |
+|         | 是否有保留字   | 有保留字                             |
+|         | 是否允许重复   | 在当前表中不允许重复                       |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## VOLUME
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否有保留字   | 有保留字                             |
+|         | 是否允许重复   | 在当前workspace不重复，不允许和schema重复     |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## FUNCTION
+
+|         | 约束       | 约束条件                                       |
+| ------- | -------- | ------------------------------------------ |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写,避免和内建函数重复 |
+|         | 长度限制     | 长度为最大1-256个字符                              |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格              |
+|         | 是否支持中文   | 不支持                                        |
+|         | 是否有保留字   | 有保留字                                       |
+|         | 是否允许重复   | 允许重复，根据传入的参数区分                             |
+| COMMENT | 命名规则     | 以字母或中文开头                                   |
+|         | 长度限制     | 1024字符                                     |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格              |
+|         | 是否支持中文   | 是                                          |
+|         | 是否区分大小写  | 区分                                         |
+
+## ROLE
+
+|             | 约束       | 约束条件                             |
+| ----------- | -------- | -------------------------------- |
+| 名字规则        | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|             | 长度限制     | 长度为最大1-256个字符                    |
+|             | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|             | 是否支持中文   | 不支持                              |
+|             | 是否有保留字   | 有保留角色                            |
+|             | 是否允许重复   | 允许重复                             |
+| COMMENT     | 命名规则     | 以字母或中文开头                         |
+|             | 长度限制     | 1024字符                           |
+|             | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|             | 是否支持中文   | 是                                |
+|             | 是否区分大小写  | 区分                               |
+| ROLE\_ALIAS | 命名规则     | 以字母或中文开头                         |
+|             | 长度限制     | 1024字符                           |
+|             | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|             | 是否支持中文   | 是                                |
+|             | 是否区分大小写  | 不区分                              |
+
+## USER
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否有保留字   |                                  |
+|         | 是否允许重复   | 当前Account不允许重复                   |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+## INDEX
+
+|         | 约束       | 约束条件                             |
+| ------- | -------- | -------------------------------- |
+| 名字规则    | 命名规则     | 以字母（AZ、az）或下划线（“\_”）开头。大写字符会转成小写 |
+|         | 长度限制     | 长度为最大1-256个字符                    |
+|         | 是否支持特殊字符 | 仅包含字母、下划线、十进制数字 (0-9) ，不允许有空格    |
+|         | 是否支持中文   | 不支持                              |
+|         | 是否有保留字   |                                  |
+|         | 是否允许重复   | 当前schema不允许重复                    |
+| COMMENT | 命名规则     | 以字母或中文开头                         |
+|         | 长度限制     | 1024字符                           |
+|         | 是否支持特殊字符 | 含字母、汉字、下划线、十进制数字 (0-9) ，允许有空格    |
+|         | 是否支持中文   | 是                                |
+|         | 是否区分大小写  | 区分                               |
+
+^

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

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

package/bin/skills/lakehouse-doc/references/opensource/travel.md

@@ -0,0 +1,134 @@
+# ClickZetta Travel：数据迁移与SQL转译工具
+
+## 简介
+
+ClickZetta Travel 是由云器研发团队精心打造并开源的一款工具，旨在帮助用户轻松实现从其他数据系统向 ClickZetta Lakehouse 的数据迁移。它提供了一系列强大的功能，包括：
+- 将其他 SQL 方言转译为 ClickZetta Lakehouse 兼容的 SQL。
+- 在源数据系统和 ClickZetta Lakehouse 上分别执行 SQL 并对比结果集。
+- 易于使用的 Web UI，提供直观的操作界面。
+- 命令行工具，支持批量 SQL 迁移。
+
+## 安装与启动
+
+### 安装步骤
+
+1. 确保已安装 Docker。
+2. 通过以下命令获取 ClickZetta Travel 的 Docker 镜像：
+
+```shell
+# 获取镜像
+docker pull clickzetta/clickzetta-travel:dev
+```
+
+3. 在本地创建一个名为 `travel` 的文件夹，用于存放评估所需的配置和数据。
+
+```shell
+mkdir travel
+cd travel
+```
+
+### 启动 Web UI
+
+运行以下命令启动 ClickZetta Travel 的 Web UI：
+
+```shell
+docker run --rm --name cztravel -v $(pwd):/mnt/userdata -p 8501:8501 clickzetta/clickzetta-travel:dev
+```
+
+访问 http://localhost:8501/unify 即可使用 Web UI。
+
+## 使用方法
+
+### Web 页面交互式评估
+
+#### 转译 SQL
+
+1. 在浏览器中打开 http://localhost:8501/unify。
+2. 选择您所使用的数据平台。
+3. 在输入框中填入待转译的 SQL。
+4. 使用快捷键（输入框右下角有提示）或使输入框失去焦点，待输入内容生效后，页面将自动以左右对比的方式展示原始和转译后的 SQL。
+
+![transpile screenshot](travel_screenshot_transpile.png)
+
+#### 执行 SQL 并对比结果
+
+1. 进行数据库连接配置。
+   - 展开页面上的 config template，可以看到配置文件模板。
+   - 将编辑好的配置文件通过页面上传；或直接在宿主机数据目录下新建 conf 子目录，并在此处准备好配置文件，刷新页面后即可从 “select config file” 处选择。
+   - 若配置文件正确，页面将展示连接成功的信息。
+2. 选择校验方式，并点击 Validate 按钮运行 SQL 并校验结果集。
+   - Basic verification：基于有限的基础统计信息校验。
+   - Multidimensional verification：基于丰富的统计信息校验。
+   - Line by line verification：逐行校验。
+
+![validate screenshot](travel_screenshot_validate.png)
+
+### 命令行批量评估
+
+收集待评估的 SQL 语句，将其以一个或多个文件的形式存放到数据目录。当一个文件内包含多个 SQL 语句时，语句间需以分号（;）分隔。
+
+```shell
+# 进入 docker 的命令行环境
+docker exec -it cztravel /bin/bash
+# 切换到数据目录
+cd /mnt/userdata
+```
+
+命令行环境中提供的批量评估命令为 `travel`。该工具：
+- 接受一个或多个内容为以分号分隔的 SQL 的文件。
+- 识别并拆分、编号输入文件中的 SQL 语句，将其转译为 ClickZetta Lakehouse SQL，并在 Lakehouse 上尝试执行这些语句。
+- 产出数据目录，包括评估摘要以及运行数据。运行数据包括执行成功的 SQL 语句、无法转译的 SQL 语句以及智能分类过的执行失败的 SQL 语句。
+- 通过 `travel --help` 可以获取最新的帮助信息。
+
+示例：
+```shell
+root@bce68cf855b8:/mnt/userdata#> travel -c conf/cz_conf.json batch-0906.sql
+
+# 屏显持续输出运行日志，直至最终给出运行摘要
+summary:
+original sql      : 777
+transpiled        : 777, 100.00%
+transpile failed  : 0, 0.00%
+empty or set sql  : 1
+valid for running : 776
+run succeed       : 763, 98.32%
+run failed        : 13, 1.68%
+
+classified failed reasons:
+reason_0        1       submit sql job failed:SQL job execute failed.Error:CZLH-00000:Failed to generate call action, function not found: IN(bin,bin...)->b
+reason_1        2       submit sql job failed:SQL job execute failed.Error:CZLH-22007:DateTimeFormatter: pattern not supported ZONE_OFFSET_X - z : +0000; -08; -0830; -08:30; -083015; -08:30:15;. Detail  taskId 0, vertex name=stg4, vertexId=2023091814422045379827447_48514-V4
+reason_2        2       submit sql job failed:SQL job execute failed.Error:CZLH-22007:DateTimeFormatter: unknown pattern letter: W. Detail  taskId 0, vertex name=stg0, vertexId=2023091814365582826010390_48392-V0
+reason_3        2       submit sql job failed:SQL job execute failed.Error:CZLH-42000:[1,170] Semantic analysis exception - operator not found, string - string
+...
+
+# 2023-10-10_22-24-24 为此次运行产出的数据目录
+# last 符号链接永远指向最后一次运行的数据目录
+root@bce68cf855b8:/mnt/userdata#> ls -l
+total 18408
+drwxr-xr-x@ 36 robert  staff   1.1K 10 10 22:48 2023-10-10_22-24-24/
+-rw-r--r--@  1 robert  staff   9.0M 10 10 22:22 batch-0906.sql
+drwxr-xr-x@  6 robert  staff   192B 10  8 19:03 conf/
+lrwxr-xr-x@  1 robert  staff    19B 10 10 22:48 last@ -> 2023-10-10_22-24-24
+
+# 数据目录结构示意如下，可以从宿主机直接浏览并处理其中的数据
+robert@Roberts-MBP ~/D/travel> tree last
+last/
+├── log.txt # 全部执行日志
+├── reason_0
+├── reason_1
+│   ├── run.452.clickzetta.sql # 第 452 号 SQL 在 Lakehouse 的执行内容
+│   ├── run.452.doris.sql      # 第 452 号 SQL 的原始信息
+│   ├── run.776.clickzetta.sql
+│   └── run.776.doris.sql
+├── reason_2
+...
+├── success # 执行成功的 SQL，可以后续用于压测
+└── summary.txt # 摘要
+
+# .clickzetta.sql 文件中记录了 Lakehouse 执行的转译的 SQL 内容、job id、失败的原因等信息
+robert@Roberts-MBP ~/D/travel> cat last/reason_1/run.452.clickzetta.sql
+WITH dt AS (SELECT ... DATE_FORMAT(`t1`.`created_at`, '%x') AS p, ... LIMIT 1000
+
+-- exception for job_id: 2023091814422045379827447
+-- submit sql job failed:SQL job execute failed.Error:CZLH-22007:DateTimeFormatter: pattern not supported ZONE_OFFSET_X - z : +0000; -08; -0830; -08:30; -083015; -08:30:15;. Detail  taskId 0, vertex name=stg4, vertexId=2023091814422045379827447_48514-V4
+```

package/bin/skills/lakehouse-doc/references/operation-maintenance.md

@@ -0,0 +1,172 @@
+## 任务运维和实例运维
+
+
+运维中心提供对任务和实例运维管理操作。运维中心管控的任务包含手动触发执行的任务和周期调度的任务，及其对应的实例，进行集中式管理。
+
+
+
+
+### 任务运维
+#### 任务列表
+在左侧导航点击“任务运维”，即可进入任务列表页面。在任务列表，会提供当前开通的服务下、所有工作空间中的任务的汇总展示。
+![](.topwrite/assets/image_1668864727926.png)
+
+
+##### 任务列表内容
+在列表中可以查看任务名称、任务ID、工作空间、任务状态、任务类型等关键属性。
+
+
+##### 任务列表的操作
+在任务列表，选中单个或者多个任务，可以进行快速运维操作
+![](.topwrite/assets/image_1668864740236.png)
+单个任务
+- 暂停
+  - 对于处于非暂停状态的任务才可操作。操作后，会把任务的调度属性设置为“暂停调度”，即不再生成、运行任务实例
+- 启动
+  - 对于处于暂停状态的任务才可操作。操作后，会把任务的调度属性恢复为“正常调度”，即生成、运行任务实例
+- 删除
+  - 操作任务从运维中心下线，让任务退回到文件“未提交”的状态
+多个任务，批量操作
+- 批量启动
+  - 批量操作选中的任务，恢复任务的调度属性为“正常调度”
+- 批量暂停
+  - 批量操作选中的任务，把任务的调度属性设置为“暂停调度”
+
+
+##### 任务列表过滤
+在任务列表的上方，可以按照需要，根据任务的属性进行过滤。
+- 更多筛选
+  - 点击后可展开更多的筛选条件
+![](.topwrite/assets/image_1668864750584.png)
+- 重置筛选
+  - 点击后重置、清除当前所有给定的筛选条件
+- 刷新
+  - 根据给定的条件，刷新重新获取列表
+
+
+#### 任务详情
+从任务列表中，点击任务名称的链接，可以进入到该任务的详情页面。本页面中可以查看基本信息、上下游依赖关系图、任务实例和代码。
+
+
+##### 基本信息
+在此区域，可查看任务的基本信息。
+![](.topwrite/assets/image_1668864765633.png)
+
+
+##### 依赖关系图
+在依赖关系图上，可以查看当前任务依赖的直接一级上游任务，以及被依赖的直接一级下游任务。
+- 搜索
+  - 通过给定任务名称或者任务ID的关键字，可以在图上快速检索定位到任务节点。使用的匹配方式是“包含”
+- 刷新
+  - 点击后重新加载整个依赖关系图
+![](.topwrite/assets/image_1668864772611.png)
+
+
+##### 任务实例
+在任务实例区域，会展示当前任务生成的全部任务实例，所有时间范围。
+![](.topwrite/assets/image_1668864779204.png)
+对于单条任务实例，可以进行基本的管控操作：
+- 停止
+  - 对于未运行的实例，可操作停止
+- 重跑
+  - 对于运行达到终态的实例，可以操作重跑，即将该实例重新运行一次
+代码
+节点代码区域展示当前任务的最新版本的代码。
+![](.topwrite/assets/image_1668864785641.png)
+
+
+##### 任务操作
+在任务详情页，可以对本任务进行暂停、启动、删除操作，含义和作用与在列表中提供的操作相同。
+- 暂停
+  - 对于处于非暂停状态的任务才可操作。操作后，会把任务的调度属性设置为“暂停调度”，即不再生成、运行任务实例
+- 启动
+  - 对于处于暂停状态的任务才可操作。操作后，会把任务的调度属性恢复为“正常调度”，即生成、运行任务实例
+- 删除
+  - 操作任务从运维中心下线，让任务退回到文件“未提交”的状态
+
+
+### 实例运维
+#### 实例列表
+在左侧导航点击“实例运维”，即可进入实例列表页面。在实例列表，会提供当前开通的服务实例下、所有工作空间中的任务实例的汇总展示。
+![](.topwrite/assets/image_1668864794756.png)
+
+
+##### 实例列表内容
+在列表中可以查看实例ID、对应任务名称、实例类型、工作空间、实例状态、计划时间、执行时间和完成时间等关键属性。
+
+
+##### 实例列表过滤
+在实例列表的上方，可以按照需要，根据任务的属性进行过滤。
+- 更多筛选
+  - 点击后可展开更多的筛选条件
+![](.topwrite/assets/image_1668864807533.png)
+- 重置筛选
+  - 点击后重置、清除当前所有给定的筛选条件
+- 刷新
+  - 根据给定的条件，刷新重新获取列表
+
+
+##### 实例列表操作
+在实例列表，选中单个或者多个任务实例，可以进行快速运维操作
+![](.topwrite/assets/image_1668864815341.png)
+单个任务实例
+- 暂停
+  - 对于处于非暂停状态的任务实例才可操作。操作后，会把任务实例的调度属性设置为“暂停调度”，即不再调度运行该任务实例。
+- 恢复
+  - 对于处于暂停状态的任务实例才可操作。操作后，会把任务实例的调度属性恢复为“正常调度”，即按照设定的调度时间来运行任务实例。
+- 终止
+  - 对于运行中的任务实例才可以操作。操作后，会终止任务实例的运行、把任务实例状态置为失败。
+- 重跑
+  - 对于运行完成的任务实例才可以操作。操作后，会重新运行该任务实例。
+- 置成功
+  - 对于运行失败的任务实例才可以操作。操作后，强制将该任务实例置为成功。可用于紧急运维场景，在判断当前任务实例即使失败，也不影响下游任务的数据正确性的前提下，解除对下游任务实例运行的阻塞。
+多个任务实例，批量操作
+- 暂停
+  - 同单条操作。需要注意对于处于非暂停状态的任务实例才可操作。
+- 恢复
+  - 同单条操作。需要注意对于处于暂停状态的任务实例才可操作。
+- 终止
+  - 同单条操作。需要注意对于运行中的任务实例才可以操作。
+- 重跑
+  - 同单条操作。需要注意对于运行完成的任务实例才可以操作。
+- 置成功
+  - 同单条操作。需要注意对于运行失败的任务实例才可以操作。
+
+
+
+
+#### 实例详情
+从实例列表中，点击实例ID的链接，可以进入到该任务实例的详情页面。本页面中可以查看基本信息、上下游依赖关系图、任务实例和代码。
+
+
+##### 基本信息
+在此区域，可查看任务实例的基本信息。
+![](.topwrite/assets/image_1668864827160.png)
+
+
+##### 依赖关系图
+在依赖关系图上，可以查看当前任务实例依赖的直接一级上游任务实例，以快速判断当前任务实例是否可以被正常调度。
+- 搜索
+  - 通过给定任务名称或者实例ID的关键字，可以在图上快速检索定位到任务实例节点。使用的匹配方式是“包含”
+- 刷新
+  - 点击后重新加载整个依赖关系图
+![](.topwrite/assets/image_1668864833952.png)
+  
+##### 代码
+代码区域会展示当前任务实例，运行时使用的对应版本的代码。请注意，这里不一定是当前任务的最新版本代码。
+![](.topwrite/assets/image_1668864841562.png)
+
+
+##### 执行日志
+执行日志区域，会展示当前实例执行的全部日志。包含任务实例被重跑后产生的日志。点击列表左侧的+图标，可以展开查看详细内容。
+![](.topwrite/assets/image_1668864848251.png)
+
+
+##### 操作日志
+执行日志区域，会展示对当前实例操作的记录。
+![](.topwrite/assets/image_1668864855135.png)
+
+
+##### 实例操作
+在任务实例详情页，可以对本任务实例进行暂停、恢复、终止、重跑、置成功操作，含义和作用与在列表中提供的操作相同。
+

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

@@ -0,0 +1,39 @@
+# 创建 Volume 访问阿里云 OSS 数据：
+
+## 前提条件
+
+在连接阿里云的 STORAGE CONNECTION 创建完成之后，就可以创建 Volume 对象访问对象存储数据了。
+
+## 创建 Volume 对象
+
+```SQL
+
+CREATE EXTERNAL VOLUME sh_image_volume
+    LOCATION 'oss://{bucket_name}/{path_to_data}'
+    USING CONNECTION sh_oss_conn_public
+    DIRECTORY = (
+        enable=true,
+        auto_refresh=true
+    )
+    RECURSIVE=true;
+```
+
+####
+
+#### 2. 查看已创建 Volume 对象的详细信息
+
+```SQL
+DESC VOLUME sh_image_volume
+```
+
+#### 3. 查看创建 Volume 路径下的文件
+
+```SQL
+SHOW VOLUME DIRECTORY sh_image_volume;
+```
+
+#### 4. 在 Lakehouse Studio 中展示Volume 路径下的图片
+
+当在 Lakehouse Studio 开发界面，通过 [get\_presigned\_url](GET_PRESIGNED_URL.md)` `函数获取图片的访问 url 时，可以直接点击 url -> **预览** 直接打开图片：
+
+![](.topwrite/assets/20240103-102225.jpeg =726)