@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/RN_2025-04-01.md

@@ -0,0 +1,74 @@
+# 2025年04月01日 Lakehouse Studio 产品更新发布说明
+
+本次发布（Release 2025.04.01, v1.8）引入了一系列新功能、增强特性以及修复项。请注意，这些更新将分阶段逐步推送至以下区域，更新将在发布日起一周至两周内完成，具体时间依据您所在的区域而定。
+
+* 腾讯云上海区
+* 腾讯云北京区
+* 腾讯云广州区
+* 阿里云上海区
+* 阿里云新加坡区
+* 亚马逊云科技新加坡区
+* 亚马逊云科技北京区
+
+***
+
+## 不兼容改动
+
+* 无
+
+## 新功能特性
+
+* **数据同步**：
+  * 多表实时同步：MySQL CDC 同步到 Lakehouse 表，支持将源端表和字段的注释同步到目标端。
+  * 离线同步：DynamoDB 支持写入用户自定义的字段类型。
+
+* **任务开发**：
+  * 查询结果新增可视化图表能力，支持将数据结果转化为可视化图表，并通过趋势图、柱状图等方式传达逻辑关系，辅助分析决策。详见：[数据可视化](../data_visualization.md)
+  * 任务组支持批量修改集群。
+  * 文件目录树支持按照文件 ID 进行检索过滤。
+
+* **计算集群**：
+  * 新增集群资源监控，可查看集群规格和实例数量的历史变化，了解集群自动扩缩容情况。
+  * 新增作业并发数监控，可查看作业并发情况，便于参考作业并发数和排队情况，调整计算集群资源规格。
+
+* **数据质量**：新增支持 [Pipe](../pipe-summary.md)、[Volume](../datalake_volume.md)、[Table Stream](../table_stream.md)三种类型对象的数据质量监控，例如消费堆积延迟等。
+
+* **管理中心**：支持对用户增加备注信息。
+
+* **安全中心**：增加支持实例级别自定义角色功能。实例级自定义角色可同时被授予多个工作空间内的数据权限，便于跨空间使用数据。
+
+## 优化改进
+
+* **产品全局**：
+  * 产品内区分强弱提示信息，将重要提示强化展示，以减少因未注意关键信息而导致的误操作。
+  * 优化个人信息弹窗的展示，将关键信息全部展示出来。
+  * 产品帮助文档的跳转地址已更改至产品官网。
+
+* **数据同步**
+  * 离线同步任务配置中，选择数据源时支持按照数据源类型和名称进行筛选过滤。
+  * 离线任务中，建表 DDL 语句对源表名中的特殊字符做兼容处理，自动转译为下划线以避免建表失败。
+
+* **任务开发**：
+  * 任务开发：代码中使用 `USE SCHEMA` 或 `USE VCLUSTER` 语句后，自动回显，并与页面配置的 Schema 和 VCluster 联动。
+  * 任务开发：任务组批量复制时，将复制后的任务合并至新文件夹时，支持不添加后缀的选项。
+  * 数据树下的表信息增加搜索功能，辅助用户快速搜索表中的列信息。
+  * 任务组支持添加虚拟节点。
+  * 可视化图表选择字段时支持模糊搜索。
+
+* **管理中心**：增加账号禁用和删除的强提示，提醒操作者在转交好任务等对象的负责人后再进行操作。
+
+## 缺陷修复
+
+* **管理中心**：修复新注册账号权限偶发初始化不全，影响功能使用的问题。
+* **数据同步**：修复Hive导入Lakehouse，源端报错情况下，目标表被清空的问题。
+* **数据同步**：修复Oracle数据源number\[1,6]字段和clob字段类型同步报错的问题。
+* **任务开发**：修复代码搜索中，输入关键字搜不到相应文件的问题。
+* **安全中心**：修复部分工作空间workspace\_dev角色权限授予不全的问题。
+* **运维中心**：修复补数任务中，应补数据实例因超过调度等待时长而被终止时，整体补数据状态未变更的问题。
+* **作业历史**：修复 `DESC` 语句渲染 Stage 的问题。
+
+## 已知局限
+
+* 本次版本更新无已知的新增的重大局限。
+
+^

package/bin/skills/lakehouse-doc/references/RN_2025-05-20.md

