@clickzetta/cz-cli-darwin-arm64 0.3.80 → 0.3.81

package/bin/skills/clickzetta-batch-sync-pipeline/SKILL.md

@@ -1,227 +0,0 @@
----
-name: clickzetta-batch-sync-pipeline
-description: |
-  创建和管理 ClickZetta Lakehouse 离线同步（批量同步）任务，支持单表离线同步和多表离线同步两种模式。
-  单表模式适合简单的源→目标表同步；多表模式支持整库镜像、多表镜像、多表合并三种同步方式。
-  当用户说"离线同步"、"批量同步"、"batch sync"、"数据库同步到 Lakehouse"、"整库迁移"、
-  "多表同步"、"定期同步"、"周期性数据同步"、"分库分表合并"、"离线数据迁移"时触发。
-  包含单表/多表离线同步任务创建、数据源配置、字段映射、同步规则、调度部署、任务运维等
-  ClickZetta Studio 特有逻辑。
-  Keywords: batch sync, offline sync, full load, mirror, multi-table sync
----
-
-# 离线同步（批量同步）Pipeline 工作流
-
-## 向导：收集必要信息
-
-开始创建同步任务前，优先使用交互式问答工具（如 `question`）收集以下信息并弹出选项菜单；若无此类工具，则用文字一次性列出所有问题：
-
-```
-question({
-  questions: [
-    {
-      question: "数据源类型和名称是什么？",
-      options: [
-        { label: "MySQL", description: "如 aliyun_mysql、rds_mysql" },
-        { label: "PostgreSQL", description: "如 pg_prod、aurora_pg" },
-        { label: "SQL Server", description: "如 sqlserver_prod" },
-        { label: "OSS/S3/COS 对象存储", description: "如 oss_bucket、s3_data" }
-      ]
-    },
-    {
-      question: "同步范围是什么？",
-      options: [
-        { label: "单表同步", description: "指定一张源表同步到目标表" },
-        { label: "多表镜像", description: "整库或指定多张表批量同步" },
-        { label: "分库分表合并", description: "多张源表合并到一张目标表" }
-      ]
-    },
-    {
-      question: "写入模式？",
-      options: [
-        { label: "全量覆盖（OVERWRITE）", description: "每次全量覆盖目标表，推荐" },
-        { label: "增量追加（APPEND）", description: "追加新数据，不删除历史" }
-      ]
-    }
-  ]
-})
-```
-
-收集到信息后，还需确认：目标 schema（如 `ods`）、调度时间（如每天 02:00）。这两项可以在用户回答后直接询问，或从上下文推断。
-
-**如果用户已经提供了足够信息，直接进入工作流，不再弹出菜单。**
-
----
-
-## 前置依赖
-
-- ClickZetta Lakehouse Studio 账户，具备创建同步任务、目标表的权限
-- 源端数据源已在 Studio 中配置（具备 SELECT 权限）
-- 目标端 Lakehouse 数据源可用（具备 CREATE、INSERT 权限）
-- 已安装 cz-cli 并完成 profile 配置（`cz-cli profile status` 验证连接）
-
----
-
-## 适用场景
-
-- 将外部数据库（MySQL / PostgreSQL / SQL Server 等）的数据定期同步到 Lakehouse
-- 单表离线同步：简单的源表 → 目标表周期性同步
-- 多表离线同步：整库迁移、多表批量同步、分库分表合并
-- 数据时效性要求不高，按天/小时等周期批量更新
-
----
-
-## 模式选择
-
-| 维度 | 单表离线同步 | 多表离线同步 |
-|------|------------|------------|
-| 任务类型 ID | `1`（DI/INTEGRATION） | `291`（MULTI_DI） |
-| 同步粒度 | 单张源表 → 单张目标表 | 整库 / 多表 → 多张目标表 |
-| 适用场景 | 简单同步、精细控制单表 | 整库迁移、批量同步、分库分表合并 |
-| Schema Evolution | 不支持 | 支持（新增字段自动适配） |
-| 自动建表 | 需手动创建或快速创建 | 目标表不存在时自动创建 |
-| 写入模式 | 由数据源决定 | overwrite / upsert 可选 |
-
-> **重要**：这两种任务类型均为 UI_ONLY 类型，脚本内容必须在 Studio Web UI 中配置。
-> cz-cli 负责任务创建、调度配置、发布和运维；数据源选择、字段映射等内容配置在 Studio UI 完成。
-
----
-
-## 工作流
-
-> **重要**：离线同步任务的**内容配置**（来源表选择、字段映射、同步规则等）必须在 Studio Web UI 中完成。
-> cz-cli 负责任务创建、调度配置、发布和运维；数据源选择、字段映射等内容配置在 Studio UI 完成。
-
-### 步骤 1：用 cz-cli 创建任务
-
-```bash
-# 单表离线同步（task_type=1，即 DI/INTEGRATION）
-cz-cli task create "sync_orders_daily" --type DI --folder <folder_name>
-
-# 多表离线同步（task_type=291，即 MULTI_DI）
-cz-cli task create "sync_ecommerce_db" --type MULTI_DI --folder <folder_name>
-```
-
-命令返回 `task_id` 和 `studio_url`，在 `studio_url` 中完成数据源配置。
-
-### 步骤 2：在 Studio UI 中配置同步内容
-
-打开步骤 1 返回的 `studio_url`，在 Studio 中完成：
-
-**来源数据配置**
-- 选择源端数据源类型和连接（支持的数据源类型以 Studio UI 中显示为准，可通过 `cz-cli datasource list` 查看已配置的数据源）
-- 单表：指定 schema 和表名
-- 多表：选择整库 / 勾选多表 / 配置合并规则
-
-**目标设置**
-- 选择目标 Lakehouse 数据源和 workspace
-- 配置目标 schema 和表名
-- 多表模式可配置命名规则（支持 `{SOURCE_DATABASE}`、`{SOURCE_TABLE}` 变量）
-
-**同步规则（多表模式）**
-- Schema Evolution：源端新增字段自动适配；删除字段写入 Null
-- 写入模式：非主键表 → overwrite；主键表 → overwrite 或 upsert
-
-### 步骤 3：在 Studio UI 中调试运行
-
-点击「运行」按钮进行调试，验证数据源连接和配置是否正确。
-
-### 步骤 4：用 cz-cli 配置调度和发布
-
-```bash
-# 配置调度（具体参数见 --help）
-cz-cli task save-cron <task_name> --help
-
-# 发布任务
-cz-cli task deploy <task_name> -y
-```
-
-> 离线同步任务（task_type=1 和 291）必须使用 Sync VCluster，不能使用通用型或分析型 VCluster。
-
-### 步骤 5：验证与监控
-
-```bash
-cz-cli runs list --task <task_name>      # 查看运行记录
-cz-cli runs detail <run_id>              # 查看运行详情
-cz-cli attempts log <run_id>             # 查看执行日志
-cz-cli runs refill <task_name> --help    # 补数据（--help 查看参数）
-```
-
----
-
-## 任务运维操作
-
-| 操作 | cz-cli 命令 | 说明 |
-|------|------------|------|
-| 下线 | `cz-cli task undeploy <task> -y` | 停止任务并从调度系统移除（不可逆） |
-| 补数据 | `cz-cli runs refill <task> --from D --to D -y` | 对历史周期进行数据补录 |
-| 查看依赖 | `cz-cli runs deps <task>` | 查看已发布的上下游依赖 |
-| 查看运行 | `cz-cli runs list --task <task>` | 查看运行实例列表 |
-
-多表离线同步任务在 Studio「任务运维」→「周期任务」中管理，可查看：
-- 任务实例 Tab：每张表的读取/写入行数和同步速率
-- 同步对象 Tab：所有源表和目标表的映射关系
-
----
-
-## 交付验收 Checklist
-
-同步任务发布运行后，**必须逐项验证**：
-
-```sql
--- 1. 行数比对：目标表行数与源端一致
-SELECT COUNT(*) FROM <ods_schema>.<table>;
--- 与源端 MySQL/PG 执行 SELECT COUNT(*) FROM <table> 对比
-
--- 2. 关键字段非空率
-SELECT
-  COUNT(*) AS total,
-  COUNT(key_field) AS non_null,
-  ROUND(COUNT(key_field) * 100.0 / COUNT(*), 2) AS non_null_pct
-FROM <ods_schema>.<table>;
-```
-
-**验收标准：**
-- [ ] 目标表行数与源端一致
-- [ ] 关键字段非空率符合预期
-- [ ] 同步任务最近运行状态为 SUCCESS
-- [ ] 字段类型映射正确（重点检查 BIT/ENUM/TEXT 等异构类型）
-- [ ] 调度 Cron 配置正确，下次执行时间符合预期
-
----
-
-## 故障排除
-
-| 问题 | 排查方向 |
-|------|---------|
-| 任务创建失败 | 确认账号有创建任务权限；检查文件夹 ID 是否存在 |
-| 源端连接失败 | 检查数据源配置中的连接信息、网络可达性、账号权限 |
-| 字段映射失败 | 检查源表和目标表的字段类型兼容性 |
-| 同步速度慢 | 调整并发数（最大 10）和同步速率；检查源端数据库负载 |
-| Schema Evolution 失败 | 不支持修改主键字段；字段类型仅支持同类型扩展（int8→int16→int32→int64） |
-| 多表同步部分表失败 | 在实例详情的「同步对象」Tab 查看各表状态；可对失败表单独重跑 |
-| upsert 模式数据不一致 | 确认目标表有正确的主键定义；检查源端数据是否有主键冲突 |
-| VCluster 类型错误 | 离线同步必须使用 Sync VCluster，通过 `SHOW VCLUSTERS` 确认类型 |
-
----
-
-## 注意事项
-
-**权限要求**
-- 源端：数据源配置的账号需具备 SELECT 权限
-- 目标端：任务负责人需具备 CREATE 和 INSERT 权限
-
-**性能考虑**
-- 合理配置并发度，避免对源端数据库造成过大压力
-- 首次执行需初始化所有同步对象，可能耗时较长
-- 选择源端数据库压力较小的时间窗口执行调度
-
-**Schema Evolution 限制（多表离线同步）**
-- 不支持修改主键字段（Lakehouse 主键表限制）
-- 字段类型修改仅支持同类型扩展（int8 → int16 → int32 → int64）
-- 不支持跨类型转换（如 int → double）
-
-**支持的数据源**
-- 来源端：关系型数据库（MySQL、PostgreSQL、SQL Server 等）及其云变体（Aurora、PolarDB 等），具体支持列表以 Studio UI 中显示为准，可通过 `cz-cli datasource list` 查看已配置的数据源
-- 目标端：Lakehouse
-

