@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,67 @@
+# 入门指南：如何快速管理工作空间下的用户
+
+## 适用场景
+
+如果您已经了解工作空间的概念，并且需要和其他用户基于工作空间进行协作，请阅读此文档。如果您只是独立使用，可跳过此文档，直接参考如下指南开始使用产品：
+
+* [如何快速运行一个SQL](quick_start_sql_query.md)
+* [如何快速上传导入数据](quick_start_upload_data.md)
+
+## 前置阅读
+
+在阅读本指南之前，建议先阅读并理解以下文档：
+
+* [Lakehouse 产品简介](what_is_clickzetta_lakehouse.md)
+* [产品基本概念](Key_Concepts.md)
+* [Lakehouse Studio 快速导览](LakehouseStudioTour.md)
+* [入门指南：新建和使用工作空间](quick_start_create_workspace.md)
+
+## 操作指南
+
+1. 如下图所示，点击按钮进入 Lakehouse 服务实例：
+
+   ![](.topwrite/assets/image_1747991184372.png)
+
+2. 导航到“管理 > 工作空间”页面
+
+   ![](.topwrite/assets/image_1747991595948.png)
+
+3. 点击工作空间名称，进入详情页面。在此页面可以看到工作空间下已有的成员用户和已定义的角色。工作空间的创建者会被默认添加为成员并被授予 `workspace_admin` 角色。
+
+   ![](.topwrite/assets/image_1747991623831.png)
+
+4. 点击“添加用户”，选择已存在的其他用户加入工作空间。如果用户尚未创建，可以参考此文档创建用户后再进行添加：[入门指南：如何快速新增和管理用户](quick_start_user_management.md)
+
+5. 选择用户后，为确保该用户具备使用功能的必要权限，建议使用“添加用户并授予角色”操作选项：
+
+   ![](.topwrite/assets/image_1747991688907.png)
+
+6. 按照界面文案的描述选择合适的角色。如果希望用户在工作空间内能够开发、运行任务，建议分配`workspace_dev`角色即可。点击“授予角色”或相应按钮完成整个添加和授权流程。
+
+   ![](.topwrite/assets/image_1747991697185.png)
+
+7. 在工作空间详情页面，可查看到刚才添加的用户和授予的角色。
+
+   ![](.topwrite/assets/image_1747991704056.png)
+
+## 限制说明
+
+* 权限控制：需要具备工作空间管理员角色的用户，才能进行添加用户和授予角色的操作。
+
+## 相关文档
+
+* [工作空间](workspace-introduction.md)
+
+* 若想了解更多关于角色和权限的内容，请阅读以下文档：
+
+  * [角色](roles.md)
+  * [内置角色权限点](permissions-of-built-in-workspace-level-roles.md)
+
+## 下一步建议
+
+完成上述操作后，该用户在工作空间内即具备相应权限，可使用相关功能。建议引导该用户阅读如下指南来开始使用：
+
+* [如何快速运行一个SQL](quick_start_sql_query.md)
+* [如何快速上传导入数据](quick_start_upload_data.md)
+
+^

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

