# 概述
**hwc-dws-cli**是DWS面向AI Agent与开发者提供的命令行插件，将DWS的数据库访问、集群管理、运维能力整合为统一的命令行入口，构成DWS AI Agentic能力体系的基础底座。
**插件定位：**
- **面向 AI Agent**：命令结果统一以结构化格式（JSON 等）输出，语义稳定，便于 AI Agent 直接解析与决策。
- **面向开发者**：同时提供表格、CSV 等易读格式，确保 DBA 与数据工程师获得一致的运维体验。
- **面向自动化场景**：支持脚本化调用、统一的退出码约定与错误码体系，便于纳入 CI/CD 流水线与日常巡检流程。
#### 核心特性
hwc-dws-cli的核心特性如[表1]所示。
 表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分类识别与全链路审计。                                                 |