@clickzetta/cz-cli-linux-x64 0.3.2 → 0.3.5

package/bin/skills/clickzetta-information-schema/references/metering-views-reference.md

@@ -1,137 +0,0 @@
-# 费用计量视图字段说明
-
-> 已通过实际 Lakehouse 连接验证（cn-shanghai-alicloud, f8866243）
-> 访问路径：`SYS.information_schema.<视图名>`
-> 权限要求：INSTANCE ADMIN
-
----
-
-## STORAGE_METERING 视图
-
-存储费用明细，按天、按工作空间、按 SKU 记录存储计量数据。
-
-实际字段（16列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| ACCOUNT_ID | BIGINT | 账户 ID |
-| ACCOUNT_NAME | STRING | 账户名称 |
-| INSTANCE_ID | BIGINT | 实例 ID |
-| REGION_NAME | STRING | 地域名称（如 阿里云-华东2（上海）） |
-| SKU_CATEGORY | STRING | 费用类别：`storage` / `network` |
-| SKU_NAME | STRING | 具体 SKU 名称（见下表） |
-| WORKSPACE_ID | BIGINT | 工作空间 ID |
-| WORKSPACE_NAME | STRING | 工作空间名称 |
-| MEASUREMENT_START | TIMESTAMP | 计量周期开始时间（通常为某天 00:00:00） |
-| MEASUREMENT_END | TIMESTAMP | 计量周期结束时间（通常为某天 23:59:59） |
-| MEASUREMENTS_UNIT | STRING | 计量单位（如 `yuan/GB/day`、`yuan/gb`、`none`） |
-| MEASUREMENTS_CONSUMPTION | DECIMAL | 消耗量（单位由 MEASUREMENTS_UNIT 决定） |
-| PRICE_RATE | DECIMAL | 单价 |
-| AMOUNT | DECIMAL | 费用金额（元） |
-| DISCOUNT_RATE | DECIMAL | 折扣率（1.0 = 无折扣） |
-| TOTAL_AFTER_DISCOUNT | DECIMAL | 折后金额（元） |
-
-### SKU 枚举值
-
-| SKU_CATEGORY | SKU_NAME | MEASUREMENTS_UNIT | 说明 |
-|---|---|---|---|
-| storage | 托管存储容量 | yuan/GB/day | 内部表数据文件存储 |
-| storage | 多版本未删除存储 | none | Time Travel 历史版本存储 |
-| network | 数据查询Internet数据传输 | yuan/gb | 公网数据传输 |
-
----
-
-## INSTANCE_USAGE 视图
-
-计算费用明细，按天、按工作空间、按 SKU 记录计算资源使用数据。
-
-实际字段（16列，与 STORAGE_METERING 相同结构）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| ACCOUNT_ID | BIGINT | 账户 ID |
-| ACCOUNT_NAME | STRING | 账户名称 |
-| INSTANCE_ID | BIGINT | 实例 ID |
-| REGION_NAME | STRING | 地域名称 |
-| SKU_CATEGORY | STRING | 费用类别：`compute` |
-| SKU_NAME | STRING | 具体 SKU 名称（见下表） |
-| WORKSPACE_ID | BIGINT | 工作空间 ID |
-| WORKSPACE_NAME | STRING | 工作空间名称 |
-| MEASUREMENT_START | TIMESTAMP | 计量周期开始时间 |
-| MEASUREMENT_END | TIMESTAMP | 计量周期结束时间 |
-| MEASUREMENTS_UNIT | STRING | 计量单位（`yuan/cru`） |
-| MEASUREMENTS_CONSUMPTION | DECIMAL | 消耗的 CRU 量 |
-| PRICE_RATE | DECIMAL | 单价（元/CRU） |
-| AMOUNT | DECIMAL | 费用金额（元） |
-| DISCOUNT_RATE | DECIMAL | 折扣率 |
-| TOTAL_AFTER_DISCOUNT | DECIMAL | 折后金额（元） |
-
-### SKU 枚举值
-
-| SKU_CATEGORY | SKU_NAME | 说明 |
-|---|---|---|
-| compute | AP类型计算集群 | 分析型 VCluster 费用 |
-| compute | GP类型计算集群 | 通用型 VCluster 费用 |
-| compute | 任务调度 | Studio 任务调度费用 |
-| compute | 数据集成 | 离线/实时同步任务费用 |
-| compute | 流式集成 | 流式数据集成费用 |
-
----
-
-## 常用费用查询
-
-```sql
--- 本月各工作空间计算费用汇总
-SELECT workspace_name,
-       sku_name,
-       ROUND(SUM(measurements_consumption), 2) AS total_cru,
-       ROUND(SUM(amount), 2) AS total_yuan
-FROM SYS.information_schema.instance_usage
-WHERE measurement_start >= DATE_TRUNC('month', CURRENT_DATE)
-GROUP BY workspace_name, sku_name
-ORDER BY total_yuan DESC;
-
--- 本月各工作空间存储费用汇总
-SELECT workspace_name,
-       sku_name,
-       ROUND(SUM(measurements_consumption), 4) AS consumption,
-       measurements_unit,
-       ROUND(SUM(amount), 4) AS total_yuan
-FROM SYS.information_schema.storage_metering
-WHERE measurement_start >= DATE_TRUNC('month', CURRENT_DATE)
-GROUP BY workspace_name, sku_name, measurements_unit
-ORDER BY workspace_name, total_yuan DESC;
-
--- 按天统计计算费用趋势（最近 30 天）
-SELECT DATE(measurement_start) AS dt,
-       sku_name,
-       ROUND(SUM(amount), 2) AS daily_yuan
-FROM SYS.information_schema.instance_usage
-WHERE measurement_start >= CURRENT_DATE - INTERVAL 30 DAY
-GROUP BY DATE(measurement_start), sku_name
-ORDER BY dt, daily_yuan DESC;
-
--- 存储 + 计算综合费用（本月）
-SELECT cost_type, workspace_name,
-       ROUND(SUM(amount), 2) AS total_yuan
-FROM (
-  SELECT 'compute' AS cost_type, workspace_name, amount
-  FROM SYS.information_schema.instance_usage
-  WHERE measurement_start >= DATE_TRUNC('month', CURRENT_DATE)
-  UNION ALL
-  SELECT 'storage' AS cost_type, workspace_name, amount
-  FROM SYS.information_schema.storage_metering
-  WHERE measurement_start >= DATE_TRUNC('month', CURRENT_DATE)
-) t
-GROUP BY cost_type, workspace_name
-ORDER BY cost_type, total_yuan DESC;
-```
-
----
-
-## 注意事项
-
-- 两个视图数据保留范围：从实例创建起至今（验证数据最早可追溯到 2025-01）
-- `WORKSPACE_NAME` 可能为 NULL（对应实例级别的费用，不归属特定工作空间）
-- `AMOUNT` 字段为实际计费金额（元），`TOTAL_AFTER_DISCOUNT` 为折后金额
-- 与 `JOB_HISTORY.CRU` 的区别：JOB_HISTORY 记录单次作业的 CRU 消耗，INSTANCE_USAGE 是按天汇总的计费数据，含金额

