层级 | 说明 | 作用 |
Root Key(根密钥) | 最外层密钥,存放在 FE 本地文件中或托管在腾讯云 KMS 中。 | 本身不参与数据加解密,仅用于加密 Master Key。全集群唯一。 |
Master Key(主密钥) | 由 Root Key 加密,明文缓存在 FE 内存中。 | 分 AES256 / SM4 两族,用于加解密 Data Key。 |
Data Key(数据密钥) | 每个 Tablet 一把,密文随 Tablet 元数据持久化。 | 真正用于加解密数据 Block。 |
encryption_algorithm 参数指定;tde_algorithm 表属性决定,且一张表只能选一种算法。ADMIN 权限。tde_algorithm 属性只能在建表时生效,ALTER TABLE 无法修改。已有明文表无法在线转为加密表,加密表也无法在线换算法或关闭加密。ADD PARTITION ... PROPERTIES ("tde_algorithm" = ...) 中的加密属性会被静默忽略,新分区仍继承表级算法。ADMIN SET ENCRYPTION ROOT KEY 为一次性操作,更换 Root Key 必须走 ADMIN ROTATE TDE ROOT KEY。ROTATE ROOT KEY 时必须与当前 Root Key 类型一致(LOCAL ↔ TENCENT_KMS 不可互切)。如需更换提供方式,需通过数据导出 + 重建集群完成。ADMIN SET ENCRYPTION ROOT KEY PROPERTIES ("type" = "TENCENT_KMS","encryption_algorithm" = "AES256","cmk_id" = "kms-cmk-xxxx","region" = "ap-guangzhou","endpoint" = "kms.tencentcloudapi.com","ak" = "<AccessKey>","sk" = "<SecretKey>");
参数 | 说明 |
type | Root Key 提供方类型,支持 TENCENT_KMS |
encryption_algorithm | 根密钥加密算法,支持 AES256 / SM4 |
cmk_id | KMS CMK ID |
region | KMS 所在地域 |
endpoint | KMS 服务 endpoint |
ak / sk | 调用 KMS 所需的 AccessKey / SecretKey |
SHOW ENCRYPTION ROOT KEY;SHOW ENCRYPTION MASTER KEYS;
ADMIN 权限;ak 仅显示前 4 位 + ****+ 后 4 位;sk 绝不返回;**** 显示。CREATE TABLE 语句中通过 tde_algorithm 表属性指定加密算法:CREATE TABLE t_enc (id BIGINT,val VARCHAR(64))DUPLICATE KEY(id)DISTRIBUTED BY HASH(id) BUCKETS 3PROPERTIES ("replication_num" = "3","tde_algorithm" = "AES256");
tde_algorithm 支持 AES256 / SM4 / PLAINTEXT;doris_tde_algorithm 的默认值(默认 PLAINTEXT);LOCAL↔ TENCENT_KMS 不可互切)。ADMIN ROTATE TDE ROOT KEY PROPERTIES ("doris_tde_key_provider" = "TENCENT_KMS","doris_tde_key_id" = "kms-cmk-yyyy","doris_tde_key_ak" = "<AK>","doris_tde_key_sk" = "<SK>","doris_tde_key_endpoint" = "kms.tencentcloudapi.com","doris_tde_key_region" = "ap-guangzhou");
参数 | 说明 |
doris_tde_key_provider | Root Key 提供方类型,需与当前类型一致( TENCENT_KMS) |
doris_tde_key_id | 新的 KMS CMK ID |
doris_tde_key_ak / doris_tde_key_sk | 调用 KMS 所需的 AccessKey / SecretKey |
doris_tde_key_endpoint | KMS 服务 endpoint |
doris_tde_key_region | KMS 所在地域 |
ADMIN SET ENCRYPTION ROOT KEY、ADMIN ROTATE TDE ROOT KEY、SHOW ENCRYPTION ROOT KEY、SHOW ENCRYPTION MASTER KEYS 均要求 ADMIN 全局权限;Access denied 错误;CREATE TABLE t_new (...) PROPERTIES ("tde_algorithm" = "AES256");INSERT INTO t_new SELECT * FROM t_old;ALTER TABLE t_old RENAME t_old_bak;ALTER TABLE t_new RENAME t_old;
指标 | 说明 |
doris_fe_tde_rotate_master_key_success | Master Key 轮转成功次数 |
doris_fe_tde_rotate_master_key_failed | Master Key 轮转失败次数 |
doris_fe_tde_rotate_root_key_success | Root Key 轮转成功次数 |
doris_fe_tde_rotate_root_key_failed | Root Key 轮转失败次数 |
doris_fe_tde_kms_call_failed | KMS 调用失败次数 |
日志 | 说明 |
TDE is enabled, loading master keys | FE 启动加载 Master Key |
Load master key successfully | 单把 Master Key 解密加载成功 |
Rotate master key successfully | Master Key 自动轮转成功 |
Rotate root key successfully | Root Key 轮转成功 |
failed to load master key ... FE will exit | CRC 校验失败,FE 主动退出防止误用 |
async_mode 会将数据先落到 WAL 文件再刷 Rowset,WAL 是否加密由独立的 BE 配置 enable_wal_tde 控制,默认关闭。若同时使用加密表 + Group Commit async_mode,且要求 WAL 也加密,需在所有 BE 节点显式开启 enable_wal_tde = true。普通同步写入与 sync_mode Group Commit 不涉及 WAL,不受该开关影响。Root key not set 或建表失败。先执行 ADMIN SET ENCRYPTION ROOT KEY 再建表即可。master 能作为列名吗?MASTER 已加入非保留字列表,SELECT master FROM t; 或 CREATE TABLE t (master INT) 均可正常使用。文档反馈