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

package/bin/skills/clickzetta-data-science/references/stats-functions.md

@@ -0,0 +1,195 @@
+# 数据科学统计分析函数参考
+
+---
+
+## 近似聚合函数（大表高效统计）
+
+### approx_count_distinct — 近似 UV
+
+```sql
+-- 使用 HyperLogLog 算法，误差约 2%，比 COUNT(DISTINCT) 快 10x+
+SELECT approx_count_distinct(user_id) AS approx_uv
+FROM my_schema.events;
+
+-- 按天统计 DAU
+SELECT
+    DATE(event_time) AS dt,
+    approx_count_distinct(user_id) AS dau
+FROM my_schema.events
+GROUP BY 1
+ORDER BY 1;
+```
+
+### approx_percentile — 近似分位数
+
+```sql
+-- 中位数、四分位数、P95、P99
+SELECT
+    approx_percentile(amount, 0.25) AS p25,
+    approx_percentile(amount, 0.50) AS median,
+    approx_percentile(amount, 0.75) AS p75,
+    approx_percentile(amount, 0.95) AS p95,
+    approx_percentile(amount, 0.99) AS p99
+FROM my_schema.orders;
+
+-- 分组分位数
+SELECT
+    category,
+    approx_percentile(price, 0.5) AS median_price
+FROM my_schema.products
+GROUP BY category;
+```
+
+### approx_histogram — 近似直方图
+
+```sql
+-- 返回结构体数组：[{min, max, count}, ...]
+SELECT approx_histogram(amount, 10) AS hist
+FROM my_schema.orders;
+
+-- 解析直方图（展开为行）
+SELECT
+    bucket.min AS bucket_min,
+    bucket.max AS bucket_max,
+    bucket.count AS bucket_count
+FROM (
+    SELECT EXPLODE(approx_histogram(amount, 10)) AS bucket
+    FROM my_schema.orders
+);
+```
+
+### approx_top_k — 近似 TOP-K 高频值
+
+```sql
+-- 找出出现最多的前 10 个城市
+SELECT approx_top_k(city, 10) AS top_cities
+FROM my_schema.orders;
+
+-- 返回结构体数组：[{value, count}, ...]
+-- 解析展开（字段名是 value 和 count）
+SELECT item.value AS city, item.count AS cnt
+FROM (
+    SELECT EXPLODE(approx_top_k(city, 10)) AS item
+    FROM my_schema.orders
+)
+ORDER BY cnt DESC;
+```
+
+---
+
+## 精确统计函数
+
+### percentile / median
+
+```sql
+-- 精确中位数（小表用，大表用 approx_percentile）
+SELECT
+    percentile(amount, 0.5)  AS exact_median,
+    median(amount)           AS median_alias  -- 等价写法
+FROM my_schema.orders;
+
+-- 多分位数
+SELECT percentile(amount, ARRAY(0.25, 0.5, 0.75, 0.9, 0.99))
+FROM my_schema.orders;
+```
+
+---
+
+## TABLESAMPLE 采样
+
+```sql
+-- ROW 模式：精确行级采样（适合 ML 训练集，< 1000万行）
+SELECT * FROM my_schema.events TABLESAMPLE ROW (10);      -- 精确 10%
+SELECT * FROM my_schema.events TABLESAMPLE ROW (5 ROWS);  -- 精确 5 行
+
+-- SYSTEM 模式：文件级采样（适合大表快速预览，> 1000万行）
+SELECT * FROM my_schema.events TABLESAMPLE SYSTEM (0.1) LIMIT 50000;  -- 约 0.1%
+
+-- 分层采样（按类别等比例采样）
+SELECT * FROM (
+    SELECT *,
+           ROW_NUMBER() OVER (PARTITION BY category ORDER BY RAND()) AS rn,
+           COUNT(*) OVER (PARTITION BY category) AS cat_total
+    FROM my_schema.products
+)
+WHERE rn <= CEIL(cat_total * 0.1);  -- 每类取 10%
+```
+
+| 场景 | 推荐模式 | 说明 |
+|---|---|---|
+| 快速数据预览 | SYSTEM | 极快，适合 > 100万行 |
+| ML 训练集构建 | ROW | 精确随机，保证代表性 |
+| 数据质量抽检 | SYSTEM | 快速抽样验证 |
+| 统计分析 | ROW | 精确概率采样 |
+
+> ⚠️ **注意**：TABLESAMPLE 在小表（< 数万行）上可能返回全部数据，百分比采样不精确。小表直接用 `LIMIT` 即可。
+
+---
+
+## 窗口函数（时序/排名特征）
+
+```sql
+-- 移动平均（7日）
+SELECT
+    dt,
+    revenue,
+    AVG(revenue) OVER (
+        ORDER BY dt
+        ROWS BETWEEN 6 PRECEDING AND CURRENT ROW
+    ) AS revenue_7d_ma
+FROM daily_stats;
+
+-- 环比增长率
+SELECT
+    dt,
+    revenue,
+    LAG(revenue, 1) OVER (ORDER BY dt)  AS prev_revenue,
+    ROUND(100.0 * (revenue - LAG(revenue, 1) OVER (ORDER BY dt))
+          / NULLIF(LAG(revenue, 1) OVER (ORDER BY dt), 0), 2) AS mom_growth_pct
+FROM daily_stats;
+
+-- 用户行为排名（RFM 分析）
+SELECT
+    user_id,
+    total_amount,
+    NTILE(5) OVER (ORDER BY total_amount DESC)  AS monetary_quintile,
+    NTILE(5) OVER (ORDER BY order_cnt DESC)     AS frequency_quintile,
+    NTILE(5) OVER (ORDER BY last_order_date DESC) AS recency_quintile
+FROM user_rfm;
+
+-- 去重保留最新（数据清洗常用）
+SELECT * FROM (
+    SELECT *,
+           ROW_NUMBER() OVER (
+               PARTITION BY user_id
+               ORDER BY update_time DESC
+           ) AS rn
+    FROM my_schema.users_raw
+) WHERE rn = 1;
+```
+
+---
+
+## 数据质量检查模板
+
+```sql
+-- 一次性输出所有关键质量指标
+SELECT
+    COUNT(*)                                                    AS total_rows,
+    COUNT(DISTINCT user_id)                                     AS unique_users,
+    -- 缺失率
+    ROUND(100.0 * COUNT(*) FILTER (WHERE user_id IS NULL)
+          / COUNT(*), 2)                                        AS user_id_null_pct,
+    ROUND(100.0 * COUNT(*) FILTER (WHERE amount IS NULL)
+          / COUNT(*), 2)                                        AS amount_null_pct,
+    -- 异常值
+    SUM(CASE WHEN amount < 0 THEN 1 ELSE 0 END)                AS negative_amount_cnt,
+    SUM(CASE WHEN amount > 1000000 THEN 1 ELSE 0 END)          AS extreme_amount_cnt,
+    -- 时间范围
+    MIN(order_date)                                             AS earliest_date,
+    MAX(order_date)                                             AS latest_date,
+    -- 分布
+    approx_percentile(amount, 0.5)                             AS median_amount,
+    approx_percentile(amount, 0.99)                            AS p99_amount
+FROM my_schema.orders;
+```

