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 取得），您可以指定選用的鹽和特定於內容的資訊以包含在金鑰材料中，以及 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 節，「Performance Schema 語句摘要與採樣」。

這兩個函數都使用 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 系統變數如何設定，VALIDATE_PASSWORD_STRENGTH() 都會傳回 0。