package/bin/skills/clickzetta-information-schema/references/views-reference.md

@@ -1,271 +0,0 @@
-# 空间级 INFORMATION_SCHEMA 视图字段说明
-
-> 来源：https://www.yunqi.tech/documents/worksapce-informaiton_schema-views
-> 已通过实际 Lakehouse 连接验证（cn-shanghai-alicloud, f8866243, quick_start）
-
-访问路径：`information_schema.<视图名>`
-权限要求：workspace_admin
-
----
-
-## SCHEMAS 视图
-
-实际字段（8列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| CATALOG_NAME | STRING | 当前 WORKSPACE 的名称 |
-| SCHEMA_NAME | STRING | Schema 名称 |
-| TYPE | STRING | EXTERNAL（外部）/ MANAGED（内部） |
-| SCHEMA_CREATOR | STRING | Schema 所有者账号名称 |
-| CREATE_TIME | TIMESTAMP | 创建时间 |
-| LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
-| COMMENT | STRING | 创建时的注释 |
-| PROPERTIES | ARRAY | 自定义属性 |
-
----
-
-## TABLES 视图
-
-实际字段（14列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| TABLE_CATALOG | STRING | 当前 WORKSPACE 名称 |
-| TABLE_SCHEMA | STRING | 所属 Schema |
-| TABLE_NAME | STRING | 表名 |
-| TABLE_CREATOR | STRING | 表所有者账号名称 |
-| TABLE_TYPE | STRING | MANAGED_TABLE / EXTERNAL_TABLE / VIRTUAL_VIEW / MATERIALIZED_VIEW |
-| ROW_COUNT | BIGINT | 行数（估计值，VIEW 为 NULL） |
-| BYTES | BIGINT | 存储大小字节（估计值，VIEW 为 NULL） |
-| CREATE_TIME | TIMESTAMP | 创建时间 |
-| LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
-| IS_PARTITIONED | BOOLEAN | 是否分区表 |
-| IS_CLUSTERED | BOOLEAN | 是否分桶表 |
-| COMMENT | STRING | 表注释 |
-| PROPERTIES | ARRAY | 自定义属性 |
-| DATA_LIFECYCLE | BIGINT | 生命周期（天），-1 表示永久 |
-
----
-
-## COLUMNS 视图
-
-实际字段（11列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| TABLE_CATALOG | STRING | 当前 WORKSPACE 名称 |
-| TABLE_SCHEMA | STRING | 所属 Schema |
-| TABLE_NAME | STRING | 表名 |
-| COLUMN_NAME | STRING | 字段名 |
-| COLUMN_DEFAULT | STRING | 字段默认值 |
-| IS_NULLABLE | BOOLEAN | 是否可为 NULL |
-| DATA_TYPE | STRING | 字段类型 |
-| COMMENT | STRING | 字段注释 |
-| IS_PRIMARY_KEY | BOOLEAN | 是否主键 |
-| IS_CLUSTERING_COLUMN | BOOLEAN | 是否 CLUSTER 字段 |
-| CREATE_TIME | TIMESTAMP | 表创建时间 |
-
----
-
-## VIEWS 视图
-
-实际字段（8列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| TABLE_CATALOG | STRING | 当前 WORKSPACE 名称 |
-| TABLE_SCHEMA | STRING | 所属 Schema |
-| TABLE_NAME | STRING | 视图名 |
-| TABLE_CREATOR | STRING | 视图所有者账号名称 |
-| VIEW_DEFINITION | STRING | 创建视图的 SQL 语句 |
-| CREATE_TIME | TIMESTAMP | 创建时间 |
-| LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
-| COMMENT | STRING | 视图注释 |
-
----
-
-## USERS 视图
-
-实际字段（8列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 空间名称 |
-| USER_NAME | STRING | 用户名称 |
-| ROLE_NAMES | STRING | 拥有的角色（多个用逗号分隔）⚠️ 注意：是 ROLE_NAMES 不是 ROLE_NAME |
-| CREATE_TIME | TIMESTAMP | 用户加入时间 |
-| EMAIL | STRING | 用户邮箱 |
-| TELPHONE | STRING | 用户电话 ⚠️ 注意：拼写为 TELPHONE（非 TELEPHONE） |
-| COMMENT | STRING | 描述信息 |
-| PROPERTIES | ARRAY | 保留字段 |
-
----
-
-## ROLES 视图
-
-实际字段（5列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 空间名称 |
-| ROLE_NAME | STRING | 角色名称 |
-| USER_NAMES | STRING | 被授予该角色的用户（逗号分隔） |
-| COMMENT | STRING | 描述信息 |
-| PROPERTIES | ARRAY | 保留字段 |
-
-注意：无 `CREATE_TIME` 字段。
-
----
-
-## JOB_HISTORY 视图
-
-实际字段（31列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 作业所在空间 |
-| WORKSPACE_ID | BIGINT | 空间 ID |
-| JOB_ID | STRING | 作业 ID |
-| JOB_NAME | STRING | 作业名称 |
-| JOB_CREATOR | STRING | 执行用户 |
-| STATUS | STRING | SUCCEED / FAILED / CANCELLED / RUNNING |
-| CRU | DECIMAL | 消耗的计算资源 |
-| ERROR_MESSAGE | STRING | 错误信息（失败时有值） |
-| JOB_TYPE | STRING | 作业类型：SQL_JOB 等 |
-| JOB_SUB_TYPE | STRING | 作业子类型 |
-| JOB_TEXT | STRING | 执行的 SQL 语句 |
-| START_TIME | TIMESTAMP | 开始时间 |
-| END_TIME | TIMESTAMP | 结束时间 |
-| EXECUTION_TIME | DOUBLE | 执行时间（秒） |
-| INPUT_OBJECTS | STRING | 输入表名（schema.table 格式） |
-| OUTPUT_OBJECTS | STRING | 输出表名 |
-| INPUT_TABLES | STRING | 输入表详情（JSON 格式） |
-| OUTPUT_TABLES | STRING | 输出表详情（JSON 格式） |
-| INPUT_BYTES | BIGINT | 实际扫描数据量 |
-| OUTPUT_BYTES | BIGINT | 输出字节数 |
-| CACHE_HIT | BIGINT | 从缓存读取的数据量 |
-| ROWS_PRODUCED | BIGINT | 处理的总记录数 ⚠️ 注意：是 ROWS_PRODUCED 不是 ROW_PRODUCED |
-| ROWS_INSERTED | BIGINT | 插入行数 ⚠️ 注意：是 ROWS_INSERTED 不是 ROW_INSERTED |
-| ROWS_UPDATED | BIGINT | 更新行数 ⚠️ 注意：是 ROWS_UPDATED 不是 ROW_UPDATED |
-| ROWS_DELETED | BIGINT | 删除行数 ⚠️ 注意：是 ROWS_DELETED 不是 ROW_DELETED |
-| VIRTUAL_CLUSTER | STRING | 使用的计算集群 |
-| JOB_CONFIG | STRING | 提交时的参数信息（JSON） |
-| JOB_PRIORITY | STRING | 作业优先级 |
-| QUERY_TAG | STRING | 用户设置的 TAG |
-| CLIENT_INFO | STRING | 客户端信息（JDBC/SDK/Web） |
-| PT_DATE | DATE | 分区日期（用于按日期过滤，性能更好） |
-
----
-
-## MATERIALIZED_VIEW_REFRESH_HISTORY 视图
-
-实际字段（12列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 空间名称 |
-| SCHEMA_NAME | STRING | Schema 名称 |
-| MATERIALIZED_VIEW_NAME | STRING | 物化视图名称 |
-| CRU | DECIMAL | 刷新消耗的计费 |
-| VIRTUAL_CLUSTER_NAME | STRING | 使用的虚拟集群 |
-| STATUS | STRING | SUCCEED / FAILED / RUNNING |
-| SCHEDULED_START_TIME | TIMESTAMP | 计划刷新时间 |
-| START_TIME | TIMESTAMP | 实际开始时间 |
-| END_TIME | TIMESTAMP | 结束时间 |
-| ERROR_CODE | STRING | 错误码 |
-| ERROR_MESSAGE | STRING | 刷新失败信息 |
-| PT_DATE | DATE | 分区日期 |
-
----
-
-## AUTOMV_REFRESH_HISTORY 视图
-
-实际字段（12列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 空间名称 |
-| SCHEMA_NAME | STRING | Schema 名称 |
-| MATERIALIZED_VIEW_NAME | STRING | 物化视图名称 |
-| CRU | DECIMAL | 刷新消耗的计费 |
-| STATUS | STRING | PROCESSING / SUCCEEDED / FAILED / CANCELLED |
-| MV_PROCESS_TYPE | STRING | BUILD（构建）/ REFRESH（刷新） |
-| START_TIME | TIMESTAMP | 开始时间 |
-| END_TIME | TIMESTAMP | 结束时间 |
-| BUILD_FROM_WORKSPACE | STRING | 构建 MV 对应的源表空间 |
-| JOB_ID | STRING | 构建 MV 的作业 ID |
-| ERROR_MESSAGE | STRING | 刷新失败信息 |
-| PT_DATE | DATE | 分区日期 |
-
----
-
-## VOLUMES 视图
-
-实际字段（12列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| VOLUME_CATALOG | STRING | 所属 Workspace 名称 |
-| VOLUME_SCHEMA | STRING | 所属 Schema 名称 |
-| VOLUME_NAME | STRING | Volume 名称 |
-| VOLUME_URL | STRING | Volume 绑定的 URL |
-| VOLUME_REGION | STRING | Volume 所属区域 |
-| VOLUME_TYPE | STRING | INTERNAL / EXTERNAL |
-| VOLUME_CREATOR | STRING | Volume 的 owner |
-| CONNECTION_NAME | STRING | 引用的 Connection 名称 |
-| COMMENT | STRING | 注释 |
-| PROPERTIES | ARRAY | 保留字段 |
-| CREATE_TIME | TIMESTAMP | 创建时间 |
-| LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
-
----
-
-## CONNECTIONS 视图
-
-实际字段（11列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| WORKSPACE_NAME | STRING | 所在空间 |
-| CONNECTION_NAME | STRING | 连接对象名称 |
-| CONNECTION_KIND | STRING | STORAGE / API |
-| TYPE | STRING | FILE_SYSTEM（存储）/ CLOUD_FUNCTION（云函数） |
-| PROVIDER | STRING | FILE_SYSTEM 时：OSS / COS；CLOUD_FUNCTION 时：aliyun / tencent |
-| REGION | STRING | 连接的 region（如 ap-shanghai / cn-beijing） |
-| SOURCE_CREATOR | STRING | 创建者 |
-| CREATE_TIME | TIMESTAMP | 创建时间 ⚠️ 注意：是 CREATE_TIME 不是 CREATED_TIME |
-| LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
-| COMMENT | STRING | 注释 |
-| PROPERTIES | ARRAY | 保留字段 |
-
----
-
-## SORTKEY_CANDIDATES 视图
-
-实际字段（12列）：
-
-| 字段名 | 类型 | 说明 |
-|---|---|---|
-| INSTANCE_ID | STRING | 实例 ID |
-| WORKSPACE_ID | BIGINT | 空间 ID |
-| WORKSPACE_NAME | STRING | 空间名称 |
-| SCHEMA_ID | BIGINT | Schema ID |
-| SCHEMA_NAME | STRING | Schema 名称 |
-| TABLE_ID | BIGINT | 表 ID |
-| TABLE_NAME | STRING | 表名 |
-| COL | STRING | 推荐作为排序列的字段名 |
-| STATEMENT | STRING | 对应的 ALTER TABLE 设置 SQL |
-| RATIO | DOUBLE | 预估提升效果比例 |
-| INSERT_TIME | TIMESTAMP | 记录插入时间 |
-| P_DATE | DATE | 分区日期 |
-
----
-
-## 授权管理
-
-```sql
--- 授予用户查询 information_schema 的权限
-GRANT ALL ON ALL VIEWS IN SCHEMA information_schema TO ROLE <role_name>;
-GRANT ALL ON ALL VIEWS IN SCHEMA information_schema TO USER <user_name>;
-```

