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