Сервер использует кэш хостов только для нелокальных 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, если есть проблемы с сетью.