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