更新时间：2026-11-03 GMT+08:00
概述
hwc-dws-cli是DWS面向AI Agent与开发者提供的命令行插件，将DWS的数据库访问、集群管理、运维能力整合为统一的命令行入口，构成DWS AI Agentic能力体系的基础底座。
插件定位：
- 面向 AI Agent：命令结果统一以结构化格式（JSON 等）输出，语义稳定，便于 AI Agent 直接解析与决策。
- 面向开发者：同时提供表格、CSV 等易读格式，确保 DBA 与数据工程师获得一致的运维体验。
- 面向自动化场景：支持脚本化调用、统一的退出码约定与错误码体系，便于纳入 CI/CD 流水线与日常巡检流程。
核心特性
hwc-dws-cli的核心特性如表1所示。
| 特性 | 说明 |
|---|---|
| SQL执行 | 支持 DQL/DML/DDL/DCL/TCL 全类型SQL，覆盖单条执行、SQL文件批量执行与参数化查询。 |
| 元数据管理 | 库 / Schema / 表 / 列 / 分区检索，表结构描述，DDL导出，语义元数据（semantic）构建与检索。 |
| 集群管理 | 基于DWS开放API的集群信息查询，覆盖集群、参数组、审计、数据源、负载、扩缩容、逻辑集群、升级、SQL防误操作、自动 vacuum full、事件、告警、备份容灾等。 |
| 数据导入导出 | 支持 CSV / JSON / Parquet 文件上传下载，结合DWS COPY实现高性能加载与断点续传。 |
| 运维视图 | 内置20余个预置只读运维查询，覆盖会话、锁、活跃查询、等待事件、死锁、内存、Top SQL、GUC 参数、资源池等。 |
| 集群监控 | 提供集群级指标、主机列表与告警信息查询。 |
| SQL 调优 | 规则引擎驱动的 SQL审查与调优建议，支持自定义规则与成本护栏。 |
| 安全管控 | 默认只读 + 分级授权 + 危险操作二次确认，SQL分类识别与全链路审计。 |
