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

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

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

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

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

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

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

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

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

[mysqld]
host_cache_size=200

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

SET GLOBAL host_cache_size=300;

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

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

Чтобы отключить поиск по 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;

Таблица Performance Schema host_cache предоставляет содержимое кэша хостов. Эту таблицу можно просмотреть с помощью операторов SELECT, что может помочь в диагностике причин проблем с подключением. Подробную информацию об этой таблице см. в Разделе 29.12.22.3, «Таблица 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, если есть проблемы с сетью.