FQDN хостов MySQL®
Для подключения к хосту потребуется его FQDN — доменное имя. Вы можете использовать FQDN конкретного хоста в кластере или один из особых FQDN, всегда указывающий на текущий хост-мастер или наименее отстающую реплику.
Пример FQDN хоста:
rc1a-goh2a9tr********.mdb.yandexcloud.kz
Помимо обычных FQDN, для подключения к кластеру можно использовать особые FQDN и алиасы.
Получить FQDN хоста
FQDN хоста MySQL® можно получить несколькими способами:
-
Посмотрите FQDN в консоли управления:
- Перейдите на страницу кластера.
- Перейдите в раздел Хосты.
- Скопируйте значение в столбце FQDN хоста.
-
Скопируйте команду для подключения к кластеру в консоли управления
. Команда содержит заполненный FQDN хоста. Чтобы получить команду, перейдите на страницу кластера и нажмите кнопку Подключиться. -
Запросите список хостов в кластере с помощью CLI или API.
Особые FQDN
Managed Service for MySQL® предоставляет следующие особые FQDN:
В кластерах из нескольких хостов особые FQDN могут некоторое время (до 10 минут) указывать на старый хост, даже если он сменил роль (например, из мастера стал репликой). Если используется особый FQDN, который указывает на текущий мастер, то часть запросов на запись может завершиться неудачей — они могут быть направлены к реплике. Это связано с тем, что на обновление DNS-записей для особых FQDN требуется время. Если запрос на запись завершился ошибкой, повторите его позднее.
Важно
Если при автоматической смене мастера новым мастером или наименее отстающей репликой станет хост без публичного доступа, подключиться к такому хосту из интернета будет невозможно. Чтобы этого избежать, включите публичный доступ для всех хостов кластера.
Текущий мастер
FQDN вида c-<идентификатор_кластера>.rw.mdb.yandexcloud.kz всегда указывает на текущий хост-мастер в кластере. Идентификатор кластера можно получить со списком кластеров в каталоге.
При подключении к этому FQDN разрешено выполнять операции чтения и записи.
Важно
Используйте подключение с помощью особого FQDN хоста-мастера только для процессов, которые допускают недоступность базы данных на запись продолжительностью до 10 минут.
Наименее отстающая реплика
FQDN вида c-<идентификатор_кластера>.ro.mdb.yandexcloud.kz указывает на наименее отстающую от мастера реплику. Идентификатор кластера можно запросить со списком кластеров в каталоге.
Особенности:
- При подключении к этому FQDN разрешено выполнять только операции чтения.
- Если в кластере нет активных реплик, то подключиться к этому FQDN невозможно: соответствующая CNAME-запись в DNS будет указывать на пустой объект (
null).
Алиасы
Алиасы позволяют обращаться к мастеру, наименее отстающей реплике, а также к каждому конкретному хосту кластера Managed Service for MySQL® по стабильному человекочитаемому имени, независимо от внутренних FQDN. Алиасы задаются пользователем и могут использоваться наравне с обычными и особыми FQDN.
Алиас кластера
Алиас кластера всегда указывает на текущий хост-мастер в кластере Managed Service for MySQL®. Имеет следующий вид:
c-<краткое_имя>-my-<идентификатор_каталога>.rw.mdb.yandexcloud.kz
Где <краткое_имя> — условное имя, которое задается пользователем при формировании алиаса.
Алиас кластера должен быть уникальным в рамках каталога. Для каждого кластера можно назначить только один алиас.
Алиасы кластеров позволяют переключить нагрузку с одного кластера на другой, например после восстановления из бэкапа. Для переключения достаточно переместить алиас между кластерами. При этом вносить изменения на стороне приложения не требуется.
Важно
После переключения мастера может потребоваться до 10 минут на обновление DNS-записей. В течение этого времени алиас кластера может указывать на старый хост, который уже стал репликой. Используйте алиас кластера только для процессов, которые допускают недоступность базы данных на запись продолжительностью до 10 минут.
Алиасы хостов
Алиас, указывающий на конкретный хост в кластере, имеет следующий вид:
h-<краткое_имя_хоста>-my-<идентификатор_каталога>.mdb.yandexcloud.kz
Где <краткое_имя_хоста> — условное имя, которое задается пользователем при формировании алиаса хоста.
Алиас хоста должен быть уникальным в рамках каталога. Для каждого хоста можно назначить только один алиас.