@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,75 @@
+# 入门指南：如何快速配置和使用数据质量规则
+
+## 适用场景
+
+数据质量规则用于校验数据对象的质量是否符合要求，比如数据的正确性、有效性和一致性等，尤其是对于服务于生产使用的任务产出的数据表。如果您配置了ETL流程，比如前文的 [入门指南：如何快速配置编排和周期调度ETL流程](quick_start_etl.md)，计划对数据的质量增加一个检查，建议阅读此指南。
+
+## 前置阅读
+
+在阅读本指南之前，建议完成以下文档的阅读和理解：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+您可以通过 Lakehouse Studio 提供的「数据质量」功能来配置质量规则进行检查。检查主要基于数据质量规则来进行。规则会预先定义校验的对象、检查逻辑和预期结果，并可以通过多种方式触发运行。本示例展示如何为一张 Lakehouse 表的字段配置规则，以校验其取值非空。
+
+### 使用说明
+
+* 具备 `工作空间管理员角色（workspace_admin）` 或 `工作空间开发角色(workspace_dev)` 的用户，有权限使用「数据质量」功能。
+* 「数据质量」功能目前主要用于监控 Lakehouse 的数据对象，比如 Table、View、Volume、Dynamic Table 等，对于 MySQL 等其他数据类型，暂不支持。
+
+### 操作步骤
+
+1. 如下图所示，点击按钮进入 Lakehouse 服务实例：
+
+   ![](.topwrite/assets/image_1748337538227.png)
+
+2. 导航到「数据」>「数据质量」页面：
+
+   ![](.topwrite/assets/image_1749449999835.png)
+
+3. 在“质量规则”Tab页，点击“新建规则”按钮，打开新建质量规则的页面。请注意核对，确保页面右上角的工作空间是需要校验的数据表所在的工作空间。如果不是，可以点击后进行切换。
+   ![](.topwrite/assets/image_1749450019542.png)
+
+4. 在新建规则页面，工作空间的值会自动设定为上一步选择的工作空间【1】。选择需要校验的数据对象。本示例中，选择先前ETL流程中同步任务导入数据写入的 `test_json` 表进行校验【2】。质量规则执行时，实际上会转化为 Lakehouse SQL 语句执行，因此需要一个执行集群。为简单起见，建议直接选择默认的 GP 类型集群 `DEFAULT`【3】。
+   ![](.topwrite/assets/image_1749450038105.png)
+
+5. 配置“校验方式”、“触发方式”并“保存”规则。
+
+   * 校验方式【4】：本示例中我们计划监控 test_json 表中的 c1_id 字段取值非空，所以选择“单值指标取值校验”即可；“指标取值变动校验”会比较两个指标，并校验变化值。产品内置了诸多指标规则，开箱即用。这里选择字段空值数、选定字段名称、期待结果设定为等于0。
+
+   * 触发方式【5】：如字面含义，产品提供定时触发、周期调度任务触发和手动触发三种方式。周期任务触发会与调度系统绑定，在任务调度实例运行完成后即可触发质量规则的执行，能使校验更及时。对于生产场景，推荐使用这种方式。尤其是“强阻塞调度”选项，可以在质量规则校验失败时，阻塞整个调度流程，防止质量问题扩散。选择这种方式时，需要选择绑定的调度任务（即产出该数据表的任务）。
+
+   * 其他配置项保留默认值或留空即可。最后点击“保存”【6】按钮，完成质量规则的新建。
+
+   ![](.topwrite/assets/image_1749450069308.png)
+
+6. 创建完成后，在质量规则列表页面可以看到新增的规则。
+   ![](.topwrite/assets/image_1749450081238.png)
+
+7. 可以点击“试跑”按钮来测试质量规则的配置和校验情况。在“校验结果”Tab页可以查看具体结果，如下图所示：质量规则被触发运行，校验结果与预期一致，一切正常。
+   ![](.topwrite/assets/image_1749450092151.png)
+   ![](.topwrite/assets/image_1749450096317.png)
+
+8. 等待调度任务的定时到达后，观察质量规则触发情况。
+
+   * 在「任务运维」中，通过周期任务实例运行的日志，可以查看质量规则的触发运行情况。
+     ![](.topwrite/assets/image_1749450116093.png)
+
+   * 在「数据质量」的“校验结果”中，可以看到新增的校验记录，触发方式为“周期任务触发”。
+     ![](.topwrite/assets/image_1749450124984.png)
+
+9. 至此，已经完成了质量规则的配置和校验运行情况的观察。在完成数据质量规则配置后，如果需要及时收到质量规则校验失败的监控告警信息，还需进行监控配置，具体操作在此略过，详见 [数据质量](DataQuality.md) 的帮助文档。
+
+## 相关文档
+
+* 您可以阅读 [数据质量](DataQuality.md) 的帮助文档来了解数据质量模块的完整使用指南。
+
+## 下一步建议
+
+* 完成质量规则的配置后，可以参考 [如何快速配置和使用监控告警规则](quick_start_monitoring_and_alerting.md) 的指南文档，对质量规则的校验结果和任务运行状态等，配置监控规则、发送告警。
+
+^

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

