明文和密文的转换

前提条件

• 已创建全密态数据库，并完成相关配置。具体请参见开通全密态数据库、定义敏感数据和客户端使用说明。

• PolarDB PostgreSQL版集群的内核小版本大于等于20231030（14.9.14.0）。

• 当前用户已获得BCL授权，具体请参见授权多用户访问。

语法

ALTER TABLE <table_name> 
    ALTER COLUMN <column_name> [SET DATA] TYPE <目标类型> 
    USING <类型转换函数>(<column_name>[, <keyname>]);

使用示例

• 使用构建的keyname对应的密钥将明文列修改为密文列。

  1. 构建keyname。

     SELECT encdb.keyname_generate(<user_name>, <database_name>, <schema_name>, <table_name>, <column_name>);

  2. 为keyname生成密钥。

     SELECT encdb.dek_generate(<keyname>[, <json_params>]);

     encdb.dek_generate中的参数json_params可选，使用标准JSON格式，可配置的键值对范围如下：

     键	值	说明
     algorithm	AES_128_GCM AES_128_ECB AES_128_CTR AES_128_CBC SM4_128_CBC SM4_128_ECB SM4_128_CTR CLWW_ORE 说明 保序加密，基于论文 Practical Order-Revealing Encryption with Limited Leakage 实现并优化。	加密算法。 默认值：AES_128_GCM。
     policy	DEFAULT	加密策略，预留参数，当前固定配置为DEFAULT。
     flags	RND DET	加密方案。 RND：随机加密。 DET：确定性加密。 默认值：RND。
     mekid	目标用户的MEK ID。	用于生成DEK的用户主密钥ID。 默认为当前连接用户的主密钥ID。

  3. 使用keyname对应的密钥，将明文列（例如int4）修改为对应类型的密文列（例如enc_int4）。

     ALTER TABLE <table_name> ALTER COLUMN <column_name> SET DATA TYPE enc_int4 USING encdb.enc_int4_encrypt(<column_name>, <keyname>);

• 使用当前数据库默认密钥将明文列修改为密文列。

  说明

  当前数据库默认密钥的keyname为|<user>|<database>|。

  ALTER TABLE <table_name> ALTER COLUMN <column_name> SET DATA TYPE enc_int4 USING encdb.enc_int4_encrypt(<column_name>);

• 将密文列修改为明文列。

  ALTER TABLE <table_name> ALTER COLUMN <column_name> SET DATA TYPE int4 USING encdb.decrypt(<column_name>);