@@ -0,0 +1,90 @@
+# 2025年05月20日 Lakehouse Studio 产品更新发布说明
+
+本次发布（Release 2025.05.20）引入了一系列新功能、增强特性以及修复项。请注意，这些更新将分阶段逐步推送至以下区域，预计在发布日起一周至两周内完成，具体时间依据您所在的区域而定。
+
+* 腾讯云上海区
+* 腾讯云北京区
+* 腾讯云广州区
+* 阿里云上海区
+* 阿里云新加坡区
+* 亚马逊云新加坡区
+* 亚马逊云北京区
+
+## 不兼容改动
+
+* 无
+
+## 新功能特性
+
+#### 管理中心
+
+* 账户管理：新增实名认证功能，支持个人认证、企业认证2种认证方式。
+  ![](.topwrite/assets/image_1747738837213.png)
+* 账户资金：新增现金账户用于账号下账单费用的支付，账户余额随充值、账单出账变化，可查询余额交易明细；支持线上微信、支付宝充值，线下对公转账方式充值。
+  ![](.topwrite/assets/img_v3_02mf_1721a1c9-bc2c-4099-a386-7762a1eaf00g.gif)
+* 代金券：优化代金券功能，支持查询代金券抵扣明细、余额、有效期等。
+  ![](.topwrite/assets/image_1747738943656.png)
+
+#### 数据同步
+
+* 离线同步：导出到AWS S3上的csv文件，新增支持按制表符分割。
+* 离线同步：对目标端Lakehouse一键建表，新增支持自动感知源端主键表的PK字段并在建表语句中体现。
+* 实时同步：支持自定义扩展字段、并设定为联合主键，用于对源端数据进行额外标识场景。
+* 实时同步：在任务详情监控页面，新增展示源端需要全量同步的数据行数，便于判断整体数据量和同步进展。
+
+#### 任务开发
+
+* 任务组：新增任务组内添加下游节点、可视化图表增加分桶能力、全量下载历史管理的功能点，帮助您更高效地管理任务、分析数据和获取结果。具体功能点如下：
+  * 任务组：任务组新增支持基于某个节点批量添加其任务血缘链路中的下游子节点。支持添加一层、全部层级及自定义层级等多种添加方式。
+  *注意：任务血缘链路指的是已提交发布至运维中心的任务链路。
+* 任务查询结果：运行结果的可视化图表X轴增加分桶能力，针对时间日期类型，支持按年、月、日等时间单位灵活聚合数据。
+  ![](.topwrite/assets/image_1747638568605.png =643)
+* 全量下载：新增全量数据下载历史管理。点击下载后可查看近3天的下载记录，待下载链接生成后可点击下载。下载链接最多保留1个小时。
+  ![](.topwrite/assets/222.PNG =692)
+
+#### 运维中心
+
+* 周期任务列表：周期任务列表中新增透出当前周期任务里最近一次实例的运行时间和状态信息。
+
+#### 监控告警
+
+* 新增对实时同步任务是否正常消费处理数据的健康度状况监控（基于CheckPoint）。
+  ![](.topwrite/assets/333.PNG =686)
+
+## 优化改进
+
+* 产品全局：全局页面设计优化，调整页面基于浏览器宽度的自适应能力。
+* 计费账单：在日账单中增加现金支付、代金券抵扣、未结清金额字段，可查看当前账单支付信息。
+* 数据同步：优化离线同步页面加载性能，提升页面响应速度和操作流畅度。
+* 数据同步：离线集成任务字段映射时，支持手动选择字段并复制字段信息。
+* 数据同步：SLS离线数据集成支持传参来指定数据消费的开始时间和结束时间。
+* 数据同步：优化离线同步中Kafka作为源端时，命名空间的选择行为。
+* 数据同步：单表实时同步新建数据源时，只列出可选择的可实时读的数据源。
+* 任务开发：优化任务组内操作体验，包括编辑画布体验（如快捷操作方式、页面整体布局、新增运维跳转入口等）以及移动、添加任务组节点时的提示体验。
+* 任务开发：SQL任务数据结果表格列设置增加搜索能力，可支持快速搜索过滤列信息。
+* 任务开发：优化数据查询结果未查到任何数据时，可视化图表区域的行为提示。
+* 任务开发：在数据树上选择数据表点击查询时，若当前脚本光标位于非代码区域，查询信息插入时会自动定位至代码区域。
+* 任务开发：优化数据查询结果在数据量特别大时页面渲染慢的交互体验。
+* 任务开发：任务参数配置弹窗支持直接修改并保存，配置完参数信息后点击保存，会同时保存当前脚本的代码和参数信息。
+* 任务开发：优化参数取值框，当字段信息过长时支持换行展示全部内容。
+* 任务开发：集群选择区域增加跳转至集群管理页面的入口。
+* 任务开发：数据查询结果，对千分位的逗号展示做细化处理。
+* 数据目录：优化数据详情预览功能，支持用户选择当前实例下所有可用的集群进行数据预览。
+* 数据目录：数据管理表详情页新增强制刷新功能，支持用户手动刷新页面以获取最新的元数据信息。
+* 数据上传：优化数据上传后端性能，提升文件上传响应速度。
+* 运维中心：优化实例重跑的默认配置，默认选中包含当前节点。
+* 数据质量：新建质量规则时自动填充当前工作空间并禁用当前工作空间的切换选择。
+* 数据质量：在页面中强化展示质量规则ID，便于在规则名称相同或相近时辅助区分。
+* 数据质量：质量规则的校验内容中，展示出规则类型和校验详情。
+
+## 缺陷修复
+
+* 数据同步：修复PostgreSQL数据源bit和varbit类型的数据增量同步结果不正确的问题。
+* 任务开发：修复任务参数取值来源从任务组参数切换到任务参数时，取值没有联动切换的问题。
+* 数据目录：修复自定义服务用户在授权页面不可见不可选择的问题。
+
+## 已知局限
+
+* 本次版本更新无已知的新增的重大局限。
+
+^

