AES_DECRYPT(crypt_str,key_str[,init_vector])

此函数使用官方 AES（高级加密标准）算法解密数据。有关详细信息，请参阅 的说明AES_ENCRYPT()。

可选的初始化向量参数 ， init_vector从 MySQL 5.6.17 开始可用。从那个版本开始，使用 AES_DECRYPT()的语句对于基于语句的复制是不安全的，并且不能存储在查询缓存中。

AES_ENCRYPT(str,key_str[,init_vector])

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

AES_ENCRYPT()str使用密钥字符串 加密字符串key_str并返回包含加密输出的二进制字符串。 使用密钥字符串AES_DECRYPT()解密加密字符串并返回原始明文字符串。如果任一函数参数是 ，则函数返回 。 crypt_strkey_strNULLNULL

和参数可以是任意长度，并且会自动添加填充， str因此 它是 AES 等基于块的算法所要求的块的倍数。此填充由 函数自动删除。的长度可以使用以下公式计算： crypt_strstrAES_DECRYPT()crypt_str

16 * (trunc(string_length / 16) + 1)

对于 128 位的密钥长度，将密钥传递给key_str参数的最安全方法是创建一个真正随机的 128 位值并将其作为二进制值传递。例如：

INSERT INTO t
VALUES (1,AES_ENCRYPT('text',UNHEX('F3229A0B371ED2D9441B830D21A390C3')));

密码可用于通过对密码进行哈希处理来生成 AES 密钥。例如：

INSERT INTO t
VALUES (1,AES_ENCRYPT('text', UNHEX(SHA2('My secret passphrase',512))));

不要将密码或密码直接传递给 crypt_str，首先对其进行哈希处理。本文档的早期版本建议采用前一种方法，但不再推荐，因为此处显示的示例更安全。

如果AES_DECRYPT()检测到无效数据或不正确的填充，则返回 NULL. 但是， 如果输入数据或密钥无效 ，则有可能AES_DECRYPT()返回非值（可能是垃圾）。NULL

从 MySQL 5.6.17 开始， AES_ENCRYPT()允许 AES_DECRYPT()控制块加密模式并采用可选的 init_vector初始化向量参数：

对于需要可选 init_vector参数的模式，它必须为 16 字节或更长（超过 16 的字节将被忽略）。init_vector如果缺少， 则会发生错误。

对于不需要的模式 init_vector，它会被忽略，如果指定，则会生成警告。

用于初始化向量的随机字节串可以通过调用 RANDOM_BYTES(16). 对于需要初始化向量的加密模式，加密和解密必须使用相同的向量。

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 AES_DECRYPT(@crypt_str,@key_str,@init_vector);
+-----------------------------------------------+
| AES_DECRYPT(@crypt_str,@key_str,@init_vector) |
+-----------------------------------------------+
| text                                          |
+-----------------------------------------------+

下表列出了每种允许的块加密模式、支持它的 SSL 库以及是否需要初始化向量参数。

从 MySQL 5.6.17 开始，使用 AES_ENCRYPT()或 AES_DECRYPT()对基于语句的复制不安全的语句不能存储在查询缓存中。

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

COMPRESS(string_to_compress)

压缩字符串并将结果作为二进制字符串返回。此功能要求 MySQL 编译时带有压缩库，例如zlib. 否则，返回值始终为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. 有关该选项的更多信息，请参阅第 4.5.1 节，“mysql — MySQL 命令行客户端”。

DECODE(crypt_str,pass_str)

crypt_str使用 pass_stras 密码 解密加密的字符串 。crypt_str应该是从返回的字符串ENCODE()。

DES_DECRYPT(crypt_str[,key_str])

解密用 加密的字符串 DES_ENCRYPT()。如果发生错误，该函数返回NULL。

此功能仅在 MySQL 已配置为支持 SSL 时才有效。请参阅第 6.3 节，“使用加密连接”。