package/bin/skills/clickzetta-batch-sync-pipeline/eval_cases.jsonl

@@ -1,5 +0,0 @@
-{"case_id":"001","type":"should_call","user_input":"怎么创建离线同步任务把 MySQL 表定期同步到 Lakehouse？","expected_skill":"clickzetta-batch-sync-pipeline","expected_output_contains":["离线同步","Cron","调度"]}
-{"case_id":"002","type":"should_call","user_input":"多表离线同步支持自动建表吗？","expected_skill":"clickzetta-batch-sync-pipeline","expected_output_contains":["自动创建","多表"]}
-{"case_id":"003","type":"should_call","user_input":"离线同步的单表模式和多表模式怎么选？","expected_skill":"clickzetta-batch-sync-pipeline","expected_output_contains":["单表","多表","task_type"]}
-{"case_id":"004","type":"should_call","user_input":"批量同步支持 Schema Evolution 吗？新增字段会自动适配吗？","expected_skill":"clickzetta-batch-sync-pipeline","expected_output_contains":["Schema Evolution","多表"]}
-{"case_id":"005","type":"should_call","user_input":"怎么配置离线同步任务的调度周期？用 Cron 表达式吗？","expected_skill":"clickzetta-batch-sync-pipeline","expected_output_contains":["Cron","调度"]}

