修改租户 
=========================

本节主要介绍如何修改租户的属性信息。

通过 SQL 语句修改租户 
----------------------------------

修改租户命令的语法如下：

```sql
 ALTER TENANT {tenant_name | ALL}
    [SET] [tenant_option_list] [opt_global_sys_vars_set]

tenant_option_list:
    tenant_option [, tenant_option ...]

tenant_option:
            COMMENT [=]'string' 
            |{CHARACTER SET | CHARSET} [=] charsetname 
            |COLLATE [=]  collationname 
            |REPLICA_NUM [=] num 
            |ZONE_LIST [=] (zone [, zone...]) 
            |PRIMARY_ZONE [=] zone 
            |RESOURCE_POOL_LIST [=](poolname [, poolname...]) 
            |DEFAULT TABLEGROUP [=] {NULL | tablegroupname}
            |{READ ONLY | READ WRITE}
      |LOGONLY_REPLICA_NUM [=] num
      |LOCALITY [=] 'locality description'
      |LOCK|UNLOCK;
      
opt_global_sys_vars_set:
      VARIABLES system_var_name = expr [,system_var_name = expr] ...
```



锁定租户 `TENANT1` 的示例如下：

```sql
obclient> ALTER TENANT TENANT1 LOCK;
```



更多 `ALTER TENANT` 语句的信息请参见 [ALTER TENANT](../../../10.sql-reference/5.sql-statement/9.alter-tenant.md)。

通过 OCP 修改租户的白名单、密码和资源规格 
--------------------------------------------

通过 OCP 可以修改租户的白名单、密码、资源规格。同时租户的扩容和缩容也可以通过修改租户来实现。
**说明**



不同 OCP 版本的操作界面可能不同，本节以 OCP V2.5.0 版本为例提供操作指导，OCP 其他版本的操作请参考对应版本的《OCP 用户指南》文档。

**扩容缩容说明**
租户级别的扩容和缩容是通过修改租户的资源规格来实现的。 租户扩容常用于租户资源无法满足当前租户的需求，比如 CPU、内存资源紧张的情况。通过对租户的扩容可以整体动态的调整租户对集群资源的占用。
**说明**



* 对租户进行扩容的情况需要保证整体资源占用不操作上限。如果集群和节点的 CPU、内存资源已经完全分配给所有的租户。

  

* 此时无法对任何租户进行扩容。需要进行对某些租户的缩容，释放资源后在对目标租户进行扩容。

  

* 如果所有租户不能缩容，并且资源非配已满，此时不能进行租户扩容，必须进行集群级别的扩容（添加节点）。

  




**修改租户操作步骤** ：

1. 登录 OCP。

   

2. 在左侧导航栏中单击 **租户** 。

   

3. 在 **租户列表** 中找到指定租户，并单击租户名称。

   

4. 进行以下操作：

   * 在页面右上角展开隐藏菜单，并单击 **修改密码** ，在弹出的对话框中，输入 2 次新密码后，单击 **确定** 。

     
   
   * 在 **白名单** 区域右上角单击 **修改** ，然后在弹出的对话框中，请根据页面说明和配置说明，重新设置白名单，白名单设置的字符数不超 128 个字符，完成后单击 **确定** 。

     ![修改白名单](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1702770061/p167372.png)
     
   
   * 在 **副本详情** 区域，选择需要修改资源规格的副本，在对应的 **操作** 列中，单击 **编辑** 后，修改副本的类型、Unit 规格以及 Unit 数量，单击 **确定** **。** 

     ![修改资源规格](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1702770061/p167373.png)
     **说明**

     

     Unit 数量不能超过该 Zone 下 Server 的个数。
     
   

   




通过 OCP 锁定租户 
--------------------------------

**说明**



不同 OCP 版本的操作界面可能不同，本节以 OCP V2.5.0 版本为例提供操作指导，OCP 其他版本的操作请参考对应版本的《OCP 用户指南》文档。

1. 登录 OCP。

   默认进入 **集群概览** 页面。
   

2. 在左侧导航栏中单击 **租户** 。

   

3. 在 **租户列表** 中找到待锁定的租户，在对应的 **操作** 列中单击 **锁定** **。** 

   **注意**

   

   锁定租户操作会禁止新用户连接到该租户，请谨慎操作。

   ![锁定租户](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1702770061/p167384.png)
   

4. 在弹出的确认框中，单击 **锁定** 。