如果未key_str给出参数，则 DES_DECRYPT()检查加密字符串的第一个字节以确定用于加密原始字符串的 DES 密钥编号，然后从 DES 密钥文件中读取密钥以解密消息。为此，用户必须具有 SUPER特权。可以使用 --des-key-file服务器选项指定密钥文件。

如果您向此函数传递一个key_str 参数，则该字符串将用作解密消息的密钥。

如果crypt_str参数不是加密字符串，MySQL 返回给定的 crypt_str.

DES_ENCRYPT(str[,{key_num|key_str}])

使用 Triple-DES 算法使用给定的密钥加密字符串。

此功能仅在 MySQL 已配置为支持 SSL 时才有效。请参阅第 6.3 节，“使用加密连接”。

要使用的加密密钥是根据给定的第二个参数选择的DES_ENCRYPT()。如果没有参数，则使用 DES 密钥文件中的第一个密钥。使用key_num 参数时，将使用 DES 密钥文件中给定的密钥编号（0 到 9）。使用key_str参数，给定的密钥字符串用于加密 str。

可以使用 --des-key-file服务器选项指定密钥文件。

返回字符串是一个二进制字符串，其中第一个字符是。如果发生错误，则返回 。 CHAR(128 | key_num)DES_ENCRYPT()NULL

添加 128 是为了更容易识别加密密钥。如果使用字符串键， key_num则为 127。

结果的字符串长度由以下公式给出：

new_len = orig_len + (8 - (orig_len % 8)) + 1

DES 密钥文件中的每一行都具有以下格式：

key_num des_key_str

每个key_num值必须是从0到 范围内的数字9。文件中的行可以是任何顺序。 des_key_str是用于加密消息的字符串。数字和密钥之间至少应有一个空格。如果您没有为 指定任何键参数，则第一个键是使用的默认键DES_ENCRYPT()。

FLUSH DES_KEY_FILE 您可以使用语句 告诉 MySQL 从密钥文件中读取新的密钥值。这需要 RELOAD特权。

拥有一组默认密钥的一个好处是，它为应用程序提供了一种检查加密列值是否存在的方法，而无需为最终用户提供解密这些值的权利。

mysql> SELECT customer_address FROM customer_table 
    -> WHERE crypted_credit_card = DES_ENCRYPT('credit_card_number');

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

ENCODE(str,pass_str)

str使用 pass_str作为密码进行 加密。结果是与 长度相同的二进制字符串 str。要解密结果，请使用 DECODE().

ENCODE()不应再使用 该功能。如果您仍然需要使用 ENCODE()，则必须与它一起使用 salt 值以降低风险。例如：

ENCODE('cleartext', CONCAT('my_random_salt','my_secret_password'))

每当更新密码时，都必须使用新的随机盐值。

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

ENCRYPT(str[,salt])

str使用 Unix crypt()系统调用 加密并返回二进制字符串。salt参数必须是至少包含两个字符的字符串，否则结果 为NULL。如果没有salt 给出参数，则使用随机值。

mysql> SELECT ENCRYPT('hello');
        -> 'VxuFAJXVARROc'

ENCRYPT()忽略除 的前八个字符以外的所有字符str，至少在某些系统上是这样。此行为由底层crypt() 系统调用的实现决定。

不建议使用ENCRYPT()、 ucs2、或多字节字符集utf16， 因为系统调用需要一个以零字节结尾的字符串。 utf16leutf32

如果crypt()在您的系统上不可用（Windows 就是这种情况），则 ENCRYPT()始终返回 NULL.

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

MD5(str)

计算字符串的 MD5 128 位校验和。该值以 32 位十六进制数字的字符串形式返回，或者 NULL如果参数是 NULL. 例如，返回值可以用作散列键。请参阅本节开头有关有效存储哈希值的注释。

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

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

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

请参阅本节开头有关 MD5 算法的注释。

OLD_PASSWORD(str)

