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

Эта функция расшифровывает данные с использованием официального алгоритма AES (Advanced Encryption Standard). Дополнительную информацию см. в описании AES_ENCRYPT().

Операторы, использующие AES_DECRYPT(), небезопасны для репликации на основе операторов.

COMPRESS(string_to_compress)

Сжимает строку и возвращает результат в виде двоичной строки. Эта функция требует, чтобы MySQL был скомпилирован с библиотекой сжатия, такой как zlib. В противном случае возвращаемое значение всегда равно NULL. Возвращаемое значение также равно NULL, если string_to_compress равно 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, если аргумент был NULL. Возвращаемое значение, например, может использоваться в качестве ключа хеширования. См. примечания в начале этого раздела о том, как эффективно хранить значения хешей.

Возвращаемое значение — строка в наборе символов соединения.

Если режим FIPS включен, MD5() возвращает NULL. См. Раздел 8.8, «Поддержка FIPS».

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

Это “алгоритм MD5 для вычисления дайджеста сообщения (RSA Data Security, Inc.)”.

См. примечание относительно алгоритма MD5 в начале этого раздела.

RANDOM_BYTES(len)

Эта функция возвращает двоичную строку из len случайных байтов, сгенерированных с помощью генератора случайных чисел библиотеки SSL. Допустимые значения для len находятся в диапазоне от 1 до 1024. При значениях вне этого диапазона возникает ошибка. Возвращает NULL, если 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 (алгоритм безопасного хеширования). Значение возвращается в виде строки из 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)

Возвращает длину сжатой строки до сжатия. Возвращает NULL, если compressed_string равно 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.