# 使用SQL编辑器连接集群
数据源用于用户登录列表管理，目前DWS集群支持的登录方式有两种，即自定义（**"用户名+密码"** ）登录和IAM登录两种方式。登录后的集群可以到用户管理界面创建用户或者对已有的用户授权，详情请参见[创建DWS数据库用户和角色](https://support.huaweicloud.com/mgtg-dws/dws_01_01113.html)。
- **自定义登录**：通过输入用户名和密码的方式登录集群数据库，是目前主要的登录方式。
- **IAM** **登录：**通过IAM子账号用户的Token自动登录集群数据库，系统会在数据库中自动创建与子用户同名的数据库用户。
#### 约束与限制
- IAM方式登录仅8.1.3.331（包含）\~ 8.2.0（不包含）、8.2.1.100及以上集群版本支持，存算分离集群仅9.1.0及以上集群版本支持。

- **自定义登录限制：**
  - 新增数据源选择不同的集群，然后输入用户名和密码，测试连接后可以打开集群数据连接。
  
  - 登录时最好勾选**"记住密码"**，如果不填数据库默认是gaussdb数据库。
  
  - 自定义连接根据租户+用户做了用户权限隔离，不同的子用户看到的连接不同，每个用户只能看到自己创建的连接。
   
- **IAM** **用户登录限制：**
  - 需要IAM用户并且已授权**DWS Database Access** 角色权限才能登录，否则编辑面板置灰，无法编辑。此时需联系有**DWS Administrator**权限的用户在当前页面完成对DWS的委托授权。
  
  - IAM用户目前登录DWS集群数据库后没有任何权限，需要在用户管理界面对给IAM用户赋权才能操作。
   
- **连接超时限制：**
  - 后台设置了连接的超时时间，如果超时30分钟没有任何操作，则需要重新登录。
  
  - 连接采用**"用户登录ID+DATABASE"**的方式做唯一缓存，保证每个用户连接每个数据库使用一个连接，保证每次操作在一个连接上进行执行。
  
  - 针对一个数据源下的同一个数据库，不建议开多个窗口执行SQL命令，因为同一个数据库下建立的是同一个连接，开多个窗口也需等待前面SQL执行完后才会继续执行
   
 
#### 操作步骤
1. [登录DWS管理控制台](https://console.huaweicloud.com/dws)。
2. 在左侧导航栏中，选择**"数据 \> SQL编辑器"**。
3. 左边有两个面板，**"数据仓库"** 和**"自定义"**，数据仓库是IAM用户登录，只支持拥有DWS Database Access角色权限的子账号。符合条件后可选择一个集群名称单击打开，即连接上集群数据库可进行操作。
4. 切换到**"自定义"** 面板，可以单击**"新增数据源"** （或在集群列表中单击指定集群操作列的**"登录"** ），参见下表参数说明根据需求填写。
   
   表1新增数据源参数说明 
   | 参数名称    | 描述                                                                                                                                               | 样例      |
   |:---|:---|:---|
   | 数据源名称 | 设置数据源名称。                                                                                                                                        | dws-demo |
   | 集群    | 下拉框选择需要连接的集群。 集群开启SSL认证后需要勾选**"SSL认证"**。                                                          | -           |
   | 数据库    | 填写数据库名称，如果是新创建集群可填写DWS集群默认数据库gaussdb，也可以根据需要进行编辑切换其他数据库。                                                                                         | gaussdb  |
   | 用户名     | 输入用户名称。                                                                                                                                          | dbadmin    |
   | 密码   | 输入用户的密码。此密码仅用于创建数据源、获取数据源连接以使用WEB-SQL编辑器功能。 勾选**"记住密码"**打开数据源时用默认密码进行登录，不勾选刷新界面或者登录过期打开数据源时需要重新输入密码。 | -           |
      
   
   
   ![](https://support.huaweicloud.com/mgtg-dws/figure/zh-cn_image_0000002617625345.png "点击放大")
   
   
   
5. 确认无误后，单击**"测试连接"** ，测试连接成功后，单击**"确定"**新增数据源。