OLD_PASSWORD()PASSWORD()在 MySQL 4.1 中更改 实现时添加， 以提高安全性。OLD_PASSWORD()将 pre-4.1 实现的值 PASSWORD()作为字符串返回，旨在允许您为任何需要连接到 MySQL 服务器的 pre-4.1 客户端重置密码而不锁定它们。请参阅第 6.1.2.4 节，“MySQL 中的密码散列”。

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

PASSWORD(str)

返回根据明文密码计算的散列密码字符串str。返回值是连接字符集中的字符串，或者 NULL如果参数是 NULL. 此函数是服务器用于加密 MySQL 密码以存储在mysql.user授权表中的算法的 SQL 接口。

系统变量控制函数使用的old_passwords密码散列方法 PASSWORD()。它还会影响使用子句指定密码的语句CREATE USER执行 的密码散列 。 GRANTIDENTIFIED BY

下表显示了每种密码哈希方法的允许值old_passwords以及哪些身份验证插件使用该哈希方法。

如果old_passwords=1， 返回与 相同的值 。后一个函数不受 值的影响 。 PASSWORD(str)OLD_PASSWORD(str)old_passwords

mysql> SET old_passwords = 0;
mysql> SELECT PASSWORD('mypass'), OLD_PASSWORD('mypass');
+-------------------------------------------+------------------------+
| PASSWORD('mypass')                        | OLD_PASSWORD('mypass') |
+-------------------------------------------+------------------------+
| *6C8989366EAF75BB670AD8EA7A7FC1176A95CEF4 | 6f8c114b58f2ce9e       |
+-------------------------------------------+------------------------+

mysql> SET old_passwords = 1;
mysql> SELECT PASSWORD('mypass'), OLD_PASSWORD('mypass');
+--------------------+------------------------+
| PASSWORD('mypass') | OLD_PASSWORD('mypass') |
+--------------------+------------------------+
| 6f8c114b58f2ce9e   | 6f8c114b58f2ce9e       |
+--------------------+------------------------+

SHA-256 密码哈希 ( old_passwords=2) 使用随机盐值，这使得结果具有不 PASSWORD()确定性。因此，使用此函数的语句对于基于语句的复制是不安全的，并且不能存储在查询缓存中。

执行的加密 PASSWORD()是单向的（不可逆）。它与用于 Unix 密码的加密类型不同；为此，使用 ENCRYPT().

RANDOM_BYTES(len)

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

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

RANDOM_BYTES()生成一个随机值，这使得它的结果不确定。因此，使用此函数的语句对于基于语句的复制是不安全的，并且不能存储在查询缓存中。

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

此功能从 MySQL 5.6.17 开始可用。

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 时才有效。请参阅第 6.3 节，“使用加密连接”。

SHA2()可以认为在密码学上比 MD5()或 更安全SHA1()。

UNCOMPRESS(string_to_uncompress)

解压缩由 COMPRESS()函数压缩的字符串。如果参数不是压缩值，则结果为 NULL. 此功能要求 MySQL 编译时带有压缩库，例如 zlib. 否则，返回值始终为 NULL。

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

UNCOMPRESSED_LENGTH(compressed_string)

返回压缩字符串在压缩前的长度。

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

VALIDATE_PASSWORD_STRENGTH(str)

给定一个表示明文密码的参数，此函数返回一个整数以指示密码的强度。返回值范围从 0（弱）到 100（强）。

密码评估由 插件VALIDATE_PASSWORD_STRENGTH()完成。validate_password如果未安装该插件，该函数始终返回 0。有关安装的信息 validate_password，请参阅 第 6.4.3 节“密码验证插件”。要检查或配置影响密码测试的参数，请检查或设置由 实现的系统变量 validate_password。请参阅 第 6.4.3.2 节，“密码验证插件选项和变量”。

密码受到越来越严格的测试，返回值反映满足哪些测试，如下表所示。