@@ -0,0 +1,131 @@
+# 入门指南：如何快速配置编排和周期调度ETL流程
+
+## 适用场景
+
+数仓工程师主要工作之一是构建离线数仓，即创建和维护周期调度ETL流程。本文会概要介绍如何基于 Lakehouse Studio 来配置和编排 ETL 任务，并配置调度属性，使得整个 ETL 流程能够被定时、按照依赖关系调度运行。
+
+## 前置阅读
+
+在阅读本指南之前，建议完成以下文档的阅读和理解：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+在 [入门指南：如何快速创建同步任务来导入数据](quick_start_batch_sync_data.md) 中，我们已经创建了一个数据同步任务。本文档将以示例的方式，继续创建一个 SQL 处理任务，并让其依赖于该数据同步任务，从而构建出一个 ETL 流程，并配置调度定时来定期运行。
+
+### 使用说明
+
+需要具备 `工作空间管理员角色（workspace_admin）` 或者 `工作空间开发角色(workspace_dev)` 权限的用户，才能使用任务开发、提交发布和运维中心的功能。
+
+### SQL任务的创建
+
+1. 通过下图的操作入口，来创建一个 SQL 任务：
+
+   ![](.topwrite/assets/image_1748425848352.png)
+
+2. 在创建任务的弹框中，将任务命名为“SQL_DWS_聚合”，并单独创建一个名为“数据处理”的文件夹。
+
+   ![](.topwrite/assets/image_1748425859150.png)
+
+3. SQL 任务新建好后，如下图所示，在编辑区可以编写具体的 SQL 代码。
+
+   ![](.topwrite/assets/image_1748425869532.png)
+
+4. 前面通过数据同步任务，已经把 MySQL 的数据同步到 Lakehouse 的 test_json 表中。在 SQL 任务中，基于这张表中的数据进行聚合处理，比如把表中的 c2_tinyint_column、c3_smallint_column 两个字段分别求和。导航到“数据” Tab 页，定位到目标表 test_json，然后在操作栏中点击“数据查询”，可以自动将 SELECT 代码模板插入到编辑器中，如下图所示，这有助于提升代码编写效率。
+
+   ![](.topwrite/assets/image_1748425911494.png)
+
+5. 基于上述代码模板修改为所需的处理逻辑，然后保存。此处仅为示意，进行了简化处理，聚合结果未写入新表。
+
+   ![](.topwrite/assets/image_1748425934078.png)
+
+   ```SQL
+        SELECT   SUM(c2_tinyint_column),         
+                 SUM(c3_smallint_column),
+        FROM     test_json;
+   ```
+
+### 任务编排和调度配置
+
+完成同步任务和 SQL 任务的创建后，要构建完整的离线周期处理 ETL 流程，还需要配置调度定时和任务依赖关系。
+
+1. 打开同步任务，通过页面的“调度”按钮，打开调度属性的配置。
+
+   ![](.topwrite/assets/image_1748426012421.png =633)
+
+2. 配置调度时间：配置成每天调度、执行多次、每一个小时调度一次，如下图所示。通过“预览调度时间”可以查看基于配置对应的具体定时时间。
+
+   ![](.topwrite/assets/image_1748426023159.png =722)
+
+   ![](.topwrite/assets/image_1748426030471.png =397)
+
+3. 配置实例信息：这里主要需要配置“实例重跑方式”。由于本任务不存在重跑后产生数据不幂等的问题，可以重跑，因此选择“运行成功或失败，都可以重跑”，其他属性使用默认值即可。
+
+   ![](.topwrite/assets/image_1748426041609.png =386)
+
+4. 配置调度依赖：同步任务是流程中的第一个任务，没有上游依赖，此处留空即可。
+
+   ![](.topwrite/assets/image_1748426049779.png =386)
+
+5. 配置任务产出：任务产出用于描述本任务写入的是哪张表，以便下游任务在消费此表时，能智能识别到对应的上游任务。点击“智能解析”按钮，系统会通过任务配置自动解析出当前任务的产出表并回填到配置中。
+
+   ![](.topwrite/assets/image_1748426056766.png =386)
+
+6. 完成上述调度配置后，点击页面右下角的“确定”按钮将配置保存。回到任务页面，如下图所示，“提交”按钮会变成可点击的状态。
+
+   ![](.topwrite/assets/image_1748426062758.png)
+
+7. 点击“提交”按钮，在弹窗中二次核对信息无误后，再点击确定，同步任务即被提交到生产环境进行定期调度运行。
+
+   ![](.topwrite/assets/image_1748426068998.png)
+
+8. 切换到 SQL 任务，通过页面的“调度”按钮，打开调度属性的配置，需要配置的属性和同步任务相同，即：
+
+      1. 配置成一天调度多次、每小时调度一次。
+      2. 重跑属性配置成“运行成功或者失败，都可以重跑”。
+      3. 请特别注意需要配置 SQL 任务对同步任务的依赖关系。点击页面上的“智能解析”按钮，会自动识别 SQL 任务所依赖的同步任务并自动回填；也可以手动添加。
+      ![](.topwrite/assets/image_1748426078453.png =386)
+
+9. 同上，SQL任务的调度配置完成后，点击页面右下角的“确定”按钮将配置信息保存下来。回到任务页面，点击“提交”按钮把SQL任务也提交做定时调度。
+
+   ![](.topwrite/assets/image_1748426087176.png)
+
+10. 进入“任务运维”查看实际效果，有两种方式进入：
+
+    * 方式一：通过左侧导航 运维监控 > 任务运维
+
+    * 方式二：在任务上直接点击“运维”按钮，可直达运维中心中该任务的详情页，建议使用此方式。
+
+      ![](.topwrite/assets/image_1748426094142.png)
+
+11. 查看任务的详情，如下图所示，和预期一致，SQL任务依赖了同步任务：
+
+    ![](.topwrite/assets/image_1748426100418.png)
+
+12. 点击“任务实例”Tab，可以看到任务对应的具体实例的列表，实例已按照配置的定时时间生成（只生成任务提交时间之后的实例）：
+
+    ![](.topwrite/assets/image_1748426139524.png)
+
+13. 点击实例 ID 可以进入实例的详情页面进行查看。在定时时间到达后，上游的同步任务实例先运行，运行成功后，下游的 SQL 任务实例才会开始运行。实例触发运行需要同时满足两个条件（充分必要条件）：实例自身的定时时间已到达，且上游实例处于运行成功状态。
+
+    ![](.topwrite/assets/image_1748426146577.png)
+
+14. 至此就完成了一个完整的ETL流程的编排构建，并提交进行周期调度、运行。
+
+## 限制说明
+
+* 权限控制：需要具备 `工作空间管理员角色（workspace_admin）` 或者 `工作空间开发角色(workspace_dev)` 权限的用户，才能使用任务开发、提交发布和运维中心的功能。
+
+## 相关文档
+
+* 您可以阅读 [任务开发](ide.md) 的帮助文档来详细了解如何进行任务开发和调度配置。其中 [任务组](task_group.md) 功能提供了一种可视化编排ETL流程的方式，会更加直观，推荐使用。
+* 您可以阅读 [任务和实例运维](task-instance-maintenance.md) 的帮助文档来详细了解如何对任务和实例进行各种运维操作。
+
+## 下一步建议
+
+* 暂无。
+
+^

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

