AES_DECRYPT(crypt_str,key_str[,init_vector][,kdf_name][,salt][,info | iterations])

该函数使用官方的 AES（高级加密标准）算法对数据进行解密。有关更多信息，请参阅 AES_ENCRYPT() 的描述。

使用 AES_DECRYPT() 的语句对于基于语句的复制是不安全的。

AES_ENCRYPT(str,key_str[,init_vector][,kdf_name][,salt][,info | iterations])

AES_ENCRYPT() 和 AES_DECRYPT() 实现了使用官方的 AES（高级加密标准）算法对数据进行加密和解密，之前称为 “Rijndael。” AES 标准允许使用不同的密钥长度。默认情况下，这些函数实现了 128 位密钥长度的 AES。可以使用 196 位或 256 位密钥长度，如后面所述。密钥长度是性能和安全性之间的权衡。

AES_ENCRYPT() 使用密钥字符串 key_str 加密字符串 str，并返回包含加密输出的二进制字符串。AES_DECRYPT() 使用密钥字符串 key_str 解密加密字符串 crypt_str，并返回原始（二进制）字符串的十六进制格式。（要将结果作为纯文本获取，可以将其转换为 CHAR。或者，在启动 mysql 客户端时使用 --skip-binary-as-hex，以便所有二进制值都显示为文本。）如果函数的任何参数为 NULL，则函数返回 NULL。如果 AES_DECRYPT() 检测到无效数据或不正确的填充，它将返回 NULL。然而，如果输入数据或密钥无效，AES_DECRYPT() 可能返回非 NULL 值（可能是垃圾）。

这些函数支持使用密钥派生函数（KDF）从 key_str 中创建加密强密钥。派生密钥用于加密和解密数据，并且它保留在 MySQL 服务器实例中，不可访问用户。使用 KDF 是非常推荐的，因为它提供了比指定自己的预制密钥或使用更简单的方法来派生密钥更好的安全性。这些函数支持 HKDF（从 OpenSSL 1.1.0 开始可用），您可以指定可选的 salt 和上下文特定信息，以便在密钥材料中包含，并且支持 PBKDF2（从 OpenSSL 1.0.2 开始可用），您可以指定可选的 salt 和设置用于生成密钥的迭代次数。

AES_ENCRYPT() 和 AES_DECRYPT() 允许控制块加密模式。系统变量 block_encryption_mode 控制块加密算法的模式。其默认值为 aes-128-ecb，表示使用 128 位密钥长度和 ECB 模式。有关该变量的允许值的描述，请参见 第 7.1.8 节，“服务器系统变量”。可选的 init_vector 参数用于为块加密模式提供初始化向量。

使用 AES_ENCRYPT() 或 AES_DECRYPT() 的语句对于基于语句的复制是不安全的。

如果从 mysql 客户端调用 AES_ENCRYPT()，二进制字符串将以十六进制表示，取决于 --binary-as-hex 选项的值。有关该选项的更多信息，请参见 第 6.5.1 节，“mysql — MySQL 命令行客户端”。

函数 AES_ENCRYPT() 和 AES_DECRYPT() 的参数如下：

mysql> SET block_encryption_mode = 'aes-256-cbc';
mysql> SET @key_str = SHA2('My secret passphrase',512);
mysql> SET @init_vector = RANDOM_BYTES(16);
mysql> SET @crypt_str = AES_ENCRYPT('text',@key_str,@init_vector);
mysql> SELECT CAST(AES_DECRYPT(@crypt_str,@key_str,@init_vector) AS CHAR);
+-------------------------------------------------------------+
| CAST(AES_DECRYPT(@crypt_str,@key_str,@init_vector) AS CHAR) |
+-------------------------------------------------------------+
| text                                                        |
+-------------------------------------------------------------+

COMPRESS(string_to_compress)

将字符串压缩并返回二进制字符串结果。该函数需要 MySQL 编译时带有压缩库，如 zlib。否则，返回值始终为 NULL。如果 string_to_compress 为 NULL，则返回值也为 NULL。压缩后的字符串可以使用 UNCOMPRESS() 解压缩。

mysql> SELECT LENGTH(COMPRESS(REPEAT('a',1000)));
        -> 21
mysql> SELECT LENGTH(COMPRESS(''));
        -> 0
mysql> SELECT LENGTH(COMPRESS('a'));
        -> 13
mysql> SELECT LENGTH(COMPRESS(REPEAT('a',16)));
        -> 15

压缩后的字符串内容存储方式如下：

如果COMPRESS()从mysql客户端调用，二进制字符串将以十六进制表示，取决于--binary-as-hex选项的值。有关该选项的更多信息，请参见第6.5.1节，“mysql — MySQL命令行客户端”。

MD5(str)

计算字符串的MD5 128位校验和。返回值是一个32个十六进制数字的字符串，或者如果参数为空，则返回NULL。返回值可以用作哈希键。请参见本节开头关于存储哈希值的注意事项。

返回值是一个连接字符集中的字符串。

如果启用了FIPS模式，MD5()返回NULL。请参见第8.8节，“FIPS支持”。

mysql> SELECT MD5('testing');
        -> 'ae2b1fca515949e5d54fb22b8ed95575'

这是“RSA Data Security, Inc. MD5 Message-Digest Algorithm.”

请参见本节开头关于MD5算法的注意事项。

RANDOM_BYTES(len)

