虚谷文档 v1.0.0

适用虚谷数据库版本

v12.10.8



适用虚谷数据库版本

v12.10.8


SM4_GCM_ENCRYPT ​

📄字数 625
👁️阅读量 加载中...

功能描述 ​

对输入的二进制数据执行SM4 GCM加密，返回加密结果。

版本支持 ​

在OpenSSL 3.1版本及以上、Tongsuo任意版本支持。

语法格式 ​

sql
SM4_GCM_ENCRYPT(expr1, expr2, expr3, expr4)

输入参数 ​

  • expr1：密钥数据，长度必须为16字节，BINARY 类型或者能隐式转换为 BINARY 类型的其他类型的值。
  • expr2：IV 数据，长度必须为12字节，BINARY 类型或者能隐式转换为 BINARY 类型的其他类型的值。
  • expr3：额外认证数据 AAD，长度必须为16字节， 可以为 NULL
  • expr4：明文数据，BINARY 类型或者能隐式转换为 BINARY 类型的其他类型的值。

输出结果 ​

密文数据 + 16字节认证标签 TAG，BINARY 类型，输入参数为 NULL 时，输出结果为 NULL。

执行类型 ​

TYPEVALUE说明
NATIVE1函数只能在本地计算
VOLATI0函数的每次计算值不同
STABLE1函数的每次计算值相同
COMPUTE0函数支持预计算取值
NOT_CONST0函数不支持转常数
HAVE_DEF0函数参数有默认值

示例 ​

sql
SQL> select rawtohex(sm4_gcm_encrypt('1234567887654321', '1234567890ab', '1234567890abcdef', 'test string'));

+--------------------------------------------------------+
|                         EXPR1                          |
+--------------------------------------------------------+
| D52852509B56DAE10EBEC180ED0A613AE4658FC2E2411A12C01987 |
+--------------------------------------------------------+

(1 row)
Use time:0 ms.