--echo ######################################################################## --echo # --echo # Verify definitions of DD tables. --echo # -------------------------------- --echo # This test has four parts: --echo # --echo # 1. Verify the hard coded ids of the mysql schema, the mysql --echo # tablespace, the dd_properties table, and the --echo # innodb_dynamic_metadata table. --echo # 2. Verify the existence of the expected DD tables, neither less nor --echo # more. --echo # 3. Verify the DD_VERSION and the CREATE TABLE statements of the --echo # DD tables. --echo # 4. Verify the checksum of the generated meta data associated with the --echo # current DD version number. --echo # --echo ######################################################################## --echo # --echo # A note regarding the checksum usage. --echo # ------------------------------------ --echo # This is based on a test by Marc Alff (perfschema.dd_version_check). --echo # The idea is to keep a record of each DD version released with the --echo # DD version number and a checksum created based on the meta data for --echo # the DD tables. It is important not to change the expected checksum --echo # once a release has been published. --echo # --echo # If there was an intentional change, leading to a new checksum, then: --echo # --echo # 1. Uncomment the debug output showing the low level meta data and --echo # verify that the changes are intentional. --echo # 2. Create a new target DD version (unless the existing target DD --echo # version is not publicly released yet). --echo # 3. Add a new row in test.dd_published_schema with the new target --echo # DD version and the new checksum (or update the expected --echo # checksum if the target DD version is not publicly released yet). --echo # --echo # Note that a failure to do 2, when doing 3, will result in a broken --echo # upgrade where the server code is expecting a certain DD table --echo # definition, while the actual persisted DD table definition is --echo # different (because it was created by a previous server binary, and --echo # DD upgrade handling was not triggered). --echo # --echo # Thus, this part of the test is designed to be a reminder to do 2. --echo # by detecting differences in 3. --echo # --echo ######################################################################## --echo # --echo # How to handle test failures. --echo # ---------------------------- --echo # In general, if there is a change leading to a failure in this test, --echo # then we must first consider whether the change is intentional, i.e., --echo # whether there is a change in a DD table definition or DD bootstrap --echo # code that we actually want to do, or whether the change is by mistake --echo # or not needed. --echo # --echo # Then, if the change is intentional, we must make sure the following --echo # scenarios are handled: --echo # --echo # 1. Plain initialization of the server. This is most likely handled, --echo # otherwise we wouldn't even get to the point where this test starts --echo # failing. --echo # 2. Plain server restart using a data directory initialized by this --echo # server. --echo # 3. Upgrade from any supported DD version, or server restart using --echo # a data directory from a different server version using the same --echo # DD version. --echo # 4. Minor downgrade to any DD version within the minor downgrade --echo # threshold, or restart of a different server version using the --echo # data directory initialized by this server. --echo # --echo # Failures in the different parts of the test must be handled as --echo # follows: --echo # --echo # * A failure in part 1 means that the server may not be able to start, --echo # e.g. if we restart a previous server version (expecting different --echo # ids) using a data directory initialized by this server version. --echo # * A failure in part 2 means that a DD table is added or removed. --echo # In this case, please make sure the tables 'dd_table_names' and --echo # 'ddse_table_names' below are kept up to date. Also make sure that --echo # the list of SHOW CREATE TABLE statements is up to date. --echo # * A failure in part 2 or 3 means that there is a change in the DD --echo # table definitions, and that we have a new DD version. So --echo # if the current target DD version number is released publicly, --echo # then we must bump the target DD version. If the DD version is --echo # not yet released, and has already been bumped, then it should --echo # stay the same. Additionally, we must add server code to handle --echo # the DD upgrade. This test must have its results re-recorded. A --echo # failure in part 2 or 3 will most likely also lead to a failure --echo # in part 4. --echo # * A failure in part 4 means that the generated meta data is --echo # different than it used to be. If there is a change in part 2 or --echo # 3, this is to be expected. In that case, the test results must --echo # be re-recorded, and we must either update the expected checksum --echo # (if the DD version stays the same) or add the new DD version --echo # along with the expected checksum. However, if there is not a --echo # change in part 2 or 3, then we have changes in the SQL DDL --echo # semantics. This should be handled by changing the DD initialization --echo # procedure to either tweak the DDL statements before execution --echo # (without changing the DDL statements that are stored in the --echo # mysql.dd_properties table), or by tweaking the generated low --echo # level meta data. Either way, the result of the changes to the --echo # server code should be that this test stops failing. --echo # --echo ######################################################################## --source include/have_debug.inc --echo # PART 1 --source include/dd_schema_assert_ids.inc --echo # PART 2 # Create tables to hold the DD table names, they are needed later in this test. let $ddse_table_names = test.ddse_table_names; let $dd_table_names = test.dd_table_names; eval CREATE TABLE $ddse_table_names (name VARCHAR(64) PRIMARY KEY); eval CREATE TABLE $dd_table_names (name VARCHAR(64) PRIMARY KEY); --source include/dd_schema_assert_and_fill_table_names.inc --echo # PART 3 --source include/dd_schema_dump_table_defs_debug.inc --echo # PART 4 --echo ######################################################################## --echo # Create a checksum associated with the current DD version. Compare this --echo # with an already recorded checksum. --echo ######################################################################## SET debug = '+d,skip_dd_table_access_check'; --disable_query_log CREATE TABLE dd_check_table (id INT(11) NOT NULL AUTO_INCREMENT PRIMARY KEY, t TEXT NOT NULL, row_hash VARCHAR(64) DEFAULT NULL); # Expression representing the DD table ids let $dd_table_ids = SELECT id FROM mysql.tables WHERE schema_id = 1 AND name IN (SELECT name FROM $dd_table_names UNION SELECT name FROM $ddse_table_names); # Schema meta data excluding timestamps. Id is fixed even across versions. INSERT INTO dd_check_table(t) SELECT CONCAT(id, '-', catalog_id, '-', name, '-', default_collation_id, '-', IFNULL(options, 'NULL')) FROM mysql.schemata WHERE name = 'mysql'; # Tablespace meta data excluding timestamps. Filter out server version. Id is fixed. INSERT INTO dd_check_table(t) SELECT CONCAT(id, '-', name, '-', IFNULL(options, 'NULL'), '-', IFNULL(INSERT(se_private_data, INSTR(se_private_data, 'server_version'), 20, 'server_version=x'), 'NULL'), '-', comment, '-', engine) FROM mysql.tablespaces WHERE name = 'mysql'; # Subset of definitions from tables, not including # timestamps, partitioning, view definitions and # default values eval INSERT INTO dd_check_table(t) SELECT CONCAT(id, '-', name, '-', type, '-', engine, '-', collation_id, '-', comment, '-', hidden, '-', IFNULL(options, 'NULL'), '-', IFNULL(se_private_data, 'NULL'), '-', se_private_id, '-', tablespace_id) FROM mysql.tables WHERE id IN ($dd_table_ids) ORDER BY id; # Subset of definitions from columns, not including # default_values. eval INSERT INTO dd_check_table(t) SELECT CONCAT(id, '-', table_id, '-', name, '-', ordinal_position, '-', type, '-', is_nullable, '-', IFNULL(is_zerofill, 'NULL'), '-', IFNULL(is_unsigned, 'NULL'), '-', IFNULL(char_length, 'NULL'), '-', IFNULL(numeric_precision, 'NULL'), '-', IFNULL(numeric_scale, 'NULL'), '-', IFNULL(datetime_precision, 'NULL'), '-', IFNULL(collation_id, 'NULL'), '-', IFNULL(default_option, 'NULL'), '-', IFNULL(update_option, 'NULL'), '-', IFNULL(is_auto_increment, 'NULL'), '-', comment, '-', hidden, '-', IFNULL(options, 'NULL'), '-', IFNULL(se_private_data, 'NULL')) FROM mysql.columns WHERE table_id IN ($dd_table_ids) ORDER BY id; # Definitions from indexes. eval INSERT INTO dd_check_table(t) SELECT CONCAT( id, '-', table_id, '-', name, '-', type, '-', algorithm, '-', is_algorithm_explicit, '-', is_visible, '-', is_generated, '-', hidden, '-', ordinal_position, '-', comment, '-', IFNULL(options, 'NULL'), '-', IFNULL(se_private_data, 'NULL'), '-', IFNULL(tablespace_id, 'NULL'), '-', engine) FROM mysql.indexes WHERE table_id IN ($dd_table_ids) ORDER BY id; # Definitions from index_column_usage. eval INSERT INTO dd_check_table(t) SELECT CONCAT( index_id, '-', ordinal_position, '-', column_id, '-', IFNULL(length, 'NULL'), '-', `order`, '-', hidden) FROM mysql.index_column_usage WHERE index_id IN ( SELECT id FROM mysql.indexes WHERE table_id IN ($dd_table_ids) ) ORDER BY index_id, column_id; # Definitions from foreign_keys. eval INSERT INTO dd_check_table(t) SELECT CONCAT( id, '-', schema_id, '-', table_id, '-', name, '-', IFNULL(unique_constraint_name, 'NULL'), '-', match_option, '-', update_rule, '-', delete_rule, '-', referenced_table_catalog, '-', referenced_table_schema, '-', referenced_table_name, '-', IFNULL(options, 'NULL')) FROM mysql.foreign_keys WHERE table_id IN ($dd_table_ids) ORDER BY id; # Definitions from foreign_key_column_usage. eval INSERT INTO dd_check_table(t) SELECT CONCAT( foreign_key_id, '-', ordinal_position, '-', column_id, '-', referenced_column_name) FROM mysql.foreign_key_column_usage WHERE foreign_key_id IN ( SELECT id FROM mysql.foreign_keys WHERE table_id IN ($dd_table_ids) ) ORDER BY foreign_key_id, ordinal_position; # Create checksums for each row. UPDATE dd_check_table SET row_hash = SHA2(t, 256); # And then a checksum of all rows. We need about 1500 rows of varchar(64) # concatenated. SET @old_group_concat_max_len = @@group_concat_max_len; SET group_concat_max_len = 100000; CREATE TABLE whole_schema(row_checksums LONGTEXT, checksum VARCHAR(64)); INSERT INTO whole_schema (row_checksums) SELECT GROUP_CONCAT(row_hash ORDER BY id) FROM dd_check_table; UPDATE whole_schema SET checksum = SHA2(row_checksums, 256); let $assert_cond = "[SELECT LENGTH(row_checksums) FROM whole_schema]" < @@group_concat_max_len; --let $assert_text = The group concat max length is sufficient. --source include/assert.inc # Insert historical records of DD version numbers and checksums. For a # new DD version, add a new row below. Please read the comments at the # beginning of the test file to make sure this is done correctly. Note # that the checksums are different depending on case sensitivity of the # underlying file system. Hence, the lctn field is used as a discriminator # (lctn = lower case table names). CREATE TABLE dd_published_schema( version VARCHAR(20), lctn BOOL, checksum VARCHAR(64), PRIMARY KEY (version, lctn)); # Checksums with ids. INSERT INTO dd_published_schema VALUES ('80004', 0, '7de8b2fe214be4dbb15c3d8e4c08ab74f190bca269dd08861a4cf66ea5de1804'); INSERT INTO dd_published_schema VALUES ('80004', 1, 'f607ab08b2d2b2d93d8867ad75116655d9c942647245d7846be440ec916c440f'); INSERT INTO dd_published_schema VALUES ('80011', 0, 'e849364aeb724ff89f9d4d01bea6e933b9f0ef5087b4098a83acbe584a2f0702'); INSERT INTO dd_published_schema VALUES ('80011', 1, 'ac9e620d1fcd8389cce7660c7f7bbc0acbe3a31fd52799ef8816981bf6de73fd'); INSERT INTO dd_published_schema VALUES ('80012', 0, '99a69f08be21df8b57153fa84f393dee3deb01ad43551d7268718db479c4d102'); INSERT INTO dd_published_schema VALUES ('80012', 1, '3ae447b4c0b3d3575978bad87c6d8b47de6066a28d408d2ba563fb7b84f6fdfa'); INSERT INTO dd_published_schema VALUES ('80013', 0, '2839a06b849f7f622b51ddc9ad8c8b73d8d8437a930ddbdc7224e76ab0ea65c5'); INSERT INTO dd_published_schema VALUES ('80013', 1, 'cabd11189d82dd3f93c9affa5a998d684f8ed617848d9787a38ba098472bae02'); INSERT INTO dd_published_schema VALUES ('80014', 0, 'a1602dbb8a2af87654c3880adb8dfb977d2f0fab6e3a54d8b44f5ceff7782959'); INSERT INTO dd_published_schema VALUES ('80014', 1, 'cc5651651505fe0a4ebccb74d82e6fcd9555a4bd29478e21637c95da98f4537c'); # Note: DD version 80015 was never published, it's similar to 80014. INSERT INTO dd_published_schema VALUES('80016', 0, '53c96d1a123e9b4370aef8e9f0d0396860f78f7dd0b8e6ce89faa9c3fddd1da6'); INSERT INTO dd_published_schema VALUES('80016', 1, '4dfe903c56e29601504a494bcc881055115b2f5d32cee32462708c233f5e1434'); INSERT INTO dd_published_schema VALUES('80017', 0, '096c3d8c87873eb917cb03cd0a701f74e49587904836061ef9ca33c253eeb3ca'); INSERT INTO dd_published_schema VALUES('80017', 1, '76c4ef5922cfd8e2a736e538ada4b03b6b122fbd0df2ac5abfbd999e3316b17b'); SELECT IFNULL(CONCAT('The schema checksum corresponds to DD version ', version, '.'), CONCAT('No DD version found with schema checksum ', whole_schema.checksum, '.')) AS CHECK_STATUS FROM dd_published_schema RIGHT OUTER JOIN whole_schema ON dd_published_schema.checksum= whole_schema.checksum; # Please read the comments at the beginning of the test file to make sure an # error in the assert below is handled correctly. let $assert_cond = "[SELECT COUNT(version) FROM dd_published_schema, whole_schema WHERE dd_published_schema.checksum = whole_schema.checksum AND lctn = @@global.lower_case_file_system]" = 1; --let $assert_text = The schema checksum corresponds to a known DD version. --source include/assert.inc SET group_concat_max_len = @old_group_concat_max_len; eval DROP TABLES dd_check_table, whole_schema, dd_published_schema, $dd_table_names, $ddse_table_names; SET debug = '-d,skip_dd_table_access_check'; --enable_query_log