更新时间：2026-11-10 GMT+08:00
安装与部署
环境要求
使用hwc-dws-cli前，请确认满足以下环境要求：
- Python 3.10 及以上。
- pip工具可用。
- 可访问华为云 DWS 服务（需获取 IAM 凭证 AK/SK）。
- DWS 已配置 EIP（用于 SQL 查询，配置项可选）。
- 已下载hwc-dws-cli工具。
安装方式
插件基于 Python 打包分发，提供两种安装方式：
# linux bash/git bash安装 sh ./install.sh # Powershell安装 .\install.bat
安装完成后可通过以下命令校验：
hwc-dws-cli --version
若回显版本号，说明安装成功；若提示命令未找到，请检查环境变量是否已正确配置。
部署配置
插件运行在用户侧（命令行环境），通过配置连接华为云DWS。配置项如表1所示。
| 配置项 | 说明 |
|---|---|
| IAM 凭证 | AK/SK、区域（Region）、项目 ID |
| 数据库连接 | 主机、端口、用户、密码、数据库名、SSL 模式 |
| 运行模式 | 同步 / 异步（外部任务队列、WITH HOLD 游标） |
| 输出格式 | json（默认）/ table / csv / vertical |
配置支持交互式向导（CLI 向导或 Web 向导）、配置文件与环境变量三种方式，环境变量优先级最高，便于在容器与自动化环境中注入凭证。配置中的敏感字段展示时自动脱敏。
安装完成后可通过以下命令配置：
hwc-dws-cli config set
以下为配置示例：
图1 配置过程
图2 配置成功
hwc-dws-cli config set web
图3 配置web
