1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389
|
--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');
INSERT INTO dd_published_schema
VALUES('80021', 0,
'80557e59b7af79e8a43e4b5efb7d5bab6a2db966935f0fe411b05b81cfdd1252');
INSERT INTO dd_published_schema
VALUES('80021', 1,
'1e886824945b448e2636e16360fc2078c33cf7980d07d13d62913d8a1d33e7f5');
INSERT INTO dd_published_schema
VALUES('80022', 0,
'5329f0032a5ea7cae6adcbfa5519c2aca93f8eacc99db4d9ff463320196e87e5');
INSERT INTO dd_published_schema
VALUES('80022', 1,
'90493021c4a9565f9bd050481f046dbf7e0741f647397a1d8b46aaadd8581484');
INSERT INTO dd_published_schema
VALUES('80023', 0,
'ba451f47c6774de7dddec4417b8a923e9ada805ec9ca68e9ef56b3ba6bd414f3');
INSERT INTO dd_published_schema
VALUES('80023', 1,
'6e3311099b985c198bb3acbc88495825847dac79588dea4f0be2e4219ad7c52b');
--sorted_result
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
|