MASTER_POS_WAIT

Синтаксис

MASTER_POS_WAIT(log_name,log_pos[,timeout,["connection_name"]])

Описание

Эта функция полезна в репликации для управления синхронизацией мастер-реплики. Она блокируется до тех пор, пока реплика не прочитает и не применит все обновления до указанной позиции (log_name,log_pos) в журнале мастера. Возвращаемое значение — количество событий журнала, на которые реплике пришлось подождать, чтобы продвинуться до указанной позиции. Функция возвращает NULL, если поток SQL реплики не запущен, информация о мастере реплики не инициализирована, аргументы неверны или произошла ошибка. Она возвращает -1, если таймаут истек. Если поток SQL реплики останавливается, пока MASTER_POS_WAIT() ожидает, функция возвращает NULL. Если реплика находится за указанной позицией, функция возвращает значение немедленно.

Если указано значение timeout, MASTER_POS_WAIT() прекращает ожидание, когда истекло timeout секунд. timeout должно быть больше 0; нулевое или отрицательное значение timeout означает отсутствие timeout.

connection_name используется при использовании многоисточниковой репликации. Если не указано, оно устанавливается в значение системной переменной default_master_connection.

Выражения, использующие функцию MASTER_POS_WAIT(), не являются безопасными для репликации.