@@ -0,0 +1,249 @@
+# 数据分享
+
+## 1. 概述
+
+### 什么是数据分享（Data Share）
+
+数据分享是云器 Lakehouse 提供的 **无复制** 数据共享功能，可在同一服务区域内实现 **跨账户或跨服务实例** 的数据授权与使用。与传统的数据复制或导入方案不同，数据分享不需要在企业间手动搭建数据同步链路，而是通过“授权”方式直接提供对源数据的只读访问，且实时更新。
+
+### 应用场景
+
+* **实时共享场景**：A 企业将自身数据（例如交易日志、用户行为数据）实时共享给 B 企业，B 企业不需要做数据同步即可实时查询更新数据。
+* **多方协作分析**：多家合作方基于同一份实时数据进行分析、挖掘，减少重复存储和传输成本。
+* **数据提供商与数据消费者模式**：数据提供方希望将部分数据开放给合作伙伴，合作伙伴无需承担存储成本即可获得只读数据，用于自有的 BI 分析或产品集成。
+
+### 本文案例
+
+本文将以 **A 企业**（数据提供方）和 **B 企业**（数据接收方）为例，介绍以下操作：
+
+1. **A 企业创建 Data Share 并分享数据**：A 企业在自身数仓中拥有Brazil\_Commercial的电商数据，希望将脱敏后的数据纳入到 Data Share 中，指定分享给 B 企业。
+2. **B 企业接收并提取 Data Share 中的数据**：B 企业在自己的云器 Lakehouse 实例中，收到A企业的分享并创建对应的 schema 来提取共享数据。
+3. **B 企业使用提取的数据关联 BI 应用，制作报表**：B 企业基于 Data Share 提取出来的只读数据进行分析，在 BI 工具中制作报表。
+4. **A 企业写入数据，B 企业的报表实时获取数据变更**：由于 Data Share 无复制且实时，A 企业对数据所做的更新可以在 B 企业第一时间可见。
+
+***
+
+## 2. A 企业创建数据分享并指定企业B进行接收
+
+以下示例中，A 企业有物流情况表rpt\_brazil\_ec，其中包含所有销售方所有产品的物流状态。B企业是A企业其中的一个销售方（seller），A企业需要向B企业提供其销售产品的物流状态，以便B企业使用这些数据做BI看板，分析和跟踪物流状态。为此，A 企业将对 rpt\_brazil\_ec进行数据过滤，创建一个仅包含B企业数据的视图 `sub_rpt_brazil_ec_05e107217c7266362fd44b75b2cd4cc4`，并将该视图分享给企业B。
+
+### 2.1 创建视图
+
+因物流情况表rpt\_brazil\_ec中包含所有销售方的数据，出于数据安全考虑，不可将所有数据提供给B企业。所以需要先创建一个视图，仅包含B企业的数据，并仅分享这个视图。
+
+表rpt\_brazil\_ec中包含销售方ID字段：seller\_id，以这个字段作为过滤条件创建以下视图：
+
+```
+--为share创建独立的schema，便于后续管理和维护
+CREATE SCHEMA seller_data_share;
+​
+--创建视图，这里假设企业B的seller_id为05e107217c7266362fd44b75b2cd4cc4
+CREATE    VIEW seller_data_share.sub_rpt_brazil_ec_05e107217c7266362fd44b75b2cd4cc4 AS
+SELECT    *
+FROM      rpt_brazil_ec
+WHERE     seller_id = '05e107217c7266362fd44b75b2cd4cc4';
+```
+
+### 2.2 创建数据共享并分享给指定企业B
+
+#### Web 界面操作
+
+**1）创建数据分享**
+
+* 使用具备“实例管理员”（`instance_admin`）角色的账号登录云器 Lakehouse 控制台。
+* 左侧导航选择“数据” → “数据分享”，点击“+新增分享”。
+
+:-: ![](.topwrite/assets/image_1740388043727.png =742)
+
+* 在弹窗中填写分享名称（如 shipping\_detail），选择待分享数据所在的工作空间。
+* 注意，待分享数据需在同一个工作空间内。如果数据本身分布在多个工作空间，可以在一个工作空间内创建其他空间待分享数据的视图，以集中所有待分享数据到同一工作空间。
+
+:-: ![](.topwrite/assets/image_1740388342928.png =438)
+
+**2）添加要分享的数据对象**
+
+继续在新建分享的弹窗中，点击“添加”，选择要分享的对象。如下图，在ql\_ws空间下找到上文创建的schema：seller\_data\_share，勾选其中的视图：seller\_data\_share.sub\_rpt\_brazil\_ec\_05e107217c7266362fd44b75b2cd4cc4
+
+点击“完成”后，该视图即被纳入分享列表。
+
+:-: ![](.topwrite/assets/image_1740388392799.png =537)
+
+^
+
+**3）配置接收实例**
+
+在同一个弹窗中，点击“接收实例”下方的“添加”按钮，输入 B 企业的云器 Lakehouse “服务实例名称”（需要B企业提供，在其登陆服务实例后的首页右上方），并点击完成。
+
+:-: ![](.topwrite/assets/image_1740388438814.png =531)
+
+^
+
+**4）完成数据分享创建**
+
+完成上述所有内容填写后，点击“确定”按钮，即完成数据分享对象的创建，并指定分享给了企业B的Lakehouse服务实例。
+
+后续还可对该数据分享进行编辑，增减需要分享的数据对象，或增减接收此数据的Lakehouse服务实例（比如需要给B企业的其他服务实例）。
+
+**5）查看或管理分享对象**
+
+创建完成后，可以在“数据分享” → “我分享的”列表中看到刚创建的数据分享对象。
+
+:-: ![](.topwrite/assets/image_1740390203623.png =718)
+
+^
+
+#### SQL 操作
+
+若更偏好 SQL 操作，则请使用具备 “实例管理员”（`instance_admin`）角色的账号，在 A 企业的工作空间（如 `ql_ws`）下执行以下操作：
+
+**1) 创建 Share**
+
+```
+CREATE SHARE shipping_detail;
+```
+
+**2) 将视图纳入 Share**
+
+```
+--注意，select赋予接收者查询数据的能力，read metadata赋予接收者可见这个view对象的能力，两个权限点均需要授予。
+GRANT SELECT, READ METADATA ON VIEW seller_data_share.sub_rpt_brazil_ec_05e107217c7266362fd44b75b2cd4cc4 TO SHARE shipping_detail;
+```
+
+**3) 配置分享目标实例**
+
+```
+ALTER SHARE shipping_detail ADD INSTANCE '<替换为B企业的instance_name>';
+```
+
+其中需要由 B 企业提供其Lakehouse服务实例的名称。此操作后，B 企业将立即获得share shipping\_detail的使用权，并可从其中提取view：seller\_data\_share.sub\_rpt\_brazil\_ec\_05e107217c7266362fd44b75b2cd4cc4
+
+的只读访问权限。
+
+> 完成以上步骤后，A 企业即已成功将过滤后的数据通过数据分享功能分享给 B 企业。
+
+##
+
+### 2.3 B 企业接收并提取 Data Share 中的数据
+
+在完成 A 企业分享后，B 企业需要在自己的云器 Lakehouse 实例中“接收并提取”分享数据，才能在查询中使用到该视图对象。
+
+#### Web 界面操作
+
+**查看分享给我的对象**
+
+登录 B 企业的云器 Lakehouse 控制台，使用具备“实例管理员”或“工作空间管理员”角色的账号。
+
+左侧导航选择“数据管理” → “数据分享”，切换到“分享给我”页签，即可看到 A 企业分享过来的 shipping\_detail。
+
+^
+
+**提取数据**
+
+在 shipping\_detail 卡片下方点击“提取”按钮。
+
+弹窗中选择“源 schema”（一个数据分享中可能包含多个schema，需要指定schema进行数据提取），以及想要将共享数据落到 B 企业服务实例下的哪个工作空间及对应 schema。
+
+注意，这里会根据填写的schema名称新建对应的schema，且该schema为只读，不可在此schema下创建其他table或view等数据对象。
+
+完成填写后，点击“确定”按钮，系统会在 B 企业的指定工作空间中新建只读 schema，并映射到 A 企业分享的对象。
+
+^
+
+**完成提取后**
+
+B 企业可以在“数据目录”或“开发”功能的“数据”页签中，看到对应的新 schema，并看到view：sub\_rpt\_brazil\_ec\_05e107217c7266362fd44b75b2cd4cc4。
+
+可像使用本地数据对象一样，对view中的数据进行查询操作。
+
+^
+
+### 2.4 SQL 操作
+
+如果使用 SQL提取share中的数据，在 B 企业的工作空间中执行以下命令：
+
+**查看分享对象**
+
+```SQL
+SHOW SHARES;
+```
+
+可查看到 `INBOUND` 类型的，名称为shipping\_detail 的数据分享，来自 A 企业的服务实例。
+
+**查看shipping\_detail中有哪些数据**
+
+```
+DESC SHARE shipping_detail;
+```
+
+^
+
+**创建本地 Schema**&#x20;
+
+```
+CREATE SCHEMA b_workspace_share_schema FROM SHARE A_instance_name.shipping_detail.share_demo;
+```
+
+其中 `A_instance_name`、`share_demo` 以及源 schema 名可通过 `SHOW SHARES;` 和 `DESC SHARE share_demo;` 查询到。
+
+`b_workspace_share_schema` 为在 B 企业工作空间中新建的只读 schema 名称，可自定义。
+
+^
+
+***
+
+## 4. B 企业使用提取的数据关联 BI 应用制作报表
+
+B 企业提取并成功创建了只读 schema 后，即可在任意兼容云器 Lakehouse 的 BI 工具或 SQL 工作台中，对 `orders_view` 进行查询或关联分析。例如：
+
+```
+SELECT 
+    order_id,
+    customer_id,
+    order_amount,
+    order_status
+FROM b_workspace_share_schema.orders_view
+WHERE order_status = 'COMPLETED';
+```
+
+* **关联外部数据**：可将 `orders_view` 与 B 企业内部自有数据表进行关联（`JOIN`）分析。
+* **数据建模**：可在 BI 工具中将 `orders_view` 作为数据源进行数据可视化与报表制作。
+
+此时，B 企业已经不需要关心数据是否实时同步——Data Share 保证了当 A 企业源数据更新时，B 企业查询到的就是最新的数据。
+
+***
+
+## 5. A 企业在 Data Share 中写入数据，B 企业报表实时查询变更
+
+当 A 企业往 `orders_view` 对应的底层表 `orders` 插入新数据，或者更新现有订单数据时，Data Share 会自动将变更后的数据实时暴露给 B 企业。B 企业无需额外操作，即可在 SQL 查询或 BI 报表中看到最新结果。
+
+示例：A 企业执行以下语句更新订单状态，B 企业在其已有的报表中就能立即看到状态更新后的记录。
+
+```
+-- A 企业在 workspace_a 中执行
+UPDATE orders
+SET order_status = 'SHIPPED'
+WHERE order_id = 10001;
+```
+
+B 企业通过之前的 BI 报表或下列 SQL 查询，实时获取最新状态：
+
+```
+-- B 企业执行
+SELECT 
+    order_id,
+    order_status
+FROM b_workspace_share_schema.orders_view
+WHERE order_id = 10001;
+```
+
+***
+
+## 总结
+
+通过以上 5 步操作，您可以在云器 Lakehouse 平台上实现类似 Snowflake Data Sharing 的实时数据共享。Data Share 最大的特点在于：
+
+* **无复制、低延迟**：无需在企业间重复存储或定期同步，数据变更可以实时传播给消费方。
+* **数据安全可控**：数据仅以“只读”形式分享，且随时可通过权限管控移除共享对象。
+* **易于扩展**：通过 View 可以灵活过滤数据列或行，实现精细化的分享控制。
+
+^

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

