更新时间:2026-11-06 GMT+08:00
分享

哈希函数

概述

哈希函数用于计算字符串的散列值,支持MD5、SHA-1、SHA-224、SHA-256、SHA-384、SHA-512等常用哈希算法。AI DataLake支持SQL标准中的哈希计算能力,返回十六进制字符串形式的散列值。

更多内容请参考Hash Functions。

适用场景

  • 数据校验:使用MD5或SHA哈希对数据进行完整性校验。
  • 敏感信息脱敏:对敏感字段(如身份证号、手机号)进行哈希脱敏处理。
  • 数据分区:使用哈希值进行数据分片或分布式分区键生成。
  • 指纹比对:通过哈希值快速判断数据是否一致。

约束与限制

  • 所有哈希函数的输入参数必须为STRING类型,若输入为NULL则返回NULL。
  • MD5返回32位十六进制字符串,SHA-1返回40位,SHA-224返回56位,SHA-256返回64位,SHA-384返回96位,SHA-512返回128位。
  • SHA2函数的hashLength参数仅支持224、256、384、512四种值,其他值会导致错误。
  • 哈希函数为单向函数,不可逆,不适用于加密场景。

语法结构

语法

返回类型

说明

示例

MD5(string)

STRING

返回string的MD5哈希值,为32位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回 '5d41402abc4b2a76b9719d911017c592' 
SELECT MD5('hello'); 
-- 对表字段计算哈希值
SELECT userId, MD5(userEmail) AS emailHash FROM users;
-- 输入为NULL时返回NULL
SELECT MD5(CAST(NULL AS STRING)); 

SHA1(string)

STRING

返回string的SHA-1哈希值,为40位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回 'aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d' 
SELECT SHA1('hello'); 
-- 对表字段计算哈希值
SELECT orderId, SHA1(orderDetail) AS detailHash FROM orders;

SHA224(string)

STRING

返回string的SHA-224哈希值,为56位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回56位十六进制数字字符串 
SELECT SHA224('hello'); 
-- 对表字段计算哈希值
SELECT userId, SHA224(userName) AS nameHash FROM users;

SHA256(string)

STRING

返回string的SHA-256哈希值,为64位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回 '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824' 
SELECT SHA256('hello'); 
-- 对表字段计算哈希值
SELECT userId, SHA256(password) AS passwordHash FROM users;
-- 输入为NULL时返回NULL
SELECT SHA256(CAST(NULL AS STRING));

SHA384(string)

STRING

返回string的SHA-384哈希值,为96位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回96位十六进制数字字符串 
SELECT SHA384('hello'); 
-- 对表字段计算哈希值
SELECT docId, SHA384(docContent) AS contentHash FROM documents;

SHA512(string)

STRING

返回string的SHA-512哈希值,为128位十六进制数字字符串;如果string为NULL则返回NULL。

-- 返回128位十六进制数字字符串 
SELECT SHA512('hello'); 
-- 对表字段计算哈希值
SELECT fileId, SHA512(fileContent) AS contentHash FROM files;

SHA2(string, hashLength)

STRING

使用SHA-2系列哈希函数(SHA-224、SHA-256、SHA-384或SHA-512)返回哈希值。第一个参数string是要哈希的字符串,第二个参数hashLength是结果的位长度(224、256、384或512)。如果string或hashLength为NULL则返回NULL。

-- 使用SHA-256(等价于SHA256函数) 返回 '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824' 
SELECT SHA2('hello', 256); 
-- 使用SHA-512(等价于SHA512函数)
SELECT SHA2('hello', 512);
-- 使用SHA-224(等价于SHA224函数)
SELECT SHA2('hello', 224);
-- hashLength为NULL时返回NULL
SELECT SHA2('hello', CAST(NULL AS INT));

相关文档