package/bin/skills/clickzetta-data-science/references/write-and-infer.md

@@ -0,0 +1,122 @@
+# 数据写入、特征工程、模型推理示例
+
+## 数据写入
+
+| 场景 | 方式 |
+|------|------|
+| ZettaPark 可用（Python 3.10+） | `save_as_table()` 或 `create_dataframe().write` |
+| 本地 CSV/pandas 写入 | `session.create_dataframe(df).write.save_as_table()` |
+| Python 3.9 / ZettaPark 不可用 | cursor 批量 INSERT（见下方） |
+| **禁止** | `df.to_sql()`、SQLAlchemy `clickzetta://...` |
+
+```python
+# 方式 A：ZettaPark（推荐）
+session.sql("""
+    SELECT o.*, u.age_group FROM my_schema.orders_raw o
+    LEFT JOIN my_schema.users u ON o.user_id = u.user_id
+    WHERE o.amount > 0
+""").write.mode("overwrite").save_as_table("ds_workspace.orders_clean")
+
+# 方式 B：pandas → Lakehouse
+session.create_dataframe(local_df).write.mode("append").save_as_table("ds_workspace.features_v1")
+
+# 方式 C：cursor 批量 INSERT（fallback）
+import clickzetta, os
+conn = clickzetta.connect(
+    service=os.environ["CLICKZETTA_SERVICE"], instance=os.environ["CLICKZETTA_INSTANCE"],
+    workspace=os.environ["CLICKZETTA_WORKSPACE"], username=os.environ["CLICKZETTA_USERNAME"],
+    password=os.environ["CLICKZETTA_PASSWORD"],
+    vcluster=os.environ.get("CLICKZETTA_VCLUSTER", "default_ap"),
+    schema=os.environ.get("CLICKZETTA_SCHEMA", "public"),
+)
+cursor = conn.cursor()
+cursor.execute("CREATE TABLE IF NOT EXISTS ds_workspace.my_table (col1 STRING, col2 BIGINT, col3 DOUBLE)")
+rows = local_df.values.tolist()
+for i in range(0, len(rows), 500):
+    batch = rows[i:i+500]
+    vals = ",".join(f"({','.join(repr(v) for v in row)})" for row in batch)
+    cursor.execute(f"INSERT INTO ds_workspace.my_table VALUES {vals}")
+conn.close()
+```
+
+```sql
+-- 设置中间表生命周期（30 天自动清理）
+ALTER TABLE ds_workspace.orders_clean SET PROPERTIES ('data_lifecycle' = '30');
+```
+
+---
+
+## 特征工程
+
+```sql
+-- SQL 侧（利用 Lakehouse 算力，推荐）
+SELECT
+    user_id,
+    COUNT(*)                                                    AS order_cnt_30d,
+    SUM(amount)                                                 AS total_amount_30d,
+    AVG(amount)                                                 AS avg_amount_30d,
+    STDDEV(amount)                                              AS std_amount_30d,
+    DATEDIFF('day', MIN(order_date), MAX(order_date))           AS active_days,
+    COUNT(DISTINCT DATE(order_date))                            AS active_day_cnt,
+    NTILE(10) OVER (ORDER BY SUM(amount) DESC)                  AS revenue_decile
+FROM my_schema.orders
+WHERE order_date >= CURRENT_DATE - INTERVAL 30 DAY
+GROUP BY user_id;
+```
+
+```python
+# ZettaPark 侧（Python 逻辑）
+from clickzetta.zettapark.functions import col, when
+
+features = session.table("ds_workspace.orders_clean") \
+    .with_column("is_high_value", when(col("amount") > 1000, 1).otherwise(0))
+
+df = features.to_pandas()
+
+from sklearn.preprocessing import StandardScaler
+df[['amount_scaled']] = StandardScaler().fit_transform(df[['amount']])
+
+session.create_dataframe(df).write.mode("overwrite").save_as_table("ds_workspace.features_final")
+```
+
+---
+
+## 模型推理上线
+
+### BITMAP 用户画像
+
+```sql
+CREATE TABLE ds_workspace.user_tags AS
+SELECT tag_name, group_bitmap_state(user_id) AS user_bitmap
+FROM my_schema.user_behavior GROUP BY tag_name;
+
+-- 人群交集
+SELECT bitmap_count(bitmap_and(
+    (SELECT user_bitmap FROM ds_workspace.user_tags WHERE tag_name = '高消费'),
+    (SELECT user_bitmap FROM ds_workspace.user_tags WHERE tag_name = '近30天活跃')
+)) AS target_user_count;
+```
+
+### SQL UDF 批量推理
+
+```sql
+-- 调用已部署的模型 UDF（必须用完整 schema 路径）
+INSERT INTO ds_workspace.predictions
+SELECT user_id,
+       ds_workspace.credit_score_model(total_amount_30d, order_cnt_30d, active_days, avg_amount_30d) AS score,
+       CURRENT_TIMESTAMP() AS predict_time
+FROM ds_workspace.features_final;
+```
+
+### 向量检索
+
+```sql
+SELECT candidate_id,
+       cosine_distance(
+           (SELECT embedding FROM ds_workspace.user_embeddings WHERE user_id = 'target'),
+           embedding
+       ) AS similarity
+FROM ds_workspace.user_embeddings
+WHERE user_id != 'target'
+ORDER BY similarity LIMIT 10;
+```