package/bin/skills/clickzetta-bi-connect/LICENSE

@@ -1,16 +0,0 @@
-ClickZetta Skills License
-© 2026 Yunqi Inc. All rights reserved.
-LICENSE: Use of these materials (including all code, prompts, assets, files, and other components of these skills (collectively, "Skills")) is governed by your agreement with ClickZetta for the Service. If no separate agreement exists, use is governed by ClickZetta's Terms of Service (available at: https://yunqi.tech/documents/user-aggrement).
-Your applicable agreement is referred to as the "Agreement." "Service" is as defined in the Agreement.
-ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the contrary, you may not:
-
-Extract from the Service or retain copies of the Skills outside use with the Service;
-Reproduce or copy the Skills, except for temporary copies created automatically during authorized use of the Service;
-Create derivative works based on the Skills;
-Distribute, sublicense, or transfer the Skills to any third party;
-Make, offer to sell, sell, or import any inventions embodied in the Skills; nor,
-Reverse engineer, decompile, or disassemble the Skills.
-
-The receipt, viewing, or possession of the Skills does not convey or imply any license or right beyond those expressly granted above.
-Yunqi retains all rights, title, and interest in the Skills, including all copyrights, trademarks, patents, and all other applicable intellectual property rights.
-THE SKILLS ARE PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SKILLS OR THE USE OR OTHER DEALINGS IN THE SKILLS.

