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。或者，使用 --skip-binary-as-hex 启动 mysql 客户端，使所有二进制值都以文本形式显示。）如果任何函数参数为 NULL，则函数返回 NULL。如果 AES_DECRYPT() 检测到无效数据或不正确的填充，则返回 NULL。但是，如果输入数据或密钥无效，则 AES_DECRYPT() 可能返回非 NULL 值（可能是垃圾数据）。

这些函数支持使用密钥派生函数 (KDF) 从 key_str 中传递的信息创建加密强密钥。派生的密钥用于加密和解密数据，它保留在 MySQL Server 实例中，用户无法访问。强烈建议使用 KDF，因为它比在使用函数时指定您自己的预制密钥或通过更简单的方法派生密钥提供更好的安全性。这些函数支持 HKDF（可从 OpenSSL 1.1.0 获取），您可以为其指定可选的盐和特定于上下文的其他信息以包含在密钥材料中，以及 PBKDF2（可从 OpenSSL 1.0.2 获取），您可以为其指定可选的盐并设置用于生成密钥的迭代次数。

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

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

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

MD5(str)

计算字符串的 MD5 128 位校验和。该值将作为 32 个十六进制数字的字符串返回，或者如果参数为 NULL，则返回 NULL。返回值可以例如用作哈希键。有关有效存储哈希值的说明，请参见本节开头的说明。

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

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

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

这是 “RSA Data Security, Inc. MD5 消息摘要算法。”

请参见本节开头有关 MD5 算法的说明。

RANDOM_BYTES(len)

此函数返回一个二进制字符串，其中包含使用 SSL 库的随机数生成器生成的 len 个随机字节。允许的 len 值范围为 1 到 1024。对于超出该范围的值，将发生错误。如果 len 为 NULL，则返回 NULL。

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

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

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

SHA1(str)，SHA(str)

计算字符串的 SHA-1 160 位校验和，如 RFC 3174（安全哈希算法）中所述。该值将作为 40 个十六进制数字的字符串返回，或者如果参数为 NULL，则返回 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 系统变量如何设置。