mirror of
https://github.com/MariaDB/server.git
synced 2025-01-18 13:02:28 +01:00
09c80e12c5
Major replication test framework cleanup. This does the following:
- Ensure that all tests clean up the replication state when they
finish, by making check-testcase check the output of SHOW SLAVE STATUS.
This implies:
- Slave must not be running after test finished. This is good
because it removes the risk for sporadic errors in subsequent
tests when a test forgets to sync correctly.
- Slave SQL and IO errors must be cleared when test ends. This is
good because we will notice if a test gets an unexpected error in
the slave threads near the end.
- We no longer have to clean up before a test starts.
- Ensure that all tests that wait for an error in one of the slave
threads waits for a specific error. It is no longer possible to
source wait_for_slave_[sql|io]_to_stop.inc when there is an error
in one of the slave threads. This is good because:
- If a test expects an error but there is a bug that causes
another error to happen, or if it stops the slave thread without
an error, then we will notice.
- When developing tests, wait_for_*_to_[start|stop].inc will fail
immediately if there is an error in the relevant slave thread.
Before this patch, we had to wait for the timeout.
- Remove duplicated and repeated code for setting up unusual replication
topologies. Now, there is a single file that is capable of setting
up arbitrary topologies (include/rpl_init.inc, but
include/master-slave.inc is still available for the most common
topology). Tests can now end with include/rpl_end.inc, which will clean
up correctly no matter what topology is used. The topology can be
changed with include/rpl_change_topology.inc.
- Improved debug information when tests fail. This includes:
- debug info is printed on all servers configured by include/rpl_init.inc
- User can set $rpl_debug=1, which makes auxiliary replication files
print relevant debug info.
- Improved documentation for all auxiliary replication files. Now they
describe purpose, usage, parameters, and side effects.
- Many small code cleanups:
- Made have_innodb.inc output a sensible error message.
- Moved contents of rpl000017-slave.sh into rpl000017.test
- Added mysqltest variables that expose the current state of
disable_warnings/enable_warnings and friends.
- Too many to list here: see per-file comments for details.
75 lines
2.7 KiB
PHP
75 lines
2.7 KiB
PHP
# ==== Purpose ====
|
|
#
|
|
# Show selected columns of output from SHOW SLAVE STATUS.
|
|
#
|
|
# Note: test cases should never call SHOW SLAVE STATUS directly,
|
|
# because that outputs more information to the query log than what is
|
|
# needed for the property that is being tested. That would cause
|
|
# maintenance problems, because (1) it is hard for a human to
|
|
# understand what property is being tested; (2) the output of many of
|
|
# the fields is non-deterministic (e.g., Slave_IO_State) or changes
|
|
# frequently (e.g., binlog positions).
|
|
#
|
|
# Instead, what you want most of the time is to source one of the
|
|
# following scripts:
|
|
#
|
|
# include/check_slave_no_error.inc
|
|
# Assert that Slave_SQL_Errno = Slave_IO_Errno = 0.
|
|
#
|
|
# include/check_slave_is_running.inc
|
|
# Assert that Slave_IO_Running = Slave_SQL_Running = 'Yes'.
|
|
#
|
|
# include/wait_for_slave_sql_error.inc
|
|
# Wait for the SQL thread to get a given error (and assert that
|
|
# it has this error).
|
|
#
|
|
# include/wait_for_slave_io_error.inc
|
|
# Wait for the IO thread to get a given error (and assert that
|
|
# it has this error).
|
|
#
|
|
# include/wait_for_slave_sql_to_stop.inc
|
|
# include/wait_for_slave_io_to_stop.inc
|
|
# include/wait_for_slave_to_stop.inc
|
|
# Wait for the SQL thread, the IO thread, or both to stop (and
|
|
# assert they stop).
|
|
#
|
|
# When none of the above applies, you may use this script instead.
|
|
# However, take care so that the test never contains explicit binlog
|
|
# coordinates. Usually you can read the binlog coordinates into a
|
|
# variable and compare it to some other coordinates.
|
|
#
|
|
#
|
|
# ==== Usage ====
|
|
#
|
|
# --let $status_items= Column_Name[, Column_Name[, ...]]
|
|
# --source include/show_slave_status.inc
|
|
#
|
|
# Parameters:
|
|
# $status_items
|
|
# Set to the name of the column in the output of SHOW SLAVE STATUS
|
|
# that you want to display. Example:
|
|
#
|
|
# --let $status_items= Master_SSL_Allowed
|
|
#
|
|
# You can show multiple columns by setting $status_items to a
|
|
# comma-separated list. Example:
|
|
#
|
|
# --let $status_items= Master_Log_File, Relay_Master_Log_File
|
|
|
|
|
|
--let $_show_slave_status_items=$status_items
|
|
if (`SELECT "XX$status_items" = "XX"`)
|
|
{
|
|
--die Bug in test case: The mysqltest variable $status_items is not set.
|
|
}
|
|
|
|
|
|
while (`SELECT "XX$_show_slave_status_items" <> "XX"`)
|
|
{
|
|
--let $_show_slave_status_name= `SELECT SUBSTRING_INDEX('$_show_slave_status_items', ',', 1)`
|
|
--let $_show_slave_status_items= `SELECT LTRIM(SUBSTRING('$_show_slave_status_items', LENGTH('$_show_slave_status_name') + 2))`
|
|
|
|
--let $_show_slave_status_value= query_get_value(SHOW SLAVE STATUS, $_show_slave_status_name, 1)
|
|
--let $_show_slave_status_value= `SELECT REPLACE("$_show_slave_status_value", '$MYSQL_TEST_DIR', 'MYSQL_TEST_DIR')`
|
|
--echo $_show_slave_status_name = '$_show_slave_status_value'
|
|
}
|