@@ -0,0 +1,93 @@
+# 入门指南：如何快速配置和使用监控告警规则
+
+## 适用场景
+
+如果您配置了ETL流程，比如完成了前文的 [入门指南：如何快速配置编排和周期调度ETL流程](quick_start_etl.md)，计划对任务运行的稳定性和产出的数据质量检查增加监控，并在出现异常时发送告警通知，建议阅读此指南。
+
+## 前置阅读
+
+在阅读本指南之前，建议完成以下文档的阅读和理解：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+Lakehouse Studio的「监控告警」产品模块，提供了一套强大的功能，它允许用户通过系统内置的规则或自定义规则，对任务运行状态等关键指标进行实时监控。一旦检测到异常情况，系统将发送及时的告警通知，帮助您确保数据流的稳定性和可靠性。
+
+### 使用说明
+
+具备 `工作空间管理员角色（workspace_admin）`、`工作空间开发角色(workspace_dev)` 或者 `工作空间运维角色(workspace_sre)` 的用户，可以使用「监控告警」功能。
+
+### 操作步骤
+
+#### 进入监控告警模块
+
+1. 如下图所示，点击按钮进入Lakehouse服务实例：
+   ![](.topwrite/assets/image_1748337538227.png)
+
+2. 导航到「运维监控」>「监控告警」页面：
+   ![](.topwrite/assets/image_1749455648524.png)
+
+#### 使用内置规则
+
+如上文所述，产品内置了全局的监控规则可供选择启用。
+
+1. 如下图所示，主要内置了“周期任务实例运行失败”和“数据质量检测失败”两类监控规则：
+
+   ![](.topwrite/assets/image_1749455660655.png)
+
+2. 点击具体的监控规则，可以查看其详细的配置定义。以“数据质量检测失败-强规则”为例，下图展示了其监控事项、告警通知方式和通知人员等核心信息。
+   ![](.topwrite/assets/image_1749455672982.png)
+
+   * 监控事项：强阻塞调度的质量规则校验失败。
+   * 告警通知：严重等级的规则，按照通知策略的定义（此处不展开，详见相关文档），会通过电话推送告警。
+   * 通知人员：默认会通知给对象责任人。对于数据质量规则，默认通知给规则创建人。
+
+3. 启用内置的全局告警规则和订阅，继续以“数据质量检测失败-强规则”为例：
+   ![](.topwrite/assets/image_1749455707588.png)
+   * 点击“开启”即可启用此规则[1]。按照规则定义，本告警会通知到对象责任人，即质量规则的创建人。
+   * 如果您不是对象责任人（比如不是质量规则的创建人），但也想关注此告警，可以点击“订阅”按钮[2]。
+
+#### 自定义监控规则
+
+内置规则主要从全局维度进行整体监控，方便快速使用。但在实际情况下，对于一些特殊对象，也存在单独配置精细化监控的诉求。这种情况下需要使用自定义监控规则的能力。
+
+下面的示例将展示如何监控特定周期调度任务的实例运行失败并通过电话告警，主要操作步骤如下：
+
+1. 在“监控规则”列表里面，点击“新建规则”按钮。
+   ![](.topwrite/assets/image_1749455842124.png)
+
+2. 在新建规则的弹框中，填写规则的必填信息、保存。
+   * 监控事项：任务实例运行失败。通过过滤项，**选择具体的任务名称**。
+   * 告警通知：等级设定为“警告”，选用“通用通知策略”来发送短信告警。通知人员默认会选择当前操作人。
+     ![](.topwrite/assets/image_1749455860120.png)
+     ![](.topwrite/assets/image_1749455865473.png)
+
+3. 规则创建后，在列表中会展示出一条记录：
+   ![](.topwrite/assets/image_1749455912549.png)
+
+4. 观察监控规则的工作情况。
+
+   * 这里进行一次模拟的错误变更：修改被监控任务的SQL逻辑，使用一个错误字段名，然后提交调度运行，以触发一个调度实例运行失败。
+     ![](.topwrite/assets/image_1749455960285.png)
+     ![](.topwrite/assets/image_1749456300165.png)
+
+   * 任务被调度运行、出现失败后，在「监控告警」中可观察到监控告警规则的工作情况，符合预期：
+     * 在“告警事件”中，可以看到新增了一条告警事件：
+       ![](.topwrite/assets/image_1749456335722.png)
+     * 在“通知历史”中，可以看到具体的告警通知推送情况：
+       ![](.topwrite/assets/image_1749456370821.png)
+
+至此，已经完成了监控告警内置规则和自定义规则的配置和实际工作效果观察。
+
+## 相关文档
+
+* 强烈建议您进一步阅读 [监控告警](monitoring_and_alerting.md) 的帮助文档，以了解监控告警模块的完整使用指南，尤其是进一步理解监控规则、通知策略、告警事件、通知历史等核心概念。
+
+## 下一步建议
+
+* 无
+
+^

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