package/bin/skills/lakehouse-doc/references/RN_2025-07-03.md

@@ -0,0 +1,100 @@
+# 2025年07月03日 Lakehouse Studio 产品更新发布说明
+
+本次发布（Release 2025.07.03）引入了一系列新功能、增强特性及修复内容。请注意，这些更新将分阶段逐步推送至以下区域，预计在发布日起一至两周内完成，具体时间取决于您所在的区域。
+
+* 腾讯云上海区
+* 腾讯云北京区
+* 腾讯云广州区
+* 阿里云上海区
+* 阿里云新加坡区
+* 亚马逊云科技新加坡区
+* 亚马逊云科技北京区
+
+## 不兼容改动
+
+* 无
+
+## 新功能特性
+
+### 管理中心
+
+* 计量计费：计费账单新增 DataGPT 费用项目，支持对 AI 服务成本进行透明化管理。
+
+  ![](.topwrite/assets/image_1752131896262.png =680)
+
+* 账户资金：针对余额不足、资源停服场景可发送提醒消息，并可自定义消息接收方式。
+
+  ![](.topwrite/assets/image_1752131903762.png =680)
+
+### 数据同步
+
+* 多表实时同步：多表合并模式支持自动适配源端动态加表。
+
+    ![](.topwrite/assets/image_1752131911838.png =680)
+
+* 多表实时同步：在写出到 Kafka 的消息中添加主键字段名列表信息。
+* 多表实时同步：写出到 Kafka 时支持按表写入 Topic 下的不同分区。
+* 离线同步：SLS数据源支持通过传参指定开始时间和结束时间。
+* 数据源：将数据源的管理级别从工作空间提升至服务实例，支持将数据源共享给实例下的所有工作空间，实现可见、可用。
+* 数据源：Oracle 数据源 JDBC URL 支持 Service Name 模式的写法，增强连接兼容性。
+
+### 任务开发
+
+* 任务开发：新增组合任务节点类型，支持基于多种任务编排构建 DAG，可统一设定调度周期、参数等。
+
+  ![](.topwrite/assets/image_1752131921358.png =680)
+
+* 任务开发：在任务组DAG图中增加任务依赖展示。
+
+### 调度运维
+
+* 任务运维：下线周期任务时支持清理全部任务实例。
+* 任务运维：在周期任务列表中增加“最近一次执行”筛选功能，支持按最近一次执行状态进行筛选。
+
+### 监控告警
+
+* 监控告警：对因上游任务暂停导致下游任务调度超时失败而产生的告警，增加抑制机制，避免误触发。
+* 监控告警：在告警推送内容中，支持通过配置方式自定义适配客户侧的域名。
+
+### 数据质量
+
+* 支持按校验内容对数据质量校验结果进行筛选过滤，提高问题定位效率。
+
+### 作业历史
+
+* 作业详情页支持点击集群进行跳转，可快速查看集群详细信息。
+
+## 优化改进
+
+* 产品全局：完善新手引导功能链路，例如在数据上传成功后，增加到数据查询功能路径的跳转。
+* 产品全局：对于在列表等位置未完全展示内容的字段，统一添加 Tooltip 提示，方便查看完整信息。
+* 产品全局：优化时间选择控件中按钮的样式、提升操作体验。
+* 实例首页：优化代金券显示内容，支持展示代金券的数量和余额。
+* 数据上传：优化数据预览时的数据展示方式，便于理解。
+* 数据同步：在数据同步任务配置界面，优化新增数据源的自动展示功能，使其在列表中自动显示。
+* 数据同步：优化多表实时同步功能，解决源端 MySQL 表过大对任务配置和执行产生影响的问题。
+* 任务开发：将任务和任务组分别通过不同 Tab 展示，避免相互干扰。
+* 任务开发：支持调大版本对比窗口，便于查看内容对比。
+* 任务开发：在新建任务菜单中，将任务分类方式调整为“数据同步”、“数据处理”等分组。
+* 监控告警：优化监控规则触发条件编辑时的操作便捷性。
+* 数据质量：支持快速跳转定位并查看质量规则中展示的最新校验结果详情。
+* 集群管理：计算集群作业监控统计功能数据正确性提升。
+
+## 问题修复
+
+* 管理中心：修复管理中心新建用户后页面列表未自动刷新的问题。
+* 任务开发：修复智能解析当前仅支持新增，无法更新或覆盖已有智能解析结果的问题。
+* 任务开发：修复任务代码中对象名称包含引号时，智能解析无法识别匹配的问题。
+* 任务开发：修复参数页面修改参数 value 保存后不生效的问题。
+* 任务开发：修复任务回滚后任务状态展示错误的问题。
+* 任务开发：修复任务使用任务组提供的参数时，提交后参数不生效并报错的问题。
+* 任务开发：修复任务调度暂停后脚本仍可被删除的问题。
+* 任务开发：修复 Shell 节点内参数与代码中参数冲突，忽略参数功能失效的问题。
+* 数据目录：修复新加坡数据资产统计页面数据长时间未刷新的问题。
+
+## 行为变更
+* 数据源：数据源的管理权限由工作空间（workspace）提升至服务实例（instance），以便在账户内更方便地共享数据源并管理其连接安全。原 workspace_admin（工作空间管理员）和 workspace_dev（工作空间开发者）角色不再具备创建数据源的权限；instance_admin（服务实例管理员）和 instance_datasource_admin（服务实例数据源管理员）角色仍保留创建和管理数据源的权限。
+
+## 已知局限
+
+* 本次版本更新无已知的新增重大局限。

