# 哈希函数
#### 概述
哈希函数用于计算字符串的散列值，支持MD5、SHA-1、SHA-224、SHA-256、SHA-384、SHA-512等常用哈希算法。AI DataLake支持SQL标准中的哈希计算能力，返回十六进制字符串形式的散列值。
更多内容请参考[Hash Functions](https://nightlies.apache.org/flink/flink-docs-release-1.20/docs/dev/table/functions/systemfunctions/#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)); ``` |
   