@@ -0,0 +1,93 @@
+# 入门指南：如何快速运行一条SQL
+
+## 适用场景
+
+Lakehouse 提供了一体化的引擎来支持数据的处理、加工和分析，其开发语言为 SQL。本文概要介绍如何通过Lakehouse Studio的任务开发功能模块快速编写和运行一条SQL语句来进行查询分析。
+
+## 前置阅读
+
+在阅读本指南之前，建议完成以下文档的阅读和理解：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+如果要快速在界面运行一条 SQL，需要使用 Lakehouse Studio 的数据开发模块，有两种方式：
+
+### 方式一：基于样例SQL和样例数据来运行
+
+产品中内置了开箱即用的样例代码和与之配套的样例数据。在页面导航，点击“开发”进入数据开发界面后即可看到 `Tpch_100g` 文件夹下的样例代码，这些样例代码演示了如何基于 Tpch\_100g 样例数据来编写SQL进行快速查询分析，如下图所示：
+
+![](.topwrite/assets/image_1747993124883.png)
+
+双击一个样例代码文件打开后，点击页面右上角的“运行”按钮，即可触发 SQL 的执行。执行完成后，在页面右下方可以查看执行结果和日志。
+
+![](.topwrite/assets/image_1747993372483.png)
+
+^
+
+请特别注意页面右上角的**集群**选项。“集群”是“计算集群”的简称，是 Lakehouse 提供算力的核心概念，可参考 [此文档](virtual-cluster.md) 进行详细了解。工作空间创建后，会默认初始化两个集群：名为 `DEFAULT ` 的通用型集群和名为 `DEFAULT_AP ` 的分析型集群。这两类集群针对不同的作业负载有对应的优化：
+
+* 通用型（GENERAL PURPOSE，简称 GP）：适用于处理离线作业，作业之间共享计算资源，新旧作业采用公平调度方式分配计算资源。适用于周期定时调度任务来处理大批量数据。
+* 分析型（ANALYTICS PURPOSE，简称 AP）：具备多计算实例和自动弹缩功能，适合处理在线和高并发作业。如果您想体验更强的数据查询性能，请选择此类型的集群。此外，AP 集群会对数据进行智能缓存。经过第一次查询后，后续查询的速度会更快。下图展示了这个差异：
+
+  ![](.topwrite/assets/image_1748326696659.png)
+
+^
+
+您也可以通过阅读 [使用样例数据快速开始查询分析](sample-data-using.md)，进一步了解如何基于样例数据进行查询分析。
+
+### 方式二：自己编写SQL并运行
+
+除了使用样例代码和样例数据之外，您也可以自己编写 SQL 并运行。在页面导航栏，点击“开发”进入数据开发界面，在“任务”下，通过新建菜单，选择“SQL脚本”来创建一个 SQL 任务文件。
+
+![](.topwrite/assets/image_1721484292583.png)
+
+在任务文件中，可按以下步骤编写和运行 SQL：
+
+1. 在页面上选择正确的数据 Schema。编写代码时，对于该 Schema 下的表的引用，直接写表名即可；否则，需要使用 `schema.table` 两段式或 `workspace.schema.table` 三段式格式来引用表。通常使用系统默认 Schema 即可。
+
+2. 在代码编辑区域填写需要运行的 SQL。
+
+3. 选择恰当的计算集群类型。对于 ad-hoc 临时查询，或者需要获得更快的查询响应速度，建议选择分析型（AP）集群。通用型（GP）集群适合大批量数据的离线、周期性调度任务的处理分析。
+
+4. 点击左侧的运行按钮或右上角的运行按钮来执行代码。左侧按钮只执行光标所在的代码块。右上角的按钮默认执行全部代码；也可以先选择部分代码，然后点击右上角的运行按钮来执行所选部分。
+
+   ![](.topwrite/assets/image_1721484303315.png)
+
+5. 运行完成后，在页面下方区域可以查看运行结果、耗时和运行日志等信息：
+
+   ![](.topwrite/assets/image_1721484312151.png)
+
+6. 在编辑框编写代码时，也可以切换到“数据”标签页，来快速浏览和使用数据。找到所需使用的表后，在操作菜单中可快速插入表的名称、字段名称，或者直接生成查询样例 SQL：
+
+   ![](.topwrite/assets/image_1721484321409.png)
+
+### 其它常用操作
+
+除了“运行”操作，系统还提供如下图所示的功能：
+
+1. 全局代码检索：通过代码关键字来查找文件
+2. 保存：保存当前文件修改的内容
+3. 格式化：对当前代码进行格式化排版
+4. 版本历史：可以查看文件的历史版本，并支持对比和回滚
+5. 查找：在当前文件内部通过关键字查找代码片段
+6. 快捷键：展示支持的常用快捷键
+
+![](.topwrite/assets/image_1721531293556.png)
+
+## 限制说明
+
+* 权限控制：需要具备 `工作空间管理员角色（workspace_admin）` 或者 `工作空间开发角色(workspace_dev)` 权限的用户，才能使用任务开发功能并运行 SQL。
+
+## 相关文档
+
+* 您可以阅读 [任务开发](ide.md) 来了解如何深度使用任务开发模块提供的详细功能。
+
+## 下一步建议
+
+* [如何快速上传导入本地数据进行分析](quick_start_upload_data.md)
+
+^

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

