Сервер использует кэш хостов только для нелокальных TCP-соединений. Он не использует кэш для TCP-соединений, установленных с использованием адреса интерфейса обратной связи (например, 127.0.0.1 или ::1), или для соединений, установленных с использованием файла Unix-соккета, именованной трубы или общей памяти.

Сервер использует кэш хостов для нескольких целей:

Для каждого нового подключения клиента сервер использует IP-адрес клиента, чтобы проверить, находится ли имя хоста клиента в кэше хостов. Если да, сервер отклоняет или продолжает обрабатывать запрос на подключение в зависимости от того, заблокирован ли хост. Если хост не найден в кэше, сервер пытается разрешить имя хоста. Сначала он преобразует IP-адрес в имя хоста и преобразует имя хоста обратно в IP-адрес. Затем он сравнивает результат с исходным IP-адресом, чтобы убедиться, что они совпадают. Сервер сохраняет информацию о результате этой операции в кэше хостов. Если кэш заполнен, удаляется запись с наименьшим временем последнего использования.

Сервер выполняет разрешение имен хостов с помощью системного вызова getaddrinfo().

Сервер обрабатывает записи в кэше хостов следующим образом:

Чтобы разблокировать заблокированные хосты, очистите кэш хостов; см. Обработку заблокированных хостов.

Заблокированный хост может стать разблокированным даже без очистки кэша хостов, если произошла активность с других хостов:

Некоторые ошибки подключения не связаны с TCP-соединениями, возникают очень рано в процессе подключения (даже до того, как известен IP-адрес) или не специфичны для какого-либо конкретного IP-адреса (например, условия недостатка памяти). Сведения об этих ошибках можно найти в переменных состояния сервера Connection_errors_xxx (см. Раздел 5.1.9, «Переменные состояния сервера»).

Кэш хостов включен по умолчанию. Системная переменная host_cache_size управляет его размером, а также размером таблицы host_cache Схемы производительности, которая отображает содержимое кэша. Размер кэша можно задать при запуске сервера и изменить во время выполнения. Например, чтобы установить размер в 100 при запуске, поместите эти строки в файл сервера my.cnf:

[mysqld]
host_cache_size=200

Чтобы изменить размер на 300 во время выполнения, сделайте следующее:

SET GLOBAL host_cache_size=300;

Установка значения host_cache_size в 0, как при запуске сервера, так и во время выполнения, отключает кэш хостов. При отключенном кэше сервер выполняет DNS-запрос каждый раз при подключении клиента.

Изменение размера кэша во время выполнения вызывает неявную операцию очистки кэша хостов, которая очищает кэш хостов, обнуляет таблицу host_cache и разблокирует любые заблокированные хосты; см. Очистку кэша хостов.

Использование опции --skip-host-cache аналогично установке системной переменной host_cache_size в 0, но host_cache_size более гибкая, поскольку ее можно использовать для изменения размера, включения и отключения кэша хостов во время выполнения, а не только при запуске сервера. Запуск сервера с опцией --skip-host-cache не препятствует внесению изменений в значение host_cache_size во время выполнения, но такие изменения не имеют эффекта, и кэш не включается даже если host_cache_size задано больше 0.

Чтобы отключить DNS-поиск имен хостов, запустите сервер с включенной системной переменной skip_name_resolve. В этом случае сервер использует только IP-адреса, а не имена хостов, чтобы сопоставить подключаемые хосты со строками в таблицах разрешений MySQL. Могут быть использованы только учетные записи, указанные в этих таблицах с использованием IP-адресов. (Клиент не сможет подключиться, если не существует учетной записи, которая указывает IP-адрес клиента.)

При наличии очень медленного DNS и большого количества хостов, вы можете улучшить производительность, включив skip_name_resolve для отключения DNS-запросов или увеличив значение host_cache_size для увеличения размера кэша хостов.

Чтобы полностью запретить TCP/IP-соединения, запустите сервер с включенной системной переменной skip_networking.

Чтобы настроить допустимое количество последовательных ошибок подключения перед блокировкой хоста, установите системную переменную max_connect_errors. Например, чтобы установить значение при запуске, поместите эти строки в файл сервера my.cnf:

[mysqld]
max_connect_errors=10000

Чтобы изменить значение во время выполнения, сделайте следующее:

SET GLOBAL max_connect_errors=10000;

Таблица host_cache Схемы производительности отображает содержимое кэша хостов. Эту таблицу можно просмотреть с помощью операторов SELECT, что может помочь в диагностике причин проблем с подключением. Схема производительности должна быть включена, иначе эта таблица будет пустой. Сведения о этой таблице см. в Разделе 25.12.16.1, «Таблица host_cache».

Очистка кэша хостов может быть желательной в следующих случаях:

Очистка кэша хостов приводит к следующим эффектам:

Для очистки кэша хостов можно использовать следующие методы:

Сервер использует кэш хостов для отслеживания ошибок, возникающих во время процесса подключения клиента. Если возникает следующая ошибка, это означает, что mysqld получил много запросов на подключение с данного хоста, прерванных на середине:

Host 'host_name' is blocked because of many connection errors.
Unblock with 'mysqladmin flush-hosts'

Значение системной переменной max_connect_errors определяет, сколько последовательных прерванных запросов на подключение сервер допускает перед блокировкой хоста. После max_connect_errors неудачных запросов без успешного подключения сервер предполагает, что что-то не так (например, кто-то пытается взломать), и блокирует хост от дальнейших запросов на подключение.

Чтобы разблокировать заблокированные хосты, очистите кэш хостов; см. Очистка кэша хостов.

В качестве альтернативы, чтобы избежать появления сообщения об ошибке, установите max_connect_errors, как описано в Настройка кэша хостов. Значение по умолчанию max_connect_errors равно 100. Увеличение max_connect_errors до большого значения уменьшает вероятность того, что хост достигнет порога и будет заблокирован. Однако, если возникает ошибка Host 'host_name' is blocked, сначала проверьте, нет ли проблем с TCP/IP-соединениями с заблокированных хостов. Не имеет смысла увеличивать значение max_connect_errors, если есть проблемы с сетью.