# ALTER MASKING POLICY
#### 功能描述
修改脱敏策略。
#### 注意事项
- 只有poladmin，sysadmin或初始用户才能执行此操作。
- 需要打开enable_security_policy开关脱敏策略才可以生效。
 
#### 语法格式
- 修改策略描述：
  ```
  ALTER MASKING POLICY policy_name COMMENTS policy_comments;
  ```
  

- 修改脱敏方式：
  ```
  ALTER MASKING POLICY policy_name [ADD | REMOVE | MODIFY] masking_actions[, ...]*;
  其中masking_action:
      masking_function ON LABEL(label_name[, ...]*)
  ```
  

- 修改脱敏策略生效场景：
  ```
  ALTER MASKING POLICY policy_name MODIFY(FILTER ON FILTER_TYPE(filter_value[, ...]*)[, ...]*);
  ```
  

- 移除脱敏策略生效场景，使策略对所用场景生效：
  ```
  ALTER MASKING POLICY policy_name DROP FILTER;
  ```
  

- 修改脱敏策略开启/关闭：
  ```
  ALTER MASKING POLICY policy_name [ENABLE | DISABLE];
  ```
  
 
#### 参数说明
- **policy_name**
  脱敏策略名称，需要唯一，不可重复。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0266.html#ZH-CN_TOPIC_0000002221496149__zh-cn_topic_0000002220894609_section1257443811315)。
  
- **policy_comments**
  需要为脱敏策略添加或修改的描述信息。
  
- **masking_function**
  指的是预置的八种脱敏方式或者用户自定义的函数，支持模式。
  maskall不是预置函数，硬编码在代码中，不支持\\df展示。
  预置时脱敏方式如下：
  ```
  maskall | randommasking | creditcardmasking | basicemailmasking | fullemailmasking | shufflemasking | alldigitsmasking | regexpmasking
  ```
  
- **label_name**
  资源标签名称。
  

- **FILTER_TYPE**
  指定脱敏策略的过滤信息，过滤类型包括：IP、ROLES、APP。
  
- **filter_value**
  指具体过滤信息内容，例如具体的IP，具体的APP名称，具体的用户名。
  

- **ENABLE\|DISABLE**
  可以打开或关闭脱敏策略。若不指定ENABLE\|DISABLE，语句默认为ENABLE。
  
 
#### 示例
```
--创建dev_mask和bob_mask用户。
openGauss=# CREATE USER dev_mask PASSWORD '********';
openGauss=# CREATE USER bob_mask PASSWORD '********';
--创建一个表tb_for_masking。
openGauss=# CREATE TABLE tb_for_masking(col1 text, col2 text, col3 text);
--创建资源标签标记敏感列col1。
openGauss=# CREATE RESOURCE LABEL mask_lb1 ADD COLUMN(tb_for_masking.col1);
--创建资源标签标记敏感列col2。
openGauss=# CREATE RESOURCE LABEL mask_lb2 ADD COLUMN(tb_for_masking.col2);
--对访问敏感列col1的操作创建脱敏策略。
openGauss=# CREATE MASKING POLICY maskpol1 maskall ON LABEL(mask_lb1);
--为脱敏策略maskpol1添加描述。
openGauss=# ALTER MASKING POLICY maskpol1 COMMENTS 'masking policy for tb_for_masking.col1';
--修改脱敏策略maskpol1，新增一项脱敏方式。
openGauss=# ALTER MASKING POLICY maskpol1 ADD randommasking ON LABEL(mask_lb2);
--修改脱敏策略maskpol1，移除一项脱敏方式。
openGauss=# ALTER MASKING POLICY maskpol1 REMOVE randommasking ON LABEL(mask_lb2);
--修改脱敏策略maskpol1，修改一项脱敏方式。
openGauss=# ALTER MASKING POLICY maskpol1 MODIFY randommasking ON LABEL(mask_lb1);
--修改脱敏策略maskpol1使之仅对用户dev_mask和bob_mask,客户端工具为gsql，IP地址为'10.20.30.40', '127.0.0.0/24'场景生效。
openGauss=# ALTER MASKING POLICY maskpol1 MODIFY (FILTER ON ROLES(dev_mask, bob_mask), APP(gsql), IP('10.20.30.40', '127.0.0.0/24'));
--修改脱敏策略maskpol1，使之对所有用户场景生效。
openGauss=# ALTER MASKING POLICY maskpol1 DROP FILTER;
--禁用脱敏策略maskpol1。
openGauss=# ALTER MASKING POLICY maskpol1 DISABLE;
--删除脱敏策略。
openGauss=# DROP MASKING POLICY maskpol1;
--删除资源标签。
openGauss=# DROP RESOURCE LABEL mask_lb1, mask_lb2;
--删除表tb_for_masking。
openGauss=# DROP TABLE tb_for_masking;
--删除用户dev_mask和bob_mask。
openGauss=# DROP USER dev_mask, bob_mask;
```
#### 相关链接
[CREATE MASKING POLICY](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0410.html#ZH-CN_TOPIC_0000002221496297)，[DROP MASKING POLICY](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0450.html#ZH-CN_TOPIC_0000002221496353)。