ALTER MASKING 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 [ENABLE | DISABLE];

policy_name

脱敏策略名称，需要唯一，不可重复。

取值范围：字符串，要符合标识符的命名规范。
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。

1、创建dev_mask和bob_mask用户。

CREATE USER dev_mask PASSWORD 'dev@1234';
CREATE USER bob_mask PASSWORD 'bob@1234';

2、创建一个表tb_for_masking。

CREATE TABLE tb_for_masking(col1 text, col2 text, col3 text);

3、创建资源标签标记敏感列col1。

CREATE RESOURCE LABEL mask_lb1 ADD COLUMN(tb_for_masking.col1);

4、创建资源标签标记敏感列col2。

CREATE RESOURCE LABEL mask_lb2 ADD COLUMN(tb_for_masking.col2);

5、对访问敏感列col1的操作创建脱敏策略。

CREATE MASKING POLICY maskpol1 maskall ON LABEL(mask_lb1);

6、为脱敏策略maskpol1添加描述。

ALTER MASKING POLICY maskpol1 COMMENTS 'masking policy for tb_for_masking.col1';

7、修改脱敏策略maskpol1，新增一项脱敏方式。

ALTER MASKING POLICY maskpol1 ADD randommasking ON LABEL(mask_lb2);

8、修改脱敏策略maskpol1，移除一项脱敏方式。

ALTER MASKING POLICY maskpol1 REMOVE randommasking ON LABEL(mask_lb2);

9、修改脱敏策略maskpol1，修改一项脱敏方式。

ALTER MASKING POLICY maskpol1 MODIFY randommasking ON LABEL(mask_lb1);

10、修改脱敏策略maskpol1使之仅对用户dev_mask和bob_mask，客户端工具为psql和vsql，IP地址为'10.20.30.40', '127.0.0.0/24'场景生效。

ALTER MASKING POLICY maskpol1 MODIFY (FILTER ON ROLES(dev_mask, bob_mask), APP(psql, vsql), IP('10.20.30.40', '127.0.0.0/24'));

11、修改脱敏策略maskpol1，使之对所有用户场景生效。

ALTER MASKING POLICY maskpol1 DROP FILTER;

12、禁用脱敏策略maskpol1。

ALTER MASKING POLICY maskpol1 DISABLE;