@@ -0,0 +1,69 @@
+# 入门指南：如何快速上传导入本地数据
+
+## 适用场景
+
+Lakehouse提供了一体化的引擎来支持数据的处理加工分析，以SQL作为开发语言。本文概要介绍如何通过Lakehouse Studio的任务开发功能模块，快速编写和运行一条SQL语句来进行数据的查询分析。
+
+## 前置阅读
+
+在阅读本指南之前，建议完成以下文档的阅读和理解：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+您可以通过Lakehouse Studio界面上提供的「数据上传」功能向Lakehouse的表中添加数据。
+
+### 使用说明
+
+* 适合较小（不大于2GB）的本地文件（CSV、TXT、Parquet、Avro、ORC）直接上传到云器Lakehouse的表中，无需编程实现，方式最简单。
+* 当前仅支持一次上传一个文件。
+* 数据上传功能暂不支持对文件中的struct、map、array这三个数据类型的字段解析。
+* 需要具备 `工作空间管理员角色（workspace_admin）`、`工作空间开发角色(workspace_dev)` 或 `数据分析师（workspace_anylst）` 权限的用户，才能使用数据上传的功能。
+
+### 操作步骤
+
+1. 登录云器Studio账号
+
+2. 在如下地方均可以点击「上传数据」
+
+   * 实例首页
+     ![](.topwrite/assets/image_1747999086635.png)
+   * 开发->数据树
+     ![](.topwrite/assets/image_1749035410382.png)
+   * 数据资产地图
+     ![](.topwrite/assets/image_1749035355497.png)
+   * 数据资产地图->数据管理
+     ![](.topwrite/assets/image_1749035495163.png)
+
+3. 点击后，会有如下弹框。可将本地文件通过拖拽，或者点击浏览本地系统上的文件的方式添加进来。一次只能添加一个文件，且大小不得超过2GiB。您可以使用本样例文件来尝试上传：:attachment[walmart.csv]{src=".topwrite/assets/walmart.csv" size="363.73 kB"}。
+
+   ![](.topwrite/assets/image_1749035813956.png =380)
+
+4. Schema：选择将表创建在某个schema下。
+
+5. 选择表：选择「新建表」并在后方输入新建表名。
+
+6. 集群：当前Schema所在的工作空间下的可用集群。
+
+7. 数据导入方式：支持追加写入，和先清空后写入两种方式导入数据至新建表中。
+
+8. 信息全部确认后，点击“下一步”，系统会基于已上传的文件信息，自动解析出文件中的字段信息，如下图所示。
+   ![](.topwrite/assets/image_1749035692218.png =380)
+
+9. 检查并判断自动解析出来的字段名称和字段类型等信息是否符合预期，确认无误后，点击「确认」即可完成新建表并上传数据的操作。
+   * 若发现字段解析有问题，可通过修改**文件属性**配置项，重新刷新获取自动解析后的字段名称、字段类型等信息。或自行修改字段名称或字段类型。
+   * 注意：修改后的字段类型有可能因与系统解析的不匹配，导致无法上传成功。
+
+## 相关文档
+
+* 您可以阅读 [使用数据上传功能上传数据](upload_data.md) 的帮助文档来了解更多数据上传方式，比如上传数据到已有表中。
+* 您可以阅读 [将数据导入Lakehouse的完整指南](a_comprehensive_guide_to_ingesting_data_into_clickzetta_lakehouse.md) 来了解更多的将数据导入到Lakehouse中的方式。
+
+## 下一步建议
+
+* 完成数据上传之后，可以参考[如何快速运行一条SQL](quick_start_sql_query.md)的指南文档，基于表中的数据进行查询分析。
+
+^

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

