语法
select master_pos_wait(file, pos[, timeout]).
File
和pos
是对应的主库的值,可以通过show master status
得到。
Timeout
是等待的秒数。不加代表为0
,立即返回结果。如果指定了时间,但是已经达到了position
,那么还是会立即返回。也就是等待事件在从库未到达指定的position
才生效。
这个函数主要用于从库执行,查看从库是否已经执行到了指定的主库上binlog position
。
主库查看
mysql> show binary logs;
+------------------+-----------+
| Log_name | File_size |
+------------------+-----------+
| mysql-bin.000001 | 51635123 |
+------------------+-----------+
1 row in set (0.00 sec)
从库执行:
mysql> SELECT MASTER_POS_WAIT(' mysql-bin.000001', 51635123,60);
+--------------------------------------------------+
| MASTER_POS_WAIT('mysql-bin.000001', 51635123,60) |
+--------------------------------------------------+
| 0 |
+--------------------------------------------------+
1 row in set (0.00 sec)
返回值为0
,代表从库已经应用了mysql-bin.000001 51635123
位置的数据。
下面将pos
值加1
mysql> SELECT MASTER_POS_WAIT('mysql-bin.000001', 51635124);
一直在等待,不返回结果。
主库执行一个事务后,pos
肯定超越了51635124
,从库应用后返回结果1
,如下:
+-----------------------------------------------+
| MASTER_POS_WAIT('mysql-bin.000001', 51635124) |
+-----------------------------------------------+
| 1 |
+-----------------------------------------------+
1 row in set (50.66 sec)
从库pos+1
,这次指定时间为5
,五秒后未达到,返回-1
mysql> SELECT MASTER_POS_WAIT('mysql-bin.000001', 51635390,5);
+-------------------------------------------------+
| MASTER_POS_WAIT('mysql-bin.000001', 51635390,5) |
+-------------------------------------------------+
| -1 |
+-------------------------------------------------+
1 row in set (5.00 sec)
从库执行stop slave sql_thread;
返回null
mysql> SELECT MASTER_POS_WAIT('mysql-bin.000001', 51635390,60);
+--------------------------------------------------+
| MASTER_POS_WAIT('mysql-bin.000001', 51635390,60) |
+--------------------------------------------------+
| NULL |
+--------------------------------------------------+
1 row in set (2.32 sec)
Action
Return
无论是否指定时间,达到
0
指定时间内达到
1
指定时间内未达到
-1
stop slave sql_thread;
NULL