创建掩码策略

引入或更新版本：v1.2.341

企业版功能

掩码策略是企业版功能。 如需获取许可证，请联系 Databend 支持团队。

在 Databend 中创建一个新的掩码策略。

语法

CREATE [ OR REPLACE ] MASKING POLICY [ IF NOT EXISTS ] <policy_name> AS
    ( <arg_name_to_mask> <arg_type_to_mask> [ , <arg_1> <arg_type_1> ... ] )
    RETURNS <arg_type_to_mask> -> <expression_on_arg_name>
    [ COMMENT = '<comment>' ]

参数	描述
policy_name	要创建的掩码策略的名称。
arg_name_to_mask	需要被掩码的原始数据参数的名称。
arg_type_to_mask	需要被掩码的原始数据参数的数据类型。
expression_on_arg_name	决定如何处理原始数据以生成掩码数据的表达式。
comment	关于掩码策略的可选注释，提供信息或备注。

备注

确保 arg_type_to_mask 与将应用掩码策略的列的数据类型匹配。

示例

此示例说明了如何根据用户角色选择性地揭示或掩盖敏感数据的设置过程。

-- 创建表并插入样本数据
CREATE TABLE user_info (
    id INT,
    email STRING
);

INSERT INTO user_info (id, email) VALUES (1, 'sue@example.com');
INSERT INTO user_info (id, email) VALUES (2, 'eric@example.com');

-- 创建角色
CREATE ROLE 'MANAGERS';
GRANT ALL ON *.* TO ROLE 'MANAGERS';

-- 创建用户并将角色授予用户
CREATE USER manager_user IDENTIFIED BY 'databend';
GRANT ROLE 'MANAGERS' TO 'manager_user';

-- 创建掩码策略
CREATE MASKING POLICY email_mask
AS
  (val string)
  RETURNS string ->
  CASE
  WHEN current_role() IN ('MANAGERS') THEN
    val
  ELSE
    '*********'
  END
  COMMENT = 'hide_email';

-- 将掩码策略与'email'列关联
ALTER TABLE user_info MODIFY COLUMN email SET MASKING POLICY email_mask;

-- 以Root用户查询
SELECT * FROM user_info;

id|email    |
--+---------+
 2|*********|
 1|*********|