package/bin/skills/lakehouse-doc/references/RN_2025-08-25.md

@@ -0,0 +1,106 @@
+# 2025年08月25日 Lakehouse Studio 产品更新发布说明
+
+本次发布（Release 2025.08.25, v1.9.1）引入了一系列新功能、增强特性及修复内容。请注意，这些更新将分阶段逐步推送至以下区域，预计在发布日起一至两周内完成，具体时间取决于您所在的区域。
+
+* 腾讯云上海区
+* 腾讯云北京区
+* 腾讯云广州区
+* 阿里云上海区
+* 阿里云新加坡区
+* 亚马逊云新加坡区
+* 亚马逊云北京区
+
+## 不兼容改动
+
+* 监控告警：监控事项「任务实例运行失败」范围调整。针对因上游实例暂停而被阻塞、或因超时被终止而置为失败的实例，调整为不触发实例运行失败的告警。同时额外新增了告警项「调度实例等待超时失败」，该告警需单独进行配置。
+  ![](.topwrite/assets/image_1756281295371.png =680)
+
+## 新功能特性
+
+* 产品全局：针对新用户进入产品后的体验进行优化，包括提供新人引导视频课程以帮助用户理解产品功能，以及对实例首页的信息结构进行调整，加强常用功能的快捷跳转引导等。
+
+  ![](.topwrite/assets/image_1756281325908.png =680)
+
+* 产品全局：提供全局的问题反馈快速通道。
+
+  ![](.topwrite/assets/image_1756282052584.png =680)
+
+* 账户体系：新增邀请码功能（非必填），支持特定促销活动填入邀请码，获得活动奖励。
+
+* 账户体系：SSO单点登录账号认证新增支持OAuth 2.0协议的集成，现对用户灰度开放（需联系云器销售申请）。目前可以与支持OAuth 2.0、OpenID、SAML 2.0协议的身份服务集成。使用单点登录后，Web端仅允许使用单点登录方式进行认证；JDBC、SDK仍需使用用户名+密码方式认证。
+
+  ![](.topwrite/assets/image_1756281391335.png =680)
+
+* 账户体系：支持管理员代其他用户修改其手机/邮箱信息。
+
+* 工作区：新增批量提交、批量修改调度配置项能力，提升开发人员在开发场景内的代码管理和开发效率。
+
+  ![](.topwrite/assets/image_1756281411270.png =680)
+
+* 数据同步：多表实时同步新增支持整库镜像同步模式，可自动感知源端库下新增的表并进行同步。
+
+  ![](.topwrite/assets/image_1756281430788.png =680)
+
+* 数据同步：多表实时任务在镜像同步模式下支持感知源端truncate表的行为，并对应清理目标表中的数据。
+
+  ![](.topwrite/assets/image_1756281447720.png =680)
+
+* 数据同步：多表实时同步的运维中心任务详情页中，failover信息持久化保存，支持任务运行和重启后继续查看。
+
+  ![](.topwrite/assets/image_1756281461950.png =680)
+
+* 数据同步：离线同步，PostgreSQL目标端新增支持预处理前置操作（Pre-SQL），用于事先清理源端数据等。
+
+  ![](.topwrite/assets/image_1756281476014.png =680)
+
+* 数据同步：离线同步，SLS源端新增支持给定query条件来进行数据过滤。
+
+  ![](.topwrite/assets/image_1756281491976.png =680)
+
+* 任务开发：新增运行偏好设置能力，提供全局运行或者单个代码块运行两种用户偏好习惯，提升开发场景内的使用体验。
+
+* 任务开发：内置参数和函数表达式新增支持多个偏移量。可基于日期表达式/时间戳函数，与多个偏移量配合，来表达如“去年前一天”、“上周前一小时”等时间戳的高阶参数取值。详见：[任务参数](task_param.md)
+
+  ![](.topwrite/assets/image_1756281699509.png =680)
+
+  ![](.topwrite/assets/image_1756281704667.png =680)
+
+* 任务调度：高阶调度能力增强，包括新增延迟运行/空跑跳过、实例生成策略优化、支持设置排除时间，以及依赖策略新增向前依赖和向前就近依赖等能力。以满足不同业务场景下对个性化配置调度执行策略的需求。详见：[任务开发与调度](taskdevelop.md)、[任务调度依赖关系](task_scheduling_dependency.md)
+
+  ![](.topwrite/assets/schedule.gif =680)
+
+* 运维中心：周期实例列表新增任务文件的版本号信息，便于定位实例使用的具体版本并进行操作回滚。
+
+* 数据上传：新增支持JSON/JSONL格式本地文件的上传能力。
+
+  ![](.topwrite/assets/upload_json.gif =680)
+
+## 优化改进
+
+* 产品全局：依据调度配置时间属性的新规则，调整调度周期展示信息内容，涉及范围涵盖工作区、任务组列表、运维中心等。
+* 数据源：针对不同数据源的创建，提供具有针对性的输入框底纹提示，以辅助用户输入准确信息，降低理解成本。
+* 数据源：对MySQL连接串中的参数进行优化，在连接串后提供默认参数信息，例如 `CONVERT_TO_NULL`、`useSSL` 等。
+* 数据同步：ElasticSearch源端，支持适配JSON中键（Key）动态出现的情况，当键不存在时进行兼容处理，避免任务报错失败。
+* 数据同步：优化集成任务配置的使用体验，在更换表时不刷新数据集成任务的缓存。
+* 任务调度：支持在任务开始调度时间并非整点的情况下，保持生成的实例连续。例如，若2:20开始调度，每10分钟调度一次，则3:00、3:10、4:00、4:10等定时时间的实例也会生成（此前方式不会生成）。
+* 运维中心：优化暂停和恢复任务时对实例的覆盖范围。暂停任务时，暂停的实例范围从原先的“操作时间当天的实例”变更为“操作时间之后的实例”。恢复任务时，默认仅恢复操作时间之后的任务实例。
+* 运维中心：在实例状态方面，新增通过Tooltip显示状态的具体子状态（例如“空跑置成功”等），以便快速查看细化的状态分类。
+* 运维中心：在任务实例详情页中，新增展示任务的调度定时信息。
+* 运维中心：合并周期任务列表的“最后一次运行时间”与“状态”显示列，提升阅读的视觉效率。
+* 运维中心：在多表实时同步运维中，在执行日志中显示更多报错信息，以便排查和定位问题。
+* 监控告警：对于因上游实例暂停而被阻塞或因超时被终止的实例，不触发实例运行失败的告警。
+* 监控告警：在周期任务实例的监控告警信息中，新增显示实例的计划定时时间，以便识别报警对应的任务。
+* 作业历史：优化用户在作业历史详情页的使用体验，包括优化集群CRU展示页面、处理失效URL跳转问题。
+
+## 问题修复
+
+* 数据同步：解决从 MySQL 实时同步过来的 tinyint(1) 数值与源表不一致的问题。
+* 数据同步：解决多表实时任务按点位启动后，在特殊情况下会触发重建底表的问题，调整为不进行重建。
+* 集群管理：解决作业存在排队情况时，查看 VC 页面详情无法显示的问题。
+* 监控告警：解决任务运行延迟告警疑似误触发的问题。
+
+## 已知局限
+
+* 本次版本更新无已知的新增的重大局限。
+
+^

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