package/bin/skills/clickzetta-data-science/references/zettapark-api.md

@@ -0,0 +1,156 @@
+# ZettaPark API 数据科学常用操作
+
+> 来源：https://www.yunqi.tech/documents/ZettaparkQuickStart
+> **Python 版本**：推荐 3.12（最低 3.10）。安装：`python3.12 -m venv .venv && pip install clickzetta_zettapark_python`
+
+---
+
+## Session 创建
+
+```python
+from clickzetta.zettapark.session import Session
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+session = Session.builder.configs({
+    "service":   os.environ["CLICKZETTA_SERVICE"],
+    "instance":  os.environ["CLICKZETTA_INSTANCE"],
+    "workspace": os.environ["CLICKZETTA_WORKSPACE"],
+    "username":  os.environ["CLICKZETTA_USERNAME"],
+    "password":  os.environ["CLICKZETTA_PASSWORD"],
+    "vcluster":  os.environ["CLICKZETTA_VCLUSTER"],
+    "schema":    os.environ.get("CLICKZETTA_SCHEMA", "public"),
+    "hints": {
+        "sdk.job.timeout": 300,
+        "query_tag": "ds_notebook"
+    }
+}).create()
+```
+
+---
+
+## 数据读取
+
+```python
+# 读取整张表
+df = session.table("my_schema.orders")
+
+# 执行 SQL 查询
+df = session.sql("SELECT * FROM my_schema.orders WHERE amount > 100")
+
+# 转为 pandas（小数据集）
+pandas_df = df.to_pandas()
+
+# 分批读取大表（避免 OOM）
+pandas_df = session.sql("""
+    SELECT * FROM my_schema.events
+    TABLESAMPLE ROW (1)   -- 1% 精确采样
+""").to_pandas()
+
+# 只获取前 N 行
+pandas_df = df.limit(10000).to_pandas()
+```
+
+---
+
+## DataFrame 变换
+
+```python
+from clickzetta.zettapark.functions import col, when, lit, sum as F_sum, count as F_count, avg as F_avg
+
+# 过滤
+df_filtered = df.filter(col("amount") > 0)
+df_filtered = df.filter((col("status") == "COMPLETED") & (col("amount") > 100))
+
+# 选择列
+df_selected = df.select("user_id", "amount", "order_date")
+
+# 新增列
+df = df.with_column("log_amount", col("amount").cast("double"))
+df = df.with_column("is_high_value", when(col("amount") > 1000, 1).otherwise(0))
+
+# 聚合
+agg_df = df.group_by("user_id").agg(
+    F_sum("amount").as_("total_amount"),
+    F_count("order_id").as_("order_cnt"),
+    F_avg("amount").as_("avg_amount")
+)
+
+# JOIN
+result = orders.join(users, orders["user_id"] == users["user_id"], "left")
+
+# 排序
+df_sorted = df.sort(col("amount").desc())
+```
+
+---
+
+## 数据写回
+
+```python
+# 覆盖写入（常用于特征表更新）
+df.write.mode("overwrite").save_as_table("ds_workspace.features_v1")
+
+# 追加写入（常用于预测结果）
+df.write.mode("append").save_as_table("ds_workspace.predictions")
+
+# pandas DataFrame 写回
+import pandas as pd
+local_df = pd.DataFrame({"user_id": [1, 2], "score": [0.8, 0.6]})
+session.create_dataframe(local_df).write.mode("overwrite") \
+    .save_as_table("ds_workspace.model_scores")
+```
+
+---
+
+## 与 pandas/scikit-learn 集成
+
+```python
+import pandas as pd
+import numpy as np
+from sklearn.preprocessing import StandardScaler
+from sklearn.model_selection import train_test_split
+from sklearn.ensemble import GradientBoostingClassifier
+
+# 1. 从 Lakehouse 拉特征
+features_df = session.sql("""
+    SELECT user_id, total_amount_30d, order_cnt_30d,
+           active_days, avg_amount_30d, label
+    FROM ds_workspace.features_final
+""").to_pandas()
+
+# 2. 本地处理
+X = features_df.drop(["user_id", "label"], axis=1)
+y = features_df["label"]
+
+scaler = StandardScaler()
+X_scaled = scaler.fit_transform(X)
+
+X_train, X_test, y_train, y_test = train_test_split(X_scaled, y, test_size=0.2)
+
+# 3. 训练模型
+model = GradientBoostingClassifier(n_estimators=100)
+model.fit(X_train, y_train)
+
+# 4. 预测并写回
+features_df["predicted_score"] = model.predict_proba(X_scaled)[:, 1]
+session.create_dataframe(
+    features_df[["user_id", "predicted_score"]]
+).write.mode("overwrite").save_as_table("ds_workspace.predictions")
+
+# 5. 保存模型
+import joblib
+joblib.dump(model, "models/gbm_model.pkl")
+joblib.dump(scaler, "models/scaler.pkl")
+```
+
+---
+
+## 注意事项
+
+- `to_pandas()` 会把数据全部拉到本地内存，大表必须先 `TABLESAMPLE` 或 `LIMIT`
+- `collect()` 返回 Row 对象列表，`to_pandas()` 返回 DataFrame，数据科学场景用后者
+- ZettaPark 的 DataFrame 操作是懒执行，只有 `to_pandas()`/`collect()`/`show()`/`save_as_table()` 才真正触发计算
+- 写回时推荐用 `ds_workspace` 这样的专属 Schema，与生产数据隔离