@@ -0,0 +1,271 @@
+# 为团队快速搭建 Lakehouse 数据开发环境
+
+## 概述
+
+本文档旨在帮助您在最短时间内搭建一套可供团队共同使用的 Lakehouse 数据开发环境，环境中包括多个可登录并进行数据开发的用户身份，不同用户身份被授予不同的数据权限和角色，以保证必要的权限管控、资源配置和协作便利性。
+
+:-: ![](.topwrite/assets/lakehouse-data-sharing-new.svg =721)
+
+## 1. 准备工作
+
+1. **开通云器账号**
+
+   如果您还没有云器账号，可以前往 [云器官网](https://www.yunqi.tech/) 注册获取。开通注册方式可参考[开通使用](setup.md)。
+
+2. **创建Lakehouse服务实例**
+
+   您需要至少已创建一个Lakehouse服务实例。如还未开通服务实例，可参考：[开通使用](setup.md)中的“创建Lakehouse服务实例”说明进行操作。
+
+3. **拥有 Lakehouse服务实例的instance\_admin(实例管理员) 角色**
+
+   Lakehouse 的权限管理是基于角色（Role）的，创建Lakehouse服务实例的用户会默认具备该服务实例的instance\_admin（实例管理员）角色。
+
+## 2. 搭建完成后
+
+按照后续章节完成环境搭建后，您将得到以下环境：
+
+1. 一个Lakehouse服务实例下的独立工作空间；
+2. 多个可用的用户身份，并具备在工作空间下进行数据开发的权限；
+3. 一个SQL任务，并可提交为周期运行。
+
+***
+
+## 3. 操作步骤
+
+### 3.1 创建用户
+
+注册云器账户时，会默认创建该账户下的第一个用户，并具备账户下所有的操作权限。当团队中多人共同使用Lakehouse进行开发时，使用多个用户身份并区分权限，可以有效对数据和资源进行管理，增强安全性、降低操作冲突的风险，并能有效审计和追溯个人操作。
+
+为达到上述管理目的，需要为每个开发人员或每个集成服务创建独立的用户，以便为后续分配相应角色做准备。
+
+使用注册云器账户时的默认用户[登录](https://accounts.clickzetta.com/login)云器产品，进入管理中心页面，并切换至“用户管理”功能：
+
+:-: ![](.topwrite/assets/quickstart_team_p1.png =801)
+
+^
+
+点击右上角的“新建”按钮，选择“新建用户”，这里分别创建2个用户：developer 和 analyst，如下所示：
+
+:-: ![](.topwrite/assets/quickstart_team_p2.png =361)
+
+^
+
+:-: ![](.topwrite/assets/quickstart_team_p3.png =360)
+
+创建成功后，可以在用户管理的用户列表中看到这两个用户。
+
+### 3.2 创建工作空间
+
+在Lakehouse中，工作空间用于隔离计算资源和数据，形成相对独立的数据开发环境，避免资源冲突或误操作数据。开通Lakehouse服务实例后，系统会默认创建一个名为quickstart的工作空间（workspace）。这里为了完整介绍团队使用方式，我们创建另外一个工作空间：dev\_envirment：
+
+仍然使用注册账户时创建的用户登录，并在管理中心点击已开通的服务实例名称，进入服务实例首页。
+
+:-: ![](.topwrite/assets/quickstart_team_p4.png =797)
+
+^
+
+在服务实例首页中，依次点击左侧菜单中的“管理”-”工作空间“，进入工作空间管理页面。点击右上角的”+ 新建空间“按钮：
+
+:-: ![](.topwrite/assets/quickstart_team_p5.png =774)
+
+^
+
+在弹窗中输入工作空间的名称，点击“确定”，完成工作空间创建：
+
+:-: ![](.topwrite/assets/quickstart_team_p6.png =382)
+
+^
+
+:-: ![](.topwrite/assets/quickstart_team_p7.png =733)
+
+^
+
+### 3.4 创建schema和table
+
+在 Lakehouse 的工作空间中，schema 用于进一步归类数据表和视图。可根据团队规模和业务需求规划 schema 层级。以下先创建3个schema：STG、CORE和ADS。
+
+首先在新创建的dev\_envirment工作空间的右侧点击“开发”，进入开发页面，并执行以下SQL，创建schema：
+
+:-: ![](.topwrite/assets/quickstart_team_p8.png =730)
+
+^
+
+:-: ![](.topwrite/assets/quickstart_team_p9.png =736)
+
+在Schema STG中创建2张表，并插入部分样例数据：
+
+```SQL
+CREATE SCHEMA STG;   -- 数据源原始或暂存表存放
+CREATE SCHEMA CORE;  -- 核心事实表/维度表存放
+CREATE SCHEMA ADS;   -- 汇总或分析结果表存放
+
+
+----------------------------------------------------------
+-- 1. 在STG层创建示例表: EMPLOYEES
+----------------------------------------------------------
+CREATE TABLE STG.EMPLOYEES (
+    EMP_ID          INT,
+    EMP_NAME        VARCHAR(50),
+    DEPARTMENT      VARCHAR(50),
+    JOIN_DATE       STRING
+);
+
+-- 向表中插入一些示例数据
+INSERT INTO STG.EMPLOYEES (EMP_ID, EMP_NAME, DEPARTMENT, JOIN_DATE) VALUES
+    (101, 'Alice',    'Engineering', '2023-07-10'),
+    (102, 'Bob',      'Sales',       '2024-08-05'),
+    (103, 'Charlie',  'Finance',     '2024-09-01');
+
+----------------------------------------------------------
+-- 2. 创建示例视图: EMPLOYEES_OVERVIEW
+----------------------------------------------------------
+CREATE VIEW ADS.EMPLOYEES_OVERVIEW AS
+SELECT 
+    EMP_ID,
+    EMP_NAME,
+    DEPARTMENT,
+    JOIN_DATE
+FROM EMPLOYEES;
+```
+
+### 3.5 将团队成员加入工作空间并授权
+
+上文中创建的两个用户：developer 和 analyst，默认并不具备任何数据操作和资源使用的权限。需要经由具备工作空间管理员角色（workspace\_admin）的用户授权后，才可以进行操作。
+
+假设我们希望这两个用户各自的权限范围是：
+
+**developer用户**，可以使用“开发”功能；可以在dev\_environment工作空间下对所有数据进行读写操作，并可以创建和删除table、view等对象；可以使用dev\_environment工作空间下所有的计算集群资源；可以提交并维护dev\_environment工作空间下的周期任务。
+
+**analyst用户**，可以使用“开发”功能；对schema ADS 下的所有表和视图具备只读权限，对表stg.employees具备只读权限；可以使用dev\_environmentt工作空间下所有的计算集群资源。
+
+为了达到以上效果，需要继续使用创建dev\_environment工作空间的用户，打开“开发”功能，新建SQL脚本，并执行以下授权语句：
+
+```SQL
+----------------------------------------------------------
+-- 1. 为developer用户授权
+----------------------------------------------------------
+--将用户developer加入工作空间，仅加入工作空间后，才可以授予该工作空间下元数据对象的权限
+CREATE USER developer;
+
+--为用户developer授予workspace_dev角色,以具备以下权限“可以使用'开发'功能；可以在dev_environment工作空间下对所有数据进行读写操作，并可以创建和删除table、view等对象；可以使用dev_environment工作空间下所有的计算集群资源；”
+GRANT ROLE workspace_dev TO USER developer;
+
+--为用户developer授予workspace_sre角色，已具备“可以提交并维护dev_environment工作空间下的周期任务”的权限
+GRANT ROLE workspace_sre TO USER developer;
+
+
+----------------------------------------------------------
+-- 2. 为analyst用户授权
+----------------------------------------------------------
+--将用户analyst加入工作空间，仅加入工作空间后，才可以授予该工作空间下元数据对象的权限
+CREATE USER analyst;
+
+--为用户analyst授予workspace_analyst角色,以具备以下权限“可以使用'开发'功能；可以使用dev_environment工作空间下所有的计算集群资源；”
+GRANT ROLE workspace_analyst TO USER analyst;
+
+--为用户analyst授予单独授予部分数据权限，以实现“对schema ADS 下的所有表和视图具备只读权限”
+GRANT SELECT, READ METADATA ON ALL TABLES IN SCHEMA ads TO USER analyst;
+GRANT SELECT, READ METADATA ON ALL VIEWS IN SCHEMA ads TO USER analyst;
+
+--为用户analyst授予单独授予部分数据权限，以实现“对表stg.employees具备只读权限”
+GRANT SELECT, READ METADATA ON TABLE stg.employees TO USER analyst;
+
+```
+
+上述授权操作中，将用户加入工作空间和授予角色的操作也可以通过WEB页面操作完成。
+
+**web端加入工作空间操作**
+
+继续使用创建dev\_environment工作空间的用户，点击左侧菜单“管理”-“工作空间”，进入工作空间列表，找到dev\_environment工作空间，点击进入。在工作空间详情页面的“用户”页签右侧点击“+添加用户”按钮：
+
+:-: ![](.topwrite/assets/quickstart_team_p10.png =774)
+
+^
+
+在弹窗中找到用户 developer 并勾选（可以同时找到 analyst 用户，一起勾选。但是因为两个用户要授予的权限不同，此处分开操作，仅先添加 developer 用户）。
+
+:-: ![](.topwrite/assets/quickstart_team_p11.png =763)
+
+^
+
+此时下方有两个按钮，点击右边的“添加用户”，仅执行添加用户进入工作空间的操作，不做任何授权。点击左边的“添加用户并授予角色”，可以进一步选择要授予的角色。假设我们点击左边的“添加用户并授予角色”按钮：
+
+:-: ![](.topwrite/assets/quickstart_team_p12.png =772)
+
+^
+
+在可授予的角色中，我们选择“workspace\_dev"角色，勾选并点击”角色授予“。
+
+完成上述操作后，我们即完成了对用户developer的加入工作空间和授权操作。效果和上述SQL执行的授权等价。
+
+对用户analyst的授权操作，由于包含“单独授予部分数据权限”的操作，这部分操作推荐使用SQL的GRANT语句执行授权，更为便利。
+
+### 3.6 检查授权结果
+
+Lakehouse支持使用SHOW GRANTS语句查询用户已授予的权限。
+
+在“开发”功能中执行以下语句：
+
+```SQL
+SHOW GRANTS TO USER developer;
+```
+
+返回结果如下：
+
+:-: ![](.topwrite/assets/quickstart_team_p13.png =738)
+
+^
+
+### 3.7 团队成员登录系统
+
+完成上述操作后，developer和analyst两个用户均可以登录Lakehouse，并具备了相应的权限可以进行数据开发或查询。下面使用developer用户登录系统。
+
+回到云器的登录页面<https://accounts.clickzetta.com/login>，依次输入账户名称、用户名和密码。其中账户名称在账号注册成功后提供，并可在该账户任意用户登录后的 URL 中获取。
+
+:-: ![](.topwrite/assets/quickstart_team_p15.png =746)
+
+现在使用developer用户，在<账户名称>.accounts.clickzetta.com/login URL登录，并点击“Lakehouse”产品下“进入”服务实例按钮，进入Lakehouse服务实例中。
+
+:-: ![](.topwrite/assets/quickstart_team_p16.png =740)
+
+### 3.8 团队成员编写开发任务
+
+developer用户登录后，在左侧菜单中进入“开发”页面。因当前developer用户只加入了dev\_envirment这一个工作空间，所以无需切换工作空间。如果加入多个工作空间，可以在右上角切换所需进行开发的工作空间。
+
+:-: ![](.topwrite/assets/quickstart_team_p17.png =739)
+
+^
+
+点击“开发”功能的“+”新建SQL脚本，写一条查询语句查询 stg.employees 表中的数据。
+
+:-: ![](.topwrite/assets/quickstart_team_p18.png =717)
+
+^
+
+```SQL
+select * from stg.employees limit 10;
+```
+
+:-: ![](.topwrite/assets/quickstart_team_p19.png =740)
+
+^
+
+依次点击“保存”按钮保存任务代码，点击“调度”按钮打开调度配置弹窗。
+
+:-: ![](.topwrite/assets/quickstart_team_p20.png =572)
+
+^
+
+在弹窗中配置调度任务的周期、重跑方式等信息，然后点击“确定”按钮，即完成该任务的调度配置操作。
+
+:-: ![](.topwrite/assets/quickstart_team_p21.png =730)
+
+^
+
+成功配置调度后，“提交”按钮变为可点击状态。点击“提交”后，该任务即提交为周期调度运行。
+
+:-: ![](.topwrite/assets/quickstart_team_p22.png =695)
+
+^
+
+以上即完成了从创建用户、授权到使用新用户开发SQL任务并提交周期调度运行的过程。

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

@@ -0,0 +1,99 @@
+# 快速分析本地的CSV 文件
+
+### **目标**：
+
+通过本篇文档，能够利用 Lakehouse 快速分析本地的 CSV 文件
+
+### **分析 CSV 格式文件**：
+
+#### **数据准备**：
+
+本文以巴西电商公共数据集为例，在客户端的本地路径 /User/Downloads/brazil-ecommerce 有如下 csv 文件：
+
+```
+-------------/User/Downloads/brazil-ecommerce ------------------ 
+olist_customers_dataset.csv.gz 
+olist_geolocation_dataset.csv.gz
+olist_order_items_dataset.csv.gz 
+olist_order_payments_dataset.csv.gz 
+olist_order_reviews_dataset.csv.gz 
+olist_orders_dataset.csv.gz
+olist_products_dataset.csv.gz 
+olist_sellers_dataset.csv.gz 
+product_category_name_translation.csv.gz
+```
+
+利用 Lakehouse JDBC 客户端 SQLLine（或 DBeaver / Datagrip 等）将数据上传至 Lakehouse User volume 空间（限制：单文件需小于5G）：
+
+(USER VOLUME 是当前用户在当前的工作空间下，默认开通的文件存储空间，无需提前创建）
+
+```
+--在 SQLline 或者任意 Lakehouse JDBC 客户端中执行，上传单一文件：olist_customers_dataset.csv.gz
+
+PUT '/User/Downloads/brazil-ecommerce/olist_customers_dataset.csv.gz' TO USER VOLUME SUBDIRECTORY 'bz_olist_data';
+```
+
+在客户端工具，或者 Studio SQL 任务节点中，执行如下命令展示已经上传到 USER VOLUME 中的文件：
+
+```
+show user volume directory like '%olist%';
+```
+
+#### **通过 Lakehouse SQL 快速分析数据**
+
+如：统计每个州（state）有多少用户，并按用户数降序排序
+
+```
+SELECT count(1) as customer_number_by_state,
+       customer_state,
+FROM USER VOLUME (
+    customer_id STRING,
+    customer_unique_id STRING,
+    customer_zip_code_prefix INT,
+    customer_city STRING,
+    customer_state STRING
+ ) using csv Options
+ (
+     'sep' = ',',
+     'compression'='gzip',  -- 目前支持 zstd/gzip/zlib 压缩格式。无压缩直接去掉此参数
+     'header'='true'
+ )
+ FILES ('bz_olist_data/olist_customers_dataset.csv.gz')
+group by customer_state
+order by customer_number_by_state desc;
+```
+
+其中，Options 中的选项：
+
+* sep：列分隔符，默认为 ” , “。最多支持长度为 1 的字符，例如：`'sep'=','`
+* compression：配置文件压缩格式。支持的压缩格式有：gzip/zstd/zlib。例如：`'compression'='gzip'`
+* header：是否解析表头，默认为 false。布尔类型，例如：`'header'='true'`
+
+除此之外，还支持以下参数：
+
+* timeZone：配置时区，没有默认值。用于指定文件中时间格式的时区。例如：`'timeZone' = 'Asia/Shanghai'`
+* escape：用于转义已加引号的值中的引号，默认值为”\“，例如：`'escape'='\'`
+* lineSep：行分隔符，默认值为"\n"。最多支持长度为 2 的字符，例如：`'lineSep'='$'`
+* quote：设置用于转义引号值的单个字符。默认值为双引号“"“，例如：`'quote'='"'`
+
+#### **将文件生成 lakehouse 内表**
+
+```
+CREATE TABLE OLIST_CUSTOMER_TBL
+AS
+SELECT * FROM USER VOLUME (
+    customer_id STRING,
+    customer_unique_id STRING,
+    customer_zip_code_prefix INT,
+    customer_city STRING,
+    customer_state STRING
+ ) using csv Options
+ (
+     'sep' = ',',
+     'compression'='gzip',
+     'header'='true'
+ )
+ FILES ('bz_olist_data/olist_customers_dataset.csv.gz');
+```
+
+