package/bin/skills/clickzetta-bi-connect/SKILL.md

@@ -1,176 +0,0 @@
----
-name: clickzetta-bi-connect
-description: |
-  将 BI 工具和数据库客户端连接到 ClickZetta Lakehouse。覆盖 Apache Superset、
-  Tableau、Metabase、DBeaver、DataGrip、帆软 FineBI 等主流工具的完整连接配置，
-  包括 JDBC 连接字符串格式、SQLAlchemy URL 格式、驱动安装步骤。
-  当用户说"连接 Superset"、"Tableau 连接 Lakehouse"、"Metabase"、"DBeaver"、
-  "DataGrip"、"BI 工具"、"JDBC 连接"、"SQLAlchemy 连接"、"帆软"、"FineBI"、
-  "数据库客户端"、"可视化工具连接"、"BI 报表"、"PowerBI"、"Navicat"、
-  "MySQL 协议连接"时触发。
-  Keywords: BI, Superset, Tableau, Metabase, DBeaver, DataGrip, FineBI, JDBC, connection
----
-
-# ClickZetta BI 工具连接
-
-阅读 [references/bi-tools.md](references/bi-tools.md) 了解各工具详细配置。
-
-## 连接方式速查
-
-| 工具 | 连接方式 |
-|---|---|
-| Apache Superset | SQLAlchemy URL |
-| Tableau | JDBC + .taco 插件 |
-| Metabase | 专用 .jar 驱动 |
-| DBeaver / DataGrip | JDBC |
-| 帆软 FineBI | JDBC 或 MySQL 协议 |
-| PowerBI | MySQL 协议 |
-| Navicat | MySQL 协议 |
-| Python / ORM | SQLAlchemy |
-
----
-
-## JDBC 连接字符串
-
-```
-jdbc:clickzetta://<instance>.<region_id>.api.clickzetta.com/<workspace>?username=<user>&password=<pwd>&schema=<schema>&virtualCluster=<vc_name>
-```
-
-**示例：**
-```
-jdbc:clickzetta://f8866243.cn-shanghai-alicloud.api.clickzetta.com/quick_start?username=alice&password=xxxx&schema=public&virtualCluster=default_ap
-```
-
-- 驱动类：`com.clickzetta.client.jdbc.ClickZettaDriver`
-- 驱动下载：Maven `com.clickzetta:clickzetta-java` 或 [sonatype](https://central.sonatype.com/artifact/com.clickzetta/clickzetta-java/versions)
-
----
-
-## SQLAlchemy URL（Superset / Python ORM）
-
-```
-clickzetta://<username>:<password>@<instance>.<region_id>.api.clickzetta.com/<workspace>?schema=<schema>&vcluster=<vc_name>
-```
-
-安装：
-```bash
-pip uninstall -y clickzetta-sqlalchemy clickzetta-connector
-pip install clickzetta-connector -U
-```
-
----
-
-## Apache Superset
-
-**Docker 快速启动：**
-```bash
-docker pull clickzetta/superset:2.1.0-1
-docker run -p 8088:8088 clickzetta/superset:2.1.0-1
-# 访问 http://localhost:8088，账号 admin/clickzetta
-```
-
-**配置数据库连接：**
-1. Settings → Database Connections → + Database → 选择 **Other**
-2. 填写 SQLAlchemy URI：
-   ```
-   clickzetta://username:password@instance.cn-shanghai-alicloud.api.clickzetta.com/workspace?vcluster=default_ap
-   ```
-3. TESTING CONNECTION → CONNECT
-
----
-
-## Tableau
-
-1. 将 JDBC JAR 放入 Tableau Drivers 目录
-2. 将 `.taco` 插件放入 Connectors 目录
-3. 启动时加 `-DDisableVerifyConnectorPluginSignature=true`
-4. 连接：到服务器 → 更多 → **Lakehouse x 云器科技**
-
----
-
-## Metabase
-
-```bash
-docker run -d -p 3000:3000 --name metabase metabase/metabase:v0.54.6
-docker cp clickzetta.metabase-driver.jar metabase:/plugins/
-docker restart metabase
-```
-
-访问 `http://localhost:3000` → Admin Settings → Databases → Add a database → 选择 ClickZetta
-
----
-
-## DBeaver
-
-1. 驱动管理器 → 新建驱动
-2. 类名：`com.clickzetta.client.jdbc.ClickZettaDriver`
-3. 添加 JDBC JAR 包
-4. 新建连接 → 粘贴 JDBC 连接字符串
-
----
-
-## MySQL 协议连接（PowerBI / Navicat / 帆软）
-
-Lakehouse 支持通过 MySQL 协议连接，适用于不支持自定义 JDBC 驱动的工具。
-
-**前置准备：**
-1. 在管理中心为用户重置 MySQL 协议专用密码
-2. 为用户设置默认计算集群（`ALTER USER username SET DEFAULT_VCLUSTER = default_ap`）
-
-**用户名格式：** `<instance_name>.<workspace_name>.<username>`
-
-**连接参数：**
-- 主机：`<instance>.<region_id>.mysql.clickzetta.com`
-- 端口：`3306`
-- 用户名：`instance.workspace.username`（三段式拼接）
-- 密码：MySQL 协议专用密码（非 Lakehouse 登录密码）
-
-### PowerBI
-
-1. 获取数据 → MySQL 数据库
-2. 服务器：`instance.cn-shanghai-alicloud.mysql.clickzetta.com`
-3. 用户名：`instance.workspace.username`
-4. 密码：MySQL 协议专用密码
-5. 数据连接模式选择 DirectQuery
-
-### Navicat
-
-1. 新建连接 → MySQL
-2. 主机：`instance.cn-shanghai-alicloud.mysql.clickzetta.com`
-3. 端口：`3306`
-4. 用户名：`instance.workspace.username`
-5. 密码：MySQL 协议专用密码
-
-### 帆软 FineBI（MySQL 协议方式）
-
-1. 管理系统 → 数据连接 → 新建数据连接 → MySQL
-2. URL：`jdbc:mysql://instance.cn-shanghai-alicloud.mysql.clickzetta.com:3306/workspace`
-3. 用户名：`instance.workspace.username`
-4. 密码：MySQL 协议专用密码
-
-> ⚠️ MySQL 协议连接有部分 SQL 语法限制，详见 [使用MySQL协议连接](https://www.yunqi.tech/documents/use-mysql-client)
-
----
-
-## 常用地域代码
-
-| 地域 | region_id |
-|---|---|
-| 阿里云上海 | `cn-shanghai-alicloud` |
-| 腾讯云上海 | `ap-shanghai-tencentcloud` |
-| 腾讯云北京 | `ap-beijing-tencentcloud` |
-| AWS 新加坡 | `ap-southeast-1-aws` |
-
----
-
-## 常见问题
-
-| 问题 | 解决方案 |
-|---|---|
-| Superset 连接失败 | 确认已安装 `clickzetta-connector`，URL 格式正确 |
-| Tableau 找不到 Lakehouse 连接器 | 确认 .taco 文件在正确目录，且启动时禁用签名校验 |
-| DBeaver 驱动加载失败 | 确认 JAR 包版本与 Lakehouse 版本匹配 |
-| 连接超时 | 检查网络，确认 instance/region_id 正确 |
-| 无权限查询 | 确认用户已被 `CREATE USER` 添加到工作空间，且有 `USE VCLUSTER` 权限 |
-| MySQL 协议连接失败 | 确认用户名为三段式格式（instance.workspace.username），密码为 MySQL 协议专用密码 |
-| PowerBI DirectQuery 报错 | 确认已设置用户默认计算集群（`ALTER USER ... SET DEFAULT_VCLUSTER`） |

package/bin/skills/clickzetta-bi-connect/eval_cases.jsonl

@@ -1,5 +0,0 @@
-{"case_id":"001","type":"should_call","user_input":"怎么把 Superset 连接到 ClickZetta？","expected_skill":"clickzetta-bi-connect","expected_output_contains":["SQLAlchemy","clickzetta://"]}
-{"case_id":"002","type":"should_call","user_input":"Tableau 怎么连接 ClickZetta Lakehouse？","expected_skill":"clickzetta-bi-connect","expected_output_contains":["JDBC",".taco"]}
-{"case_id":"003","type":"should_call","user_input":"DBeaver 连接 ClickZetta 的 JDBC URL 怎么写？","expected_skill":"clickzetta-bi-connect","expected_output_contains":["jdbc:clickzetta://","ClickZettaDriver"]}
-{"case_id":"004","type":"should_call","user_input":"Metabase 怎么连接 ClickZetta？需要装什么驱动？","expected_skill":"clickzetta-bi-connect","expected_output_contains":["Metabase",".jar"]}
-{"case_id":"005","type":"should_call","user_input":"帆软 FineBI 怎么连接 ClickZetta？","expected_skill":"clickzetta-bi-connect","expected_output_contains":["JDBC","MySQL 协议"]}

package/bin/skills/clickzetta-bi-connect/references/bi-tools.md

@@ -1,170 +0,0 @@
-# BI 工具连接参考
-
-> 来源：https://www.yunqi.tech/documents/ecosystem-all 等
-
-## 连接方式总览
-
-| 工具 | 连接方式 | 说明 |
-|---|---|---|
-| Apache Superset | SQLAlchemy URL | 需安装 clickzetta-connector |
-| Tableau | JDBC + 插件 | 需下载 .taco 插件 |
-| Metabase | 专用驱动 | 需下载 .jar 驱动 |
-| DBeaver | JDBC | 通用数据库客户端 |
-| DataGrip | JDBC | JetBrains 数据库 IDE |
-| 帆软 FineBI | JDBC | 国产 BI 工具 |
-
----
-
-## JDBC 连接字符串格式
-
-```
-jdbc:clickzetta://<instance_name>.<region_id>.api.clickzetta.com/<workspace_name>?username=<user>&password=<pwd>&schema=<schema>&virtualCluster=<vc_name>
-```
-
-示例：
-```
-jdbc:clickzetta://f8866243.cn-shanghai-alicloud.api.clickzetta.com/quick_start?username=alice&password=xxxx&schema=public&virtualCluster=default_ap
-```
-
-JDBC 驱动类：`com.clickzetta.client.jdbc.ClickZettaDriver`
-
-JDBC 驱动下载：
-- Maven: `com.clickzetta:clickzetta-java`
-- 直接下载：https://central.sonatype.com/artifact/com.clickzetta/clickzetta-java/versions
-
----
-
-## SQLAlchemy URL 格式
-
-```
-clickzetta://<username>:<password>@<instance_name>.<region_id>.api.clickzetta.com/<workspace_name>?schema=<schema>&vcluster=<vc_name>
-```
-
-示例：
-```
-clickzetta://alice:xxxx@f8866243.cn-shanghai-alicloud.api.clickzetta.com/quick_start?schema=public&vcluster=default_ap
-```
-
-安装：
-```bash
-pip uninstall -y clickzetta-sqlalchemy clickzetta-connector && pip install clickzetta-connector -U
-```
-
----
-
-## Apache Superset
-
-### 快速启动（Docker）
-
-```bash
-docker pull clickzetta/superset:2.1.0-1
-docker run -p 8088:8088 clickzetta/superset:2.1.0-1
-# 访问 http://localhost:8088，默认账号 admin/clickzetta
-```
-
-### 本地安装
-
-```bash
-pip uninstall -y clickzetta-sqlalchemy clickzetta-connector
-pip install clickzetta-connector -U
-pip install 'apache-superset>=2.1'
-
-export FLASK_APP=superset
-superset db upgrade
-superset fab create-admin
-superset init
-superset run -p 8088 --with-threads --reload --debugger
-```
-
-### 配置数据库连接
-
-1. Settings → Database Connections → + Database
-2. 选择 **Other** 数据库类型
-3. 填写 SQLAlchemy URI：
-   ```
-   clickzetta://username:password@instance.region.api.clickzetta.com/workspace?vcluster=default_ap
-   ```
-4. 点击 TESTING CONNECTION 验证，通过后 CONNECT
-
----
-
-## Tableau
-
-### 前提条件
-
-1. 下载 JDBC 驱动 JAR 包
-2. 下载 Tableau 插件：`clickzetta_jdbc-v0.0.1.taco`
-
-### 安装步骤
-
-**放置 JDBC 驱动：**
-- Windows: `C:\Program Files\Tableau\Drivers`
-- macOS: `~/Library/Tableau/Drivers`
-- Linux: `/opt/tableau/tableau_driver/jdbc`
-
-**放置 Tableau 插件（.taco 文件）：**
-- Windows: `C:\Users\[User]\Documents\My Tableau Repository\Connectors`
-- macOS: `/Users/[user]/Documents/My Tableau Repository/Connectors`
-
-**启动 Tableau（禁用签名校验）：**
-```bash
-# macOS
-/Applications/Tableau\ Desktop\ [version].app/Contents/MacOS/Tableau -DDisableVerifyConnectorPluginSignature=true
-
-# Windows
-tableau.exe -DDisableVerifyConnectorPluginSignature=true
-```
-
-**连接：** 左侧导航 → 到服务器 → 更多 → Lakehouse x 云器科技 → 填写服务器/用户名/密码
-
----
-
-## Metabase
-
-### Docker 部署
-
-```bash
-docker pull metabase/metabase:v0.54.6
-docker run -d -p 3000:3000 --name metabase metabase/metabase:v0.54.6
-
-# 下载并安装云器驱动
-docker cp clickzetta.metabase-driver.jar metabase:/plugins/clickzetta.metabase-driver.jar
-docker restart metabase
-```
-
-驱动下载：`clickzetta.metabase-driver.jar`（联系云器技术支持获取）
-
-### 配置连接
-
-1. 访问 `http://localhost:3000`
-2. Admin Settings → Databases → Add a database
-3. 选择 ClickZetta Lakehouse，填写连接信息
-4. Test connection → Save
-
----
-
-## DBeaver
-
-### 配置步骤
-
-1. 数据库 → 驱动管理器 → 新建驱动
-2. 填写：
-   - 驱动名称：`Clickzetta`
-   - 类名：`com.clickzetta.client.jdbc.ClickZettaDriver`
-   - URL 模板：`jdbc:clickzetta://{instanceName}.{service}/{workspaceName}?virtualCluster={vc_name}`
-3. 选择库 → 添加 JDBC JAR 包
-4. 新建连接 → 搜索 Clickzetta → 粘贴 JDBC 连接字符串 → 填写用户名密码
-
----
-
-## 地域代码（region_id）速查
-
-| 云厂商 | 地域 | region_id |
-|---|---|---|
-| 阿里云 | 华东2（上海） | cn-shanghai-alicloud |
-| 腾讯云 | 华东（上海） | ap-shanghai-tencentcloud |
-| 腾讯云 | 华北（北京） | ap-beijing-tencentcloud |
-| 腾讯云 | 华南（广州） | ap-guangzhou-tencentcloud |
-| AWS | 中国（北京） | cn-north-1-aws |
-| 阿里云（新加坡） | 亚太东南1 | ap-southeast-1-alicloud |
-| AWS（新加坡） | 亚太（新加坡） | ap-southeast-1-aws |

package/bin/skills/clickzetta-cdc-sync-pipeline/LICENSE

@@ -1,16 +0,0 @@
-ClickZetta Skills License
-© 2026 Yunqi Inc. All rights reserved.
-LICENSE: Use of these materials (including all code, prompts, assets, files, and other components of these skills (collectively, "Skills")) is governed by your agreement with ClickZetta for the Service. If no separate agreement exists, use is governed by ClickZetta's Terms of Service (available at: https://yunqi.tech/documents/user-aggrement).
-Your applicable agreement is referred to as the "Agreement." "Service" is as defined in the Agreement.
-ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the contrary, you may not:
-
-Extract from the Service or retain copies of the Skills outside use with the Service;
-Reproduce or copy the Skills, except for temporary copies created automatically during authorized use of the Service;
-Create derivative works based on the Skills;
-Distribute, sublicense, or transfer the Skills to any third party;
-Make, offer to sell, sell, or import any inventions embodied in the Skills; nor,
-Reverse engineer, decompile, or disassemble the Skills.
-
-The receipt, viewing, or possession of the Skills does not convey or imply any license or right beyond those expressly granted above.
-Yunqi retains all rights, title, and interest in the Skills, including all copyrights, trademarks, patents, and all other applicable intellectual property rights.
-THE SKILLS ARE PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SKILLS OR THE USE OR OTHER DEALINGS IN THE SKILLS.