该函数返回一个长度为len的随机二进制字符串，使用SSL库的随机数生成器生成。允许的len值范围从1到1024。如果len超出该范围，将发生错误。如果len为空，则返回NULL。

RANDOM_BYTES()可以用来提供AES_DECRYPT()和AES_ENCRYPT()函数的初始化向量。在该上下文中，len必须至少为16。允许更大的值，但超过16的字节将被忽略。

RANDOM_BYTES()生成一个随机值，因此其结果是非确定性的。因此，使用该函数的语句对于基于语句的复制是不安全的。

如果RANDOM_BYTES()从mysql客户端调用，二进制字符串将以十六进制表示，取决于--binary-as-hex选项的值。有关该选项的更多信息，请参见第6.5.1节，“mysql — MySQL命令行客户端”。

SHA1(str), SHA(str)

计算字符串的SHA-1 160位校验和，如RFC 3174（Secure Hash Algorithm）所述。返回值是一个40个十六进制数字的字符串，或者如果参数为空，则返回NULL。该函数的一个可能用途是作为哈希键。请参见本节开头关于存储哈希值的注意事项。SHA()是SHA1()的同义词。

返回值是一个连接字符集中的字符串。

mysql> SELECT SHA1('abc');
        -> 'a9993e364706816aba3e25717850c26c9cd0d89d'

SHA1()可以被认为是MD5()的加密安全等效项。然而，请参见本节开头关于MD5和SHA-1算法的注意事项。

SHA2(str, hash_length)

计算SHA-2哈希函数家族（SHA-224、SHA-256、SHA-384和SHA-512）。第一个参数是要哈希的明文字符串。第二个参数指示结果的所需位长，必须是224、256、384、512或0（相当于256）。如果任一参数是NULL或哈希长度不是允许的值，则返回值是NULL。否则，函数结果是一个包含所需位数的哈希值。请参阅本节开头关于高效存储哈希值的注意事项。

返回值是一个字符串，在连接字符集中。

mysql> SELECT SHA2('abc', 224);
        -> '23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7'

该函数仅在MySQL配置了SSL支持时有效。请参阅第8.3节，“使用加密连接”。

SHA2()可以被认为比MD5()或SHA1()更安全。

STATEMENT_DIGEST(statement)

给定一个SQL语句作为字符串，返回语句摘要哈希值作为连接字符集中的字符串，或者如果参数是NULL，则返回NULL。相关的STATEMENT_DIGEST_TEXT()函数返回标准化的语句摘要。关于语句摘要的信息，请参阅第29.10节，“性能架构语句摘要和采样”。

这两个函数使用MySQL解析器来解析语句。如果解析失败，将发生错误。错误消息仅在语句作为文字字符串提供时包括解析错误。

系统变量max_digest_length确定了这些函数用于计算标准化语句摘要的最大字节数。

mysql> SET @stmt = 'SELECT * FROM mytable WHERE cola = 10 AND colb = 20';
mysql> SELECT STATEMENT_DIGEST(@stmt);
+------------------------------------------------------------------+
| STATEMENT_DIGEST(@stmt)                                          |
+------------------------------------------------------------------+
| 3bb95eeade896657c4526e74ff2a2862039d0a0fe8a9e7155b5fe492cbd78387 |
+------------------------------------------------------------------+
mysql> SELECT STATEMENT_DIGEST_TEXT(@stmt);
+----------------------------------------------------------+
| STATEMENT_DIGEST_TEXT(@stmt)                             |
+----------------------------------------------------------+
| SELECT * FROM `mytable` WHERE `cola` = ? AND `colb` = ?  |
+----------------------------------------------------------+

STATEMENT_DIGEST_TEXT(statement)

给定一个SQL语句作为字符串，返回标准化的语句摘要作为连接字符集中的字符串，或者如果参数是NULL，则返回NULL。关于更多讨论和示例，请参阅相关的STATEMENT_DIGEST()函数的描述。

UNCOMPRESS(string_to_uncompress)

解压缩由COMPRESS()函数压缩的字符串。如果参数不是压缩值，结果是NULL；如果string_to_uncompress是NULL，结果也是NULL。该函数需要MySQL使用压缩库（如zlib）编译。否则，返回值始终是NULL。

mysql> SELECT UNCOMPRESS(COMPRESS('any string'));
        -> 'any string'
mysql> SELECT UNCOMPRESS('any string');
        -> NULL

UNCOMPRESSED_LENGTH(compressed_string)

返回压缩字符串之前的长度。如果compressed_string是NULL，则返回NULL。

mysql> SELECT UNCOMPRESSED_LENGTH(COMPRESS(REPEAT('a',30)));
        -> 30

VALIDATE_PASSWORD_STRENGTH(str)

给定一个明文密码字符串，返回一个整数以指示密码的强度，或者如果参数是NULL，则返回NULL。返回值范围从0（弱）到100（强）。

密码评估由VALIDATE_PASSWORD_STRENGTH()函数执行，由validate_password组件实现。如果该组件未安装，函数总是返回0。关于安装validate_password的信息，请参阅第8.4.3节，“密码验证组件”。要检查或设置影响密码测试的参数，请检查或设置validate_password系统变量。请参阅第8.4.3.2节，“密码验证选项和变量”。

密码将受到逐渐严格的测试，返回值反映了哪些测试被满足，如下表所示。此外，如果validate_password.check_user_name系统变量启用并且密码匹配用户名，VALIDATE_PASSWORD_STRENGTH()函数返回0，不管其他validate_password系统变量如何设置。