@@ -0,0 +1,141 @@
+# 2025年03月03日 — 1.0 Lakehouse Platform 产品更新发布说明
+
+本次发布，我们引入了一系列新功能、增强特性以及修复项。这些更新将分阶段逐步推送至以下区域，预计在发布日起一周至两周内完成。具体时间依据您所在的区域而定。
+
+* 阿里云上海区
+* 腾讯云上海区
+* 腾讯云北京区
+* 腾讯云广州区
+* 亚马逊北京区
+* 国际站-阿里云-新加坡区
+* 国际站-AWS-新加坡区
+
+## 新功能特性
+
+### 联邦查询更新【预览发布】
+
+* **架构扩展**：云器Lakehouse支持使用External Schema在Catalog级别映射和镜像外部数据源支持查询 Hive（之前只支持 Hive 对象存储架构，本期支持 Hive HDFS 架构）。参考[EXTERNAL SCHEMA](EXTERNALSCHMEA.md)
+* **增强Delta Lake格式读取**：创建外部表Delta Lake格式自动Schema推断——创建外部表时无需手动声明字段信息，系统自动解析元数据。参考[Delta Lake 外部表](delta-lake.md)
+
+## 导入导出更新
+
+### COPY命令增强
+
+支持双字符CSV分隔符（如 `||`），突破原有单字符限制，提升复杂数据兼容性。参考[COPY INTO导入](copy-into-table.md)
+
+### Pipe功能增强
+
+1. 支持[Kafka Table Stream](pipe-kafka-table-stream.md)直连导入，通过 Table Stream 您可以实现 Exactly Once，同时支持将连接信息存储在 Connection 中
+
+2. [Pipe SQL命令优化](pipe-syntax.md)
+
+   * 支持通过`SHOW CREATE PIPE pipe_name`获取Pipe的DDL语句
+   * Pipe DESC 结果输出优化。DESC PIPE pipe_name 显示结果字段，Pipe 任务的输入对象名称和输出对象名称，增加 Kafka 点位消费信息
+   * 支持Alter命令修改Pipe导入参数如修改计算集群
+
+3. Pipe导入对象存储数据。支持过滤`.`开头和 `_temporary` 开头的文件或者目录文件。参数`IGNORE_TMP_FILE=FALSE|TRUE`。例如：
+
+   ```
+   s3://my_bucket/a/b/.SUCCESS
+   oss://my_bucket/a/b/_temporary
+   oss://my_bucket/a/b/_temporary_123/
+   ```
+
+## 计算集群
+
+**精细化资源控制**
+
+新增[GP型计算集群单作业资源占比配置](alter-vcluster.md)，控制单作业最大资源占比 10%。避免大查询引发的资源抢占，提升集群稳定性：
+
+```
+ALTER VCLUSTER sample_vc SET QUERY_RESOURCE_LIMIT_RATIO='0.1'; 
+```
+
+## SQL语法
+
+1. 支持创建[SQL FUNCTION](create-sql-function.md)。通过这一功能，用户能够利用SQL DDL（数据定义语言）语句来定义自定义的SQL函数，从而增强数据处理和分析的灵活性。
+2. Lakehouse 正式推出[列级安全（Column-level Security）功能](dynamic-mask.md)，支持通过动态脱敏（Dynamic Data Masking）实现对敏感数据的细粒度控制。此功能允许管理员根据用户角色或属性，动态隐藏、部分显示或替换列中的敏感信息（如身份证号、信用卡号等），从而有效保护数据隐私。用户可以通过以下 SQL 语句实现动态脱敏：
+
+```SQL
+ALTER TABLE <table_name> MODIFY COLUMN <column_name> SET MASKING POLICY <policy_name>;
+```
+
+通过定义脱敏策略并将其应用于表的列，在查询运行时，屏蔽策略将应用于该列出现的每个位置，根据屏蔽策略条件、SQL 执行上下文角色或者用户来进行脱敏。
+
+3. Lakehouse 数据存储优化功能。通过 [OPTIMIZE 命令](small_file_optimization.md)的高级参数，用户可以进行小文件合并
+4. DML增强：`UPDATE` 支持 `ORDER BY ... LIMIT` 语法
+5. 【预览发布】[多方言兼容](sql-parmaters.md)：通过SQLGlot集成支持PostgreSQL/MySQL/Hive/Presto等方言的部分语法
+
+## UDF功能
+
+新增 `cz.sql.remote.udf.lookup.policy` 配置参数,支持动态切换 UDF 与内置函数的解析优先级
+
+```SQL
+-- 策略1：优先调用内置函数（兼容传统OLAP系统行为）
+SET cz.sql.remote.udf.lookup.policy = builtin_first;
+
+-- 策略2：优先调用UDF（适配MC/Spark作业场景）
+SET cz.sql.remote.udf.lookup.policy = udf_first;
+
+-- 默认策略：强制要求UDF带Schema前缀（保持历史兼容性）
+SET cz.sql.remote.udf.lookup.policy = schema_only; 
+```
+
+## 权限管理【预览发布】
+
+[新增Instance级别角色与跨空间授权能力](CREATEROLE.md):支持在实例（Instance）粒度创建角色并授予全局权限，实现跨空间（Workspace）的统一权限管控，满足多团队协作场景下的精细化访问控制需求。
+
+## 函数
+
+新增函数列表：
+
+| 函数                                                                                                   | 功能                                                                                                                   |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| [collect\_list\_on\_array](sql_functions/aggregate_functions/collect_list_on_array.md)               | 该函数用于将输入的数组（array）元素收集到一个新的数组中，并返回该新数组。                                                                              |
+| [collect\_set\_on\_array](sql_functions/aggregate_functions/collect_set_on_array.md)                 | 函数用于从输入的数组表达式中提取不重复的元素，并将这些元素组成一个新的数组                                                                                |
+| [str\_to\_date\_mysql](sql_functions/scalar_functions/datetime_functions/str_to_date_mysql.md)       | 用于将字符串转换为日期，其实现与 MySQL 中的 str_to_date 函数兼容                                                                         |
+| [make\_date](sql_functions/scalar_functions/datetime_functions/makde_date.md)                        | 根据年月日构造一个date类型                                                                                                      |
+| [to\_start\_of\_interval](sql_functions/scalar_functions/datetime_functions/to_start_of_interval.md) | 将时间 ts 按照 interval 截断，注意当 interval 为分钟时，需要保证其能被 1 天整除                                                                    |
+| [json\_remove](sql_functions/scalar_functions/json_functions/json_remove.md)                         | 将满足jsonPath的元素从jsonObject中删除，返回剩余的元素                                                                                 |
+| [element\_at](sql_functions/scalar_functions/high_order_functions/element_at.md)                     | 函数用于从数组或映射（Map）中提取指定位置或键的元素。                                                                                         |
+| [map\_from\_arrays](sql_functions/scalar_functions/nested_functions/map_from_arrays.md)              | 使用两个array创建map，map 的 key 和 value 与参数 array 中的顺序一一对应                                                                         |
+| [endswith ](sql_functions/scalar_functions/string_functions/endswith.md)                             | `ENDSWITH` 函数用于判断一个字符串或二进制表达式是否以另一个指定的字符串或二进制表达式结尾。如果满足条件，则返回布尔值 `TRUE`，否则返回 `FALSE`。该函数支持字符串和二进制数据，适用于字符串处理和模式匹配场景。 |
+| [format\_string](sql_functions/scalar_functions/string_functions/format_string.md)                   | 用于格式化字符串。它基于 `printf` 样式的格式字符串生成格式化后的字符串                                                                             |
+| [is\_ascii](sql_functions/scalar_functions/string_functions/is_ascii.md)                             | 判断str是否只包含ascii编码的字符                                                                                                 |
+| [is\_utf8](sql_functions/scalar_functions/string_functions/is_utf8.md)                               | 判断str是否只包含utf-8编码的字符                                                                                                 |
+| [regexp\_extract\_all](sql_functions/scalar_functions/string_functions/regexp_extract_all.md)        | 函数用于从字符串中提取与正则表达式匹配的所有子串。                                                                                            |
+| [sha1](sql_functions/scalar_functions/string_functions/sha1.md)                                      | 用于计算给定字符串的SHA1散列值                                                                                                    |
+| [startswith](sql_functions/scalar_functions/string_functions/startswith.md)                          | 函数用于判断一个字符串是否以另一个指定的字符串开头。如果满足条件，则返回布尔值 `TRUE`，否则返回 `FALSE`。该函数支持字符串和二进制数据，适用于字符串处理和模式匹配场景。                          |
+
+## SDK
+
+### JDBC
+
+**内网端点优化**：新增 `use_oss_internal_endpoint=true` URL 参数配置，如果您使用的服务是阿里云支持查询时强制使用 OSS 内网 Endpoint。参考[JDBC驱动](JDBC-Driver.md)
+
+### Java SDK
+
+实时写入接口现已完整支持 Vector 数据类型，在Java客户端使用数组类型映射。满足 AI 场景下的向量检索需求。要求clickzetta-java版本大于2.0.0。参考[Java SDK](java-sdk-refer.md)
+
+### Python SDK
+
+1. 支持实时写入能力：提供 `clickzetta-ingestion-python-v2` 模块（`pip install clickzetta-ingestion-python-v2`），支持数据实时写入 Lakehouse 存储
+2. 支持异步提交：提供 `clickzetta-connector-python` 模块使用`execute_async()` 方法支持异步执行 SQL 查询，特别适用于长时间运行的查询
+3. 支持参数绑定：提供 \`clickzetta-connector-python\` 模块使用\`execute()\` 方法支持qmark、pyformat风格的参数绑定，适用于更灵活的查询
+
+&#x20;[Python SDK 参考](python-sdk-refer.md)
+
+## BUG修复
+
+* SQL命令 `SHOW PARTITION EXTENDED` 修复结果中filesize显示错误的问题
+* 生成列（Generated Column）兼容性优化。修复历史版本中 Bulkload 写入生成列时的校验报错问题
+* 修复使用 COPY 命令导出数据时，指定 CSV 文件格式中的 quote 不生效问题
+* 联邦查询修复External Schema在Options指定Schema不生效问题
+* Volume查询正则匹配不生效问题
+
+## 行为变更
+
+* 数据留存周期默认值调整：`data_retention_days `由7天默认调整为1天
+* 为提升开发灵活性与数据管理效率，Lakehouse 在本期版本中重磅推出 **主键表 SQL 写入支持**！现在您可以直接通过标准 SQL 语句（`INSERT`/`UPDATE`/`DELETE`）操作定义了主键的表
+
+^

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

@@ -0,0 +1,110 @@
+# 2025年04月22日 — 1.1 Lakehouse Platform 产品更新发布说明
+
+本次发布（Release 2025.04.22），我们引入了一系列新功能、增强特性以及修复项。这些更新将分阶段逐步推送至以下区域，预计在发布日起一周至两周内完成。具体时间依据您所在的区域而定。
+
+**国内区域**
+
+* 阿里云（上海）
+* 腾讯云（上海/北京/广州）
+* 亚马逊云科技（北京）
+
+**国际区域**
+
+* 阿里云（新加坡）
+* AWS（新加坡）
+
+# 新功能特性
+
+## 联邦查询增强
+
+* 【预览发布】**ORC格式支持**：External Catalog/External Schema新增对HMS的ORC文件格式表的读写能力
+
+## 数据导入导出优化
+
+#### 导入命令COPY INTO \<table>
+
+* 换行符智能识别：同时支持 `\r\n` 与 `\n` 格式
+* [on\_error=abort|continue](copy-into-table.md) 策略：
+  * `continue` 模式：跳过压缩格式错误继续执行
+  * `abort` 模式：遇错立即终止
+  * 执行后可展示导入文件列表
+
+#### 导出命令COPY INTO \<location>
+
+* `writebom=true` 参数：导出 CSV 的时候带上 BOM 头，解决 Excel 打开时的中文乱码问题，提高跨平台兼容性
+* `overwrite=true` 参数：清空目标文件夹后导入（含子目录）
+
+### Pipe功能增强
+
+* Pipe 文件持续导入：支持通过 `on_error=continue` 参数忽略错误（跳过压缩格式错误继续执行）继续执行
+
+## SQL功能
+
+* **INTERVAL类型扩展**：允许 \`INTERVAL expr unit\` 中的expr写表达式。如`interval 1+2 year`
+* **元数据展示**：`DESC`/`SHOW` 命令新增显示share类型的schema信息
+* **数据采样**: 新增 [TABLESAMPLE ](tablesample.md)采样语法支持高效数据抽样分析
+* **向量检索**：支持 ef 参数，执行查询前配置ef 参数：`set cz.vector.index.search.ef=64;`
+* **倒排索引**:创建倒排索引时，支持 `'mode' = 'max_word' `参数，以支持更细粒度分词模式：
+  `properties ('analyzer' = 'chinese', 'mode' = 'max_word');`
+
+## 函数
+
+### 内建函数
+
+* **GET\_JSON\_OBJECT性能提升**：优化了GET\_JSON\_OBJECT的实现，提升了JSON解析效率。
+
+### 自定义SQL函数
+
+**SQL 函数增强**：支持[创建 RETURNS TABLE 类型的用户定义SQL函数](create-sql-function.md)
+
+### UDF
+
+External Function支持通过VOLUME地址引用资源文件
+
+* **User Volume 格式地址**:`volume:user://~/upper.jar`
+  * `user` 表示使用 User Volume 协议。
+  * `~` 表示当前用户，为固定值。
+  * `upper.jar` 表示目标文件名。
+* **Table Volume 格式地址**`volume:table://table_name/upper.jar`
+  * `table` 表示使用 Table Volume 协议。
+  * `table_name` 表示表名，需根据实际情况填写。
+  * `upper.jar` 表示目标文件名。
+* **Volume 格式地址**`volume://volume_name/upper.jar`
+  * `volume_name` 创建的vollume名称
+  * `upper.jar` 表示目标文件名。
+
+## Volume
+
+* 【**预览发布**】新增内部命名Volume对象:[命名 Volume ](internal_volume.md)是用户自定义的存储位置，主要用于在将数据导入表中之前暂存数据文件。相较于自动创建的用户级（User Volume）和表级（Table Volume），Named Volume需由用户显式创建，并具备更灵活的配置选项，能够更好地满足团队协作以及复杂数据加载场景的需求。此外，内部 Volume 存储于云器 Lakehouse 管理的内部存储空间内，无需额外配置云存储，为用户提供了更为便捷、高效的存储解决方案。
+
+## 缓存
+
+* **Preload Cache缓存状态查询**：先前仅支持虚拟集群运行状态时通过`SHOW VCLUSTER vcname PRELOAD CACHED STATUS` 查看缓存占用情况，本次支持在虚拟集群暂停状态下通过该命令查看缓存状态并提示集群运行状态。
+
+## INFORMATION SCHEMA
+
+* INFORMATION\_SCHEMA 新增 OBJECT\_PRIVILEGES 视图，可查询系统内所有的数据对象权限授予情况：
+  * 能够直接查询指定用户（user）被授予的所有权限，包含通过角色间接获得的权限；
+  * 能够直接查询指定对象（如table、view等）的权限被授予了哪些用户，包含通过角色间接授予的用户；
+  * 暂不支持查询功能授权情况；
+  * 视图内的授权数据与实时数据存在最多15分钟的延迟。
+
+# SDK
+
+### Python SDK
+
+* **Python SDK增强**：Python SDK支持SQLAlchemy 2接口。
+
+# BUG修复
+
+* **Python SDK**
+  * 修复 `executemany` 方法中 `hints` 参数失效问题
+  * 修复Bulkload SDK写入分区表报错问题
+  * 修复Python SDK执行 `optimize` 语法报错问题
+
+# 行为变更
+
+* **External Function授权简化**：从需同时授予 `USE FUNCTION` +`VOLUME` 使用权限，改为仅需 `USE FUNCTION`权限
+* **PIPE功能**：原来只有RUNNING和PAUSED状态，新增 `failed` 状态，便于监控系统捕捉异常，可以设置警报机制对 FAILED 状态进行通知。可通过 `DESC <pipe_name>` 查看。
+
+^