package/bin/skills/clickzetta-java-sdk/SKILL.md

@@ -1,186 +0,0 @@
----
-name: clickzetta-java-sdk
-description: |
-  使用 ClickZetta Java SDK 将数据批量或实时写入 Lakehouse 表。
-  覆盖 BulkloadStream（本地文件/数据库批量上传）和 RealtimeStream（Kafka 实时消费写入）
-  两种接口的完整使用模式，包括 Maven 依赖、连接 URL 格式、行写入 API、
-  状态监控、Options 调优和常见错误处理。
-  当用户说"Java SDK"、"BulkloadStream"、"RealtimeStream"、
-  "Java 写入 Lakehouse"、"Java 批量上传"、"Kafka Java 写入"、
-  "clickzetta-java"、"Maven 依赖"、"Java 数据导入"时触发。
-  Keywords: Java SDK, BulkloadStream, RealtimeStream, Kafka consumer, batch write, real-time write
----
-
-# ClickZetta Java SDK
-
-Java SDK 提供两种写入接口：
-- **BulkloadStream** — 批量写入，适合定时 ETL、本地文件导入（不支持主键表，不适合 5 分钟以内的高频写入）
-- **RealtimeStream** — 实时写入，适合 Kafka 消费、流式数据接入（秒级可查）
-
-阅读 [references/bulkload.md](references/bulkload.md) 了解批量写入，[references/realtime.md](references/realtime.md) 了解实时写入。
-
----
-
-## Maven 依赖
-
-```xml
-<!-- clickzetta-java 最新版本见 https://central.sonatype.com/artifact/com.clickzetta/clickzetta-java -->
-<dependency>
-    <groupId>com.clickzetta</groupId>
-    <artifactId>clickzetta-java</artifactId>
-    <version>2.0.0</version>
-</dependency>
-```
-
-RealtimeStream + Kafka 还需要：
-
-```xml
-<dependency>
-    <groupId>org.apache.kafka</groupId>
-    <artifactId>kafka-clients</artifactId>
-    <version>3.2.0</version>
-</dependency>
-```
-
----
-
-## 连接 URL 格式
-
-```java
-// 推荐：显式参数方式（2.0.0+ 支持，不依赖 URL 解析）
-ClickZettaClient client = ClickZettaClient.newBuilder()
-    .service("cn-shanghai-alicloud.api.clickzetta.com")
-    .instance("your_instance")
-    .workspace("your_workspace")
-    .schema("public")
-    .username("your_user")
-    .password("your_password")
-    .vcluster("default")
-    .build();
-
-// 兼容：URL 方式（BulkloadStream 用 virtualcluster=，RealtimeStream 用 vcluster=）
-String bulkUrl = MessageFormat.format(
-    "jdbc:clickzetta://{0}.{1}/{2}?schema={3}&username={4}&password={5}&virtualcluster={6}",
-    instance, region_endpoint, workspace, schema, username, password, vcluster
-);
-String rtUrl = MessageFormat.format(
-    "jdbc:clickzetta://{0}.{1}/{2}?schema={3}&username={4}&password={5}&vcluster={6}",
-    instance, region_endpoint, workspace, schema, username, password, vcluster
-);
-ClickZettaClient client = ClickZettaClient.newBuilder().url(url).build();
-```
-
-JDBC 连接（DDL / 查询）：
-
-```java
-// 2.0.0+ 驱动类：com.clickzetta.client.jdbc.ClickZettaDriver
-// 1.x 驱动类：com.clickzetta.jdbc.ClickZettaDriver
-Class.forName("com.clickzetta.client.jdbc.ClickZettaDriver");
-Connection conn = DriverManager.getConnection(jdbcUrl);
-```
-
----
-
-## BulkloadStream 快速示例
-
-```java
-// 创建 BulkloadStream
-BulkloadStream stream = client.newBulkloadStreamBuilder()
-    .schema("public")
-    .table("orders")
-    .operate(RowStream.BulkLoadOperate.APPEND)
-    .build();
-
-// 写入数据（列索引从 0 开始，顺序与建表 DDL 一致）
-Row row = stream.createRow();
-row.setValue(0, "order-001");   // STRING
-row.setValue(1, 1);             // INT
-row.setValue(2, 299.99);        // DOUBLE
-stream.apply(row);              // ⚠️ 必须调用，否则数据不发送到服务端
-
-// 关闭并等待完成
-stream.close();
-while (stream.getState() == StreamState.RUNNING) {
-    Thread.sleep(1000);
-}
-if (stream.getState() == StreamState.FAILED) {
-    throw new RuntimeException(stream.getErrorMessage());
-}
-client.close();
-```
-
----
-
-## RealtimeStream 快速示例
-
-```java
-// Options 调优
-Options options = Options.builder()
-    .withMutationBufferLinesNum(10)  // 缓冲行数
-    .build();
-
-// 创建 RealtimeStream（普通表，APPEND_ONLY）
-RealtimeStream stream = client.newRealtimeStreamBuilder()
-    .operate(RowStream.RealTimeOperate.APPEND_ONLY)
-    .options(options)
-    .schema("public")
-    .table("events")
-    .build();
-
-// 写入数据（用列名，不用索引）
-Row row = stream.createRow(Stream.Operator.INSERT);
-row.setValue("id", 1);
-row.setValue("event", "{\"type\":\"click\"}");
-stream.apply(row);
-stream.close();
-```
-
-## RealtimeStream CDC 示例（主键表 UPSERT / DELETE）
-
-```java
-// 建表：CREATE TABLE orders (txid STRING NOT NULL PRIMARY KEY, amount DOUBLE, status STRING);
-
-RealtimeStream stream = client.newRealtimeStreamBuilder()
-    .operate(RowStream.RealTimeOperate.CDC)   // 主键表必须用 CDC
-    .options(options)
-    .schema("public")
-    .table("orders")
-    .build();
-
-// UPSERT：存在则更新，不存在则插入
-Row row = stream.createRow(Stream.Operator.UPSERT);
-row.setValue("txid", "order-001");
-row.setValue("amount", 299.99);
-row.setValue("status", "paid");
-stream.apply(row);
-
-// DELETE_IGNORE：删除，目标行不存在时自动忽略
-Row del = stream.createRow(Stream.Operator.DELETE_IGNORE);
-del.setValue("txid", "order-001");
-stream.apply(del);
-
-stream.close();
-```
-
----
-
-## 选择指南
-
-| 场景 | 推荐接口 |
-|---|---|
-| 定时批量 ETL（每小时/每天） | BulkloadStream |
-| Kafka 实时消费 | RealtimeStream |
-| 5 分钟以内高频写入 | RealtimeStream |
-| 主键表写入（UPSERT / DELETE） | RealtimeStream CDC 模式 |
-
----
-
-## 使用限制
-
-| 限制 | BulkloadStream | RealtimeStream |
-|---|---|---|
-| 主键表 | ❌ 不支持 | ✅ CDC 模式支持 |
-| 高频写入（< 5 分钟） | ❌ 不适合 | ✅ 支持 |
-| 数据可见延迟 | 写完 close() 后可见 | ~1 分钟后可见 |
-| Table Stream/Dynamic Table 可见 | close() 后 | ~1 分钟后 |
-| 表结构变更 | 重建 Stream | 停止任务，变更后约 90 分钟重启 |