@@ -0,0 +1,73 @@
+# 入门指南：如何快速新增和管理用户
+
+## 适用场景
+
+完成产品[注册开通](LoggingIn.md)之后，您将获得一个具备全局最高权限的初始账号，通常称之为“账户管理员”或“管理员”。您可以使用这个账号来访问产品的所有功能。如果您需要与同事协作，并为不同人员创建并分配各自专属的账号，请阅读本指南。否则，可以跳过本文档，直接参考以下指南开始使用产品：
+
+* [如何快速运行一个SQL](quick_start_sql_query.md)
+* [如何快速上传导入数据](quick_start_upload_data.md)
+
+## 前置阅读
+
+在阅读本指南之前，建议您先阅读并理解以下文档：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+
+## 操作指南
+
+1. 登录产品后，您默认会自动进入“管理中心”的“账户主页”，如下图所示：
+
+   ![](.topwrite/assets/image_1747990064729.png)
+
+2. 通过管理中心的左侧导航栏，进入“账户管理 > 用户管理”，即可进入用户管理页面，如下图所示：
+
+   ![](.topwrite/assets/image_1747990075720.png)
+
+3. 点击页面右上角的“新建”按钮，选择“新建用户”，即可开始创建用户账号。
+
+   ![](.topwrite/assets/image_1747990090897.png =297)
+
+   > 备注：“自定义服务用户”是为自动化工具、任务和应用程序使用而创建的身份，无法在页面登录，此处可暂时忽略。如果想了解更多，详见：[服务用户管理](account_user_management.md)
+
+4. 在弹窗中按照页面指引填写必填信息，即可创建新的账号。请注意以下两点：
+
+   * 请记住在此设置的密码，后续需要将用户名和密码提供给该用户使用。
+   * 手机号需要填写该账号使用者的手机号，以便后续的告警消息等能准确地推送给该用户。
+     ![](.topwrite/assets/image_1747990274287.png)
+
+5. 新的用户账号创建好后，需要向该用户提供以下两条信息：
+
+   * 用户名和密码。
+   * 账户登录地址，其格式为：<账户名>.accounts.clickzetta.com。您也可以直接复制下图所示的浏览器地址，发送给该用户。
+
+     ![](.topwrite/assets/image_1747990303813.png)
+
+6. 获得用户名和密码的用户，登录产品后，如需修改初始密码，可通过左侧导航栏进入“账户管理 > 用户管理”页面，找到对应账号，在操作菜单中选择“修改密码”即可。
+
+   ![](.topwrite/assets/image_1747990312625.png)
+
+## 限制说明
+
+* 权限说明：仅具备账户管理员（account_admin）角色的用户，才可以创建和管理用户。该角色有如下标识：
+
+  ![](.topwrite/assets/image_1747990332688.png =446)
+
+## 相关文档
+
+您可以阅读以下文档来了解更多关于管理账户和用户的详细信息：
+
+* [管理账户](ManageAccounts.md)
+* [管理用户](account_user_management.md)
+
+## 下一步建议
+
+* 完成用户账号创建后，您可能需要将该用户添加到工作空间并分配权限，以便其顺利使用产品。可以进一步参考：
+
+  * [如何快速新建和使用工作空间](quick_start_create_workspace.md)
+  * [如何快速管理工作空间下的用户](quick_start_workspace_user.md)
+
+* 如果您想了解Lakehouse Studio完整的产品使用指南，请参考 [Lakehouse Studio完整使用指南](studio_manual.md)
+
+^

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