package/bin/skills/clickzetta-data-sharing/LICENSE

@@ -0,0 +1,16 @@
+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-data-sharing/SKILL.md

@@ -0,0 +1,160 @@
+---
+name: clickzetta-data-sharing
+description: |
+  管理 ClickZetta Lakehouse 跨账户/跨实例数据分享（Share）。无需复制数据，
+  实时共享表或视图给其他服务实例。覆盖提供方完整流程（CREATE SHARE →
+  GRANT TO SHARE → ALTER SHARE ADD INSTANCE）和消费方流程
+  （SHOW SHARES → DESC SHARE → CREATE SCHEMA FROM SHARE → 查询）。
+  当用户说"数据分享"、"数据共享"、"Share"、"跨账户共享"、"跨实例共享"、
+  "CREATE SHARE"、"GRANT TO SHARE"、"CREATE SCHEMA FROM SHARE"、
+  "无复制共享"、"分享数据给其他公司"、"接收共享数据"、"INBOUND"、"OUTBOUND"时触发。
+  Keywords: data sharing, SHARE, cross-account, cross-instance, provider, consumer
+---
+
+# ClickZetta 数据分享
+
+数据分享（Share）实现跨账户/跨实例的**无复制、实时只读**数据共享。提供方授权数据，消费方直接查询，无需数据同步。
+
+阅读 [references/share-ddl.md](references/share-ddl.md) 了解完整语法。
+
+> ⚠️ 创建 Share 需要 `instance_admin` 角色。
+
+---
+
+## 提供方：分享数据（3步）
+
+### 步骤 1：创建 Share 对象
+
+```sql
+CREATE SHARE my_share;
+```
+
+### 步骤 2：将表/视图加入 Share
+
+```sql
+-- 分享指定表
+GRANT SELECT, READ METADATA ON TABLE public.orders TO SHARE my_share;
+
+-- 分享视图（推荐：用视图控制分享字段和行范围）
+GRANT SELECT, READ METADATA ON VIEW public.orders_public_view TO SHARE my_share;
+
+-- 分享多张表
+GRANT SELECT, READ METADATA ON TABLE public.orders, public.customers TO SHARE my_share;
+```
+
+### 步骤 3：指定接收方实例
+
+```sql
+-- 添加接收方（消费方提供其实例名称）
+ALTER SHARE my_share ADD INSTANCE consumer_instance_id;
+```
+
+---
+
+## 消费方：使用共享数据（3步）
+
+### 步骤 1：查看收到的 Share
+
+```sql
+SHOW SHARES WHERE kind = 'INBOUND';
+```
+
+### 步骤 2：查看 Share 内容
+
+```sql
+-- 格式：DESC SHARE <提供方实例名>.<share名>
+DESC SHARE provider_instance.my_share;
+```
+
+### 步骤 3：创建本地只读 Schema
+
+```sql
+-- 格式：CREATE SCHEMA <本地名> FROM SHARE SHARE <实例>.<share>.<schema>
+CREATE SCHEMA shared_data FROM SHARE SHARE provider_instance.my_share.public;
+
+-- 直接查询
+SELECT * FROM shared_data.orders LIMIT 10;
+
+-- 与本地表关联
+SELECT o.*, c.region
+FROM shared_data.orders o
+JOIN my_schema.dim_customer c ON o.customer_id = c.id;
+```
+
+---
+
+## 管理操作
+
+```sql
+-- 查看所有 Share（含 INBOUND/OUTBOUND）
+SHOW SHARES;
+
+-- 只看分享出去的
+SHOW SHARES WHERE kind = 'OUTBOUND';
+
+-- 查看 Share 包含的对象
+DESC SHARE my_share;
+
+-- 撤销某张表的分享
+REVOKE SELECT, READ METADATA ON TABLE public.orders FROM SHARE my_share;
+
+-- 移除接收方（立即生效）
+ALTER SHARE my_share REMOVE INSTANCE consumer_instance_id;
+
+-- 删除 Share
+DROP SHARE IF EXISTS my_share;
+```
+
+---
+
+## 典型场景
+
+### 场景：A 公司向 B 公司分享数据
+
+**A 公司（提供方）操作：**
+
+```sql
+-- 1. 创建 Share
+CREATE SHARE partner_share;
+
+-- 2. 创建视图控制分享范围（只分享脱敏后的数据）
+CREATE VIEW public.orders_for_partner AS
+SELECT order_id, product_id, amount, order_date
+FROM public.orders
+WHERE status = 'completed';
+
+-- 3. 将视图加入 Share
+GRANT SELECT, READ METADATA ON VIEW public.orders_for_partner TO SHARE partner_share;
+
+-- 4. 指定 B 公司实例（B 公司提供其实例名）
+ALTER SHARE partner_share ADD INSTANCE b_company_instance;
+```
+
+**B 公司（消费方）操作：**
+
+```sql
+-- 1. 查看收到的 Share
+SHOW SHARES WHERE kind = 'INBOUND';
+
+-- 2. 查看内容
+DESC SHARE a_company_instance.partner_share;
+
+-- 3. 创建本地 Schema
+CREATE SCHEMA a_company_data FROM SHARE SHARE a_company_instance.partner_share.public;
+
+-- 4. 查询使用
+SELECT * FROM a_company_data.orders_for_partner
+WHERE order_date >= '2024-01-01';
+```
+
+---
+
+## 常见问题
+
+| 问题 | 原因 | 解决方案 |
+|---|---|---|
+| CREATE SHARE 报权限不足 | 需要 instance_admin 角色 | 联系管理员授予 instance_admin |
+| 消费方看不到 Share | 提供方未 ADD INSTANCE | 提供方执行 `ALTER SHARE ADD INSTANCE` |
+| DESC SHARE 报错 | instance_name 填错 | 通过 `SHOW SHARES` 确认 provider_instance 字段 |
+| 共享 Schema 下查不到表 | GRANT 时未包含该表 | 提供方重新 `GRANT ... TO SHARE` |
+| 想只分享部分列/行 | 直接分享表会暴露全量数据 | 创建 VIEW 过滤后再分享 VIEW |

package/bin/skills/clickzetta-data-sharing/eval_cases.jsonl

@@ -0,0 +1,3 @@
+{"case_id":"001","type":"should_call","user_input":"怎么把表数据分享给另一个实例？不复制数据的那种","expected_skill":"clickzetta-data-sharing","expected_output_contains":["CREATE SHARE","GRANT"]}
+{"case_id":"002","type":"should_call","user_input":"作为消费方，怎么接收别人分享的数据？","expected_skill":"clickzetta-data-sharing","expected_output_contains":["SHOW SHARES","CREATE SCHEMA FROM SHARE"]}
+{"case_id":"003","type":"should_call","user_input":"数据分享的提供方完整流程是什么？","expected_skill":"clickzetta-data-sharing","expected_output_contains":["SHARE","GRANT","INSTANCE"]}