@@ -0,0 +1,72 @@
+# 使用工作空间构建数据开发环境
+
+## 基本概念
+
+工作空间（workspace）是 Lakehouse 产品中的核心概念之一。它用于组织 Lakehouse 资源对象（如数据对象、计算资源），并提供相对隔离的数据开发、调度任务管理和运维环境。
+
+为了实现一个服务实例内的工作空间既相互隔离，又便于进行数据交换，不同工作空间之间的权限相互隔离：一个服务实例用户需要被某个工作空间的空间管理员角色（workspace\_admin）添加进入该工作空间，才可被授权并使用工作空间内的数据或计算资源。
+
+当一个用户具备某工作空间内的数据对象权限时，可以在其他工作空间对这些数据对象进行跨空间的查询或其他权限范围内的操作。
+
+:-: ![](.topwrite/assets/workspace_1735992503899.png =814)
+
+如上图所示，一个 Lakehouse 服务实例内可以创建多个工作空间。一个服务实例用户可以被同时添加进入多个工作空间，并被授予这些工作空间内对象的权限。
+
+以上图中的对象为例，介绍工作空间的隔离和数据互通方式：
+
+当上图中的用户user\_a同时被加入了工作空间A(workspace\_a)和工作空间B(workspace\_b)，并被授予了A和B两个工作空间的计算集群使用、数据对象查询等所需的权限。那么user\_a在工作空间A内的任务脚本demo\_script\_ws\_a和工作空间B内的任务脚本demo\_script\_ws\_b中执行以下语句均可正常得到查询结果。
+
+```
+select * from table workspace_a.schema_a.table_a limit 10;
+```
+
+而用户user\_b仅被加入了工作空间B(workspace\_b)，并授予了工作空间B内的一系列权限，当执行任务脚本demo\_script\_ws\_b对workspace\_a.schema\_a.table\_a进行查询时，会提示user\_b并不具备该表的select权限。
+
+## 使用场景
+
+一个服务实例（instance）中可以创建多个工作空间，您可以根据自身业务需要选择使用单一工作空间或多个工作空间。单一工作空间有利于管理，更方便对数据资产和计算资源进行统一管理；多个工作空间有利于在多个团队或项目间实现天然的权限、数据和计算资源边界。
+
+## 使用单一工作空间
+
+当您处于以下使用场景时，推荐仅使用默认开通的工作空间作为单一工作空间来使用 Lakehouse：
+
+* **个人或小型团队**：团队人数较少，数据与计算规模也不庞大，希望在同一个环境内进行协作和管理。
+* **单一产品线或业务部门**：只需管理一个业务域的数据与数据处理流程，对数据与访问控制的精细拆分需求相对较低。
+
+服务实例开通后，系统默认会创建一个名为“quick\_start”的工作空间。您可以直接使用此工作空间进行任务开发等工作。
+
+在管控中心的“账户主页”中，点击开通的服务实例，可进入服务实例的首页。
+
+:-: ![](.topwrite/assets/image_1721463116737.png =745)
+
+在服务实例的首页，点击左侧功能菜单中的“开发”、“计算”、“运维监控”等任意功能，页面右上角会列出当前账号具备权限访问的工作空间，支持切换。使用单一工作空间时，默认处于服务实例内仅有的一个工作空间中。此时所有的任务脚本、调度作业都处于该工作空间内。
+
+:-: ![](.topwrite/assets/image_1721463152612.png =743)
+
+## 创建并使用多个工作空间
+
+当您处于以下使用场景时，推荐创建并使用多个工作空间：
+
+* **跨部门或多项目隔离**：当业务部门或项目之间需要数据和资源访问隔离时，可通过多个工作空间实现天然的权限边界。
+* **安全与合规要求高**：金融、医疗、政府机构等对数据安全、合规和可审计性要求很高的行业场景，需要通过强隔离的方式加强数据安全。
+* **不同的计费或预算中心**：如果多个部门或项目分别有独立的预算，则各自独立的工作空间便于进行财务结算和成本追踪。
+
+服务实例的实例管理员（instance\_admin）角色可以创建工作空间。操作方式如下：
+
+进入“管理-工作空间”菜单，在工作空间管理页面中点击“新建空间”，填写所需信息后进行创建。
+
+:-: ![](.topwrite/assets/image_1721463203358.png =794)
+
+^
+
+工作空间的名称一经创建，不允许变更。新的工作空间会默认创建一个名为“public”的 schema，以及 3 个不同类型的计算集群（通用型计算集群、分析型计算集群和同步型计算集群），便于快速在工作空间中开始操作。
+
+新建工作空间的用户会默认被授予这个工作空间的空间管理员（workspace\_admin）角色。
+
+使用多个工作空间时，可在“开发”、“计算”、“运维监控”等功能页面中，通过右上角的工作空间按钮，切换不同工作空间环境进行使用。
+
+:-: ![](.topwrite/assets/image_1736089880260.png =785)
+
+^
+
+一个服务实例用户如需使用某个工作空间中的数据和计算资源，需要被加入该工作空间并被授予相应的权限。这一操作需要具备该工作空间的空间管理员角色（workspace\_admin）用户来执行。更多操作说明请参考“访问控制”-“配置访问控制”中的[工作空间级管理](access-control-configration.md)的相关内容。