Expand performance_schema tables definitions with column comments

Cover all columns that did not have comments. Adjust docs based off of
MariaDB implementation.

mysql-test/suite/perfschema/r/ddl_events_stages_current.result

@@ -6,5 +6,5 @@ ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_
 CREATE UNIQUE INDEX test_index ON performance_schema.events_stages_current(EVENT_ID);
 ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_schema'
 TABLE_CATALOG	TABLE_SCHEMA	TABLE_NAME	COLUMN_NAME	ORDINAL_POSITION	COLUMN_DEFAULT	IS_NULLABLE	DATA_TYPE	CHARACTER_MAXIMUM_LENGTH	CHARACTER_OCTET_LENGTH	NUMERIC_PRECISION	NUMERIC_SCALE	DATETIME_PRECISION	CHARACTER_SET_NAME	COLLATION_NAME	COLUMN_TYPE	COLUMN_KEY	EXTRA	PRIVILEGES	COLUMN_COMMENT	IS_GENERATED	GENERATION_EXPRESSION
-def	performance_schema	events_stages_current	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
-def	performance_schema	events_stages_current	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
+def	performance_schema	events_stages_current	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL
+def	performance_schema	events_stages_current	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL

mysql-test/suite/perfschema/r/ddl_events_stages_history.result

@@ -6,5 +6,5 @@ ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_
 CREATE UNIQUE INDEX test_index ON performance_schema.events_stages_history(EVENT_ID);
 ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_schema'
 TABLE_CATALOG	TABLE_SCHEMA	TABLE_NAME	COLUMN_NAME	ORDINAL_POSITION	COLUMN_DEFAULT	IS_NULLABLE	DATA_TYPE	CHARACTER_MAXIMUM_LENGTH	CHARACTER_OCTET_LENGTH	NUMERIC_PRECISION	NUMERIC_SCALE	DATETIME_PRECISION	CHARACTER_SET_NAME	COLLATION_NAME	COLUMN_TYPE	COLUMN_KEY	EXTRA	PRIVILEGES	COLUMN_COMMENT	IS_GENERATED	GENERATION_EXPRESSION
-def	performance_schema	events_stages_history	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
-def	performance_schema	events_stages_history	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
+def	performance_schema	events_stages_history	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL
+def	performance_schema	events_stages_history	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL

mysql-test/suite/perfschema/r/ddl_events_stages_history_long.result

@@ -6,5 +6,5 @@ ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_
 CREATE UNIQUE INDEX test_index ON performance_schema.events_stages_history_long(EVENT_ID);
 ERROR 42000: Access denied for user 'root'@'localhost' to database 'performance_schema'
 TABLE_CATALOG	TABLE_SCHEMA	TABLE_NAME	COLUMN_NAME	ORDINAL_POSITION	COLUMN_DEFAULT	IS_NULLABLE	DATA_TYPE	CHARACTER_MAXIMUM_LENGTH	CHARACTER_OCTET_LENGTH	NUMERIC_PRECISION	NUMERIC_SCALE	DATETIME_PRECISION	CHARACTER_SET_NAME	COLLATION_NAME	COLUMN_TYPE	COLUMN_KEY	EXTRA	PRIVILEGES	COLUMN_COMMENT	IS_GENERATED	GENERATION_EXPRESSION
-def	performance_schema	events_stages_history_long	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
-def	performance_schema	events_stages_history_long	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references		NEVER	NULL
+def	performance_schema	events_stages_history_long	WORK_COMPLETED	9	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL
+def	performance_schema	events_stages_history_long	WORK_ESTIMATED	10	NULL	YES	bigint	NULL	NULL	20	0	NULL	NULL	NULL	bigint(20) unsigned			select,insert,update,references	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.	NEVER	NULL

mysql-test/suite/perfschema/r/dml_events_stages_current.result

@@ -38,7 +38,7 @@ SOURCE	Name and line number of the source file containing the instrumented code
 TIMER_START	Value in picoseconds when the event timing started or NULL if timing is not collected.
 TIMER_END	Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.
 TIMER_WAIT	Value in picoseconds of the event's duration or NULL if the event has not ended or timing is not collected.
-WORK_COMPLETED	
-WORK_ESTIMATED	
+WORK_COMPLETED	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.
+WORK_ESTIMATED	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.
 NESTING_EVENT_ID	EVENT_ID of event within which this event nests.
-NESTING_EVENT_TYPE	Nesting event type. Either statement, stage or wait.
+NESTING_EVENT_TYPE	Nesting event type. Either transaction, statement, stage or wait.

mysql-test/suite/perfschema/r/dml_events_stages_history.result

@@ -42,7 +42,7 @@ SOURCE	Name and line number of the source file containing the instrumented code
 TIMER_START	Value in picoseconds when the event timing started or NULL if timing is not collected.
 TIMER_END	Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.
 TIMER_WAIT	Value in picoseconds of the event's duration or NULL if the event has not ended or timing is not collected.
-WORK_COMPLETED	
-WORK_ESTIMATED	
+WORK_COMPLETED	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.
+WORK_ESTIMATED	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.
 NESTING_EVENT_ID	EVENT_ID of event within which this event nests.
-NESTING_EVENT_TYPE	Nesting event type. Either statement, stage or wait.
+NESTING_EVENT_TYPE	Nesting event type. Either transaction, statement, stage or wait.

mysql-test/suite/perfschema/r/dml_events_stages_history_long.result

@@ -42,7 +42,7 @@ SOURCE	Name and line number of the source file containing the instrumented code
 TIMER_START	Value in picoseconds when the event timing started or NULL if timing is not collected.
 TIMER_END	Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.
 TIMER_WAIT	Value in picoseconds of the event's duration or NULL if the event has not ended or timing is not collected.
-WORK_COMPLETED	
-WORK_ESTIMATED	
+WORK_COMPLETED	The number of work units completed for the stage. NULL if the stage event progress is not instrumented.
+WORK_ESTIMATED	The number of work units expected for the stage. NULL if the stage event progress is not instrumented.
 NESTING_EVENT_ID	EVENT_ID of event within which this event nests.
-NESTING_EVENT_TYPE	Nesting event type. Either statement, stage or wait.
+NESTING_EVENT_TYPE	Nesting event type. Either transaction, statement, stage or wait.

mysql-test/suite/perfschema/r/dml_events_statements_current.result

@@ -43,9 +43,9 @@ SQL_TEXT	The SQL statement, or NULL if the command is not associated with an SQL
 DIGEST	Statement digest.
 DIGEST_TEXT	Statement digest text.
 CURRENT_SCHEMA	Statement's default database for the statement, or NULL if there was none.
-OBJECT_TYPE	Reserved, currently NULL
-OBJECT_SCHEMA	Reserved, currently NULL
-OBJECT_NAME	Reserved, currently NULL
+OBJECT_TYPE	NULL for top level statements. The parent statement object type for nested statements (stored programs).
+OBJECT_SCHEMA	NULL for top level statements. The parent statement object schema for nested statements (stored programs).
+OBJECT_NAME	NULL for top level statements. The parent statement object name for nested statements (stored programs).
 OBJECT_INSTANCE_BEGIN	Address in memory of the statement object.
 MYSQL_ERRNO	Error code. See MariaDB Error Codes for a full list.
 RETURNED_SQLSTATE	The SQLSTATE value.
@@ -68,6 +68,6 @@ SORT_ROWS	Number of rows sorted by the statement.
 SORT_SCAN	Number of sorts performed by the statement which used a full table scan.
 NO_INDEX_USED	0 if the statement performed a table scan with an index, 1 if without an index.
 NO_GOOD_INDEX_USED	0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.
-NESTING_EVENT_ID	Reserved, currently NULL.
-NESTING_EVENT_TYPE	Reserved, currently NULL.
-NESTING_EVENT_LEVEL	
+NESTING_EVENT_ID	NULL for top level statements. The parent statement event id for nested statements (stored programs).
+NESTING_EVENT_TYPE	NULL for top level statements. The parent statement event type for nested statements (stored programs).
+NESTING_EVENT_LEVEL	0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).

mysql-test/suite/perfschema/r/dml_events_statements_history.result

@@ -47,9 +47,9 @@ SQL_TEXT	The SQL statement, or NULL if the command is not associated with an SQL
 DIGEST	Statement digest.
 DIGEST_TEXT	Statement digest text.
 CURRENT_SCHEMA	Statement's default database for the statement, or NULL if there was none.
-OBJECT_TYPE	Reserved, currently NULL
-OBJECT_SCHEMA	Reserved, currently NULL
-OBJECT_NAME	Reserved, currently NULL
+OBJECT_TYPE	NULL for top level statements. The parent statement object type for nested statements (stored programs).
+OBJECT_SCHEMA	NULL for top level statements. The parent statement object schema for nested statements (stored programs).
+OBJECT_NAME	NULL for top level statements. The parent statement object name for nested statements (stored programs).
 OBJECT_INSTANCE_BEGIN	Address in memory of the statement object.
 MYSQL_ERRNO	Error code. See MariaDB Error Codes for a full list.
 RETURNED_SQLSTATE	The SQLSTATE value.
@@ -72,6 +72,6 @@ SORT_ROWS	Number of rows sorted by the statement.
 SORT_SCAN	Number of sorts performed by the statement which used a full table scan.
 NO_INDEX_USED	0 if the statement performed a table scan with an index, 1 if without an index.
 NO_GOOD_INDEX_USED	0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.
-NESTING_EVENT_ID	Reserved, currently NULL.
-NESTING_EVENT_TYPE	Reserved, currently NULL.
-NESTING_EVENT_LEVEL	
+NESTING_EVENT_ID	NULL for top level statements. The parent statement event id for nested statements (stored programs).
+NESTING_EVENT_TYPE	NULL for top level statements. The parent statement event type for nested statements (stored programs).
+NESTING_EVENT_LEVEL	0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).

mysql-test/suite/perfschema/r/dml_events_statements_history_long.result

@@ -47,9 +47,9 @@ SQL_TEXT	The SQL statement, or NULL if the command is not associated with an SQL
 DIGEST	Statement digest.
 DIGEST_TEXT	Statement digest text.
 CURRENT_SCHEMA	Statement's default database for the statement, or NULL if there was none.
-OBJECT_TYPE	Reserved, currently NULL
-OBJECT_SCHEMA	Reserved, currently NULL
-OBJECT_NAME	Reserved, currently NULL
+OBJECT_TYPE	NULL for top level statements. The parent statement object type for nested statements (stored programs).
+OBJECT_SCHEMA	NULL for top level statements. The parent statement object schema for nested statements (stored programs).
+OBJECT_NAME	NULL for top level statements. The parent statement object name for nested statements (stored programs).
 OBJECT_INSTANCE_BEGIN	Address in memory of the statement object.
 MYSQL_ERRNO	Error code. See MariaDB Error Codes for a full list.
 RETURNED_SQLSTATE	The SQLSTATE value.
@@ -72,6 +72,6 @@ SORT_ROWS	Number of rows sorted by the statement.
 SORT_SCAN	Number of sorts performed by the statement which used a full table scan.
 NO_INDEX_USED	0 if the statement performed a table scan with an index, 1 if without an index.
 NO_GOOD_INDEX_USED	0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.
-NESTING_EVENT_ID	Reserved, currently NULL.
-NESTING_EVENT_TYPE	Reserved, currently NULL.
-NESTING_EVENT_LEVEL	
+NESTING_EVENT_ID	NULL for top level statements. The parent statement event id for nested statements (stored programs).
+NESTING_EVENT_TYPE	NULL for top level statements. The parent statement event type for nested statements (stored programs).
+NESTING_EVENT_LEVEL	0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).

mysql-test/suite/perfschema/r/dml_file_instances.result

@@ -88,7 +88,7 @@ SELECT FILE_NAME FROM performance_schema.file_instances WHERE FILE_NAME LIKE "%t
 FILE_NAME
 DROP DATABASE db_26152751;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_mems_by_account_by_event_name.result

@@ -25,7 +25,7 @@ LOCK TABLES performance_schema.memory_summary_by_account_by_event_name WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'memory_summary_by_account_by_event_name'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_mems_by_host_by_event_name.result

@@ -25,7 +25,7 @@ LOCK TABLES performance_schema.memory_summary_by_host_by_event_name WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'memory_summary_by_host_by_event_name'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_mems_by_user_by_event_name.result

@@ -25,7 +25,7 @@ LOCK TABLES performance_schema.memory_summary_by_user_by_event_name WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'memory_summary_by_user_by_event_name'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_mems_global_by_event_name.result

@@ -25,7 +25,7 @@ LOCK TABLES performance_schema.memory_summary_global_by_event_name WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'memory_summary_global_by_event_name'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_metadata_locks.result

@@ -20,7 +20,7 @@ LOCK TABLES performance_schema.metadata_locks WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'metadata_locks'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_replication_applier_status_by_worker.result

@@ -24,7 +24,7 @@ LOCK TABLES performance_schema.replication_applier_status_by_worker WRITE;
 ERROR 42000: SELECT, LOCK TABLES command denied to user 'root'@'localhost' for table 'replication_applier_status_by_worker'
 UNLOCK TABLES;
 #
-# MDEV-25325 column_comment for performance_shcema tables
+# MDEV-25325 column_comment for performance_schema tables
 #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/r/dml_setup_actors.result

@@ -112,5 +112,5 @@ column_name	column_comment
 HOST	Host name, either a literal, or the % wildcard representing any host.
 USER	User name, either a literal or the % wildcard representing any name.
 ROLE	Unused
-ENABLED	
-HISTORY	
+ENABLED	Whether to enable instrumentation for foreground threads matched by the row.
+HISTORY	Whether to log historical events for foreground threads matched by the row.

mysql-test/suite/perfschema/r/dml_threads.result

@@ -53,6 +53,6 @@ PROCESSLIST_INFO	Statement being executed by the thread, or NULL if a statement
 PARENT_THREAD_ID	THREAD_ID of the parent thread, if any. Subthreads can for example be spawned as a result of INSERT DELAYED statements.
 ROLE	Unused.
 INSTRUMENTED	YES or NO for Whether the thread is instrumented or not. For foreground threads, the initial value is determined by whether there's a user/host match in the setup_actors table. Subthreads are again matched, while for background threads, this will be set to YES by default. To monitor events that the thread executes, INSTRUMENTED must be YES and the thread_instrumentation consumer in the setup_consumers table must also be YES.
-HISTORY	
-CONNECTION_TYPE	
-THREAD_OS_ID	
+HISTORY	Whether to log historical events for the thread.
+CONNECTION_TYPE	The protocol used to establish the connection, or NULL for background threads.
+THREAD_OS_ID	The thread or task identifier as defined by the underlying operating system, if there is one.

mysql-test/suite/perfschema/t/dml_file_instances.test

@@ -106,7 +106,7 @@ DROP DATABASE db_26152751;
 
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_mems_by_account_by_event_name.test

@@ -41,7 +41,7 @@ LOCK TABLES performance_schema.memory_summary_by_account_by_event_name WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_mems_by_host_by_event_name.test

@@ -41,7 +41,7 @@ LOCK TABLES performance_schema.memory_summary_by_host_by_event_name WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_mems_by_user_by_event_name.test

@@ -41,7 +41,7 @@ LOCK TABLES performance_schema.memory_summary_by_user_by_event_name WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_mems_global_by_event_name.test

@@ -41,7 +41,7 @@ LOCK TABLES performance_schema.memory_summary_global_by_event_name WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_metadata_locks.test

@@ -34,7 +34,7 @@ LOCK TABLES performance_schema.metadata_locks WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

mysql-test/suite/perfschema/t/dml_replication_applier_status_by_worker.test

@@ -43,7 +43,7 @@ LOCK TABLES performance_schema.replication_applier_status_by_worker WRITE;
 UNLOCK TABLES;
 
 --echo #
---echo # MDEV-25325 column_comment for performance_shcema tables
+--echo # MDEV-25325 column_comment for performance_schema tables
 --echo #
 select column_name, column_comment 
 from information_schema.columns 

storage/perfschema/table_esms_by_program.cc

@@ -53,38 +53,38 @@ table_esms_by_program::m_share=
   sizeof(PFS_simple_index),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_statements_summary_by_program ("
-                      "OBJECT_TYPE enum('EVENT', 'FUNCTION', 'PROCEDURE', 'TABLE', 'TRIGGER'),"
-                      "OBJECT_SCHEMA varchar(64) NOT NULL,"
-                      "OBJECT_NAME varchar(64) NOT NULL,"
-                      "COUNT_STAR bigint(20) unsigned NOT NULL,"
-                      "SUM_TIMER_WAIT bigint(20) unsigned NOT NULL,"
-                      "MIN_TIMER_WAIT bigint(20) unsigned NOT NULL,"
-                      "AVG_TIMER_WAIT bigint(20) unsigned NOT NULL,"
-                      "MAX_TIMER_WAIT bigint(20) unsigned NOT NULL,"
-                      "COUNT_STATEMENTS bigint(20) unsigned NOT NULL,"
-                      "SUM_STATEMENTS_WAIT bigint(20) unsigned NOT NULL,"
-                      "MIN_STATEMENTS_WAIT bigint(20) unsigned NOT NULL,"
-                      "AVG_STATEMENTS_WAIT bigint(20) unsigned NOT NULL,"
-                      "MAX_STATEMENTS_WAIT bigint(20) unsigned NOT NULL,"
-                      "SUM_LOCK_TIME bigint(20) unsigned NOT NULL,"
-                      "SUM_ERRORS bigint(20) unsigned NOT NULL,"
-                      "SUM_WARNINGS bigint(20) unsigned NOT NULL,"
-                      "SUM_ROWS_AFFECTED bigint(20) unsigned NOT NULL,"
-                      "SUM_ROWS_SENT bigint(20) unsigned NOT NULL,"
-                      "SUM_ROWS_EXAMINED bigint(20) unsigned NOT NULL,"
-                      "SUM_CREATED_TMP_DISK_TABLES bigint(20) unsigned NOT NULL,"
-                      "SUM_CREATED_TMP_TABLES bigint(20) unsigned NOT NULL,"
-                      "SUM_SELECT_FULL_JOIN bigint(20) unsigned NOT NULL,"
-                      "SUM_SELECT_FULL_RANGE_JOIN bigint(20) unsigned NOT NULL,"
-                      "SUM_SELECT_RANGE bigint(20) unsigned NOT NULL,"
-                      "SUM_SELECT_RANGE_CHECK bigint(20) unsigned NOT NULL,"
-                      "SUM_SELECT_SCAN bigint(20) unsigned NOT NULL,"
-                      "SUM_SORT_MERGE_PASSES bigint(20) unsigned NOT NULL,"
-                      "SUM_SORT_RANGE bigint(20) unsigned NOT NULL,"
-                      "SUM_SORT_ROWS bigint(20) unsigned NOT NULL,"
-                      "SUM_SORT_SCAN bigint(20) unsigned NOT NULL,"
-                      "SUM_NO_INDEX_USED bigint(20) unsigned NOT NULL,"
-                      "SUM_NO_GOOD_INDEX_USED bigint(20) unsigned NOT NULL)")},
+                      "OBJECT_TYPE enum('EVENT', 'FUNCTION', 'PROCEDURE', 'TABLE', 'TRIGGER') comment 'Object type for which the summary is generated.',"
+                      "OBJECT_SCHEMA varchar(64) NOT NULL comment 'The schema of the object for which the summary is generated.',"
+                      "OBJECT_NAME varchar(64) NOT NULL comment 'The name of the object for which the summary is generated.',"
+                      "COUNT_STAR bigint(20) unsigned NOT NULL comment 'The number of summarized events (from events_statements_current). This value includes all events, whether timed or nontimed.',"
+                      "SUM_TIMER_WAIT bigint(20) unsigned NOT NULL comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+                      "MIN_TIMER_WAIT bigint(20) unsigned NOT NULL comment 'The minimum wait time of the summarized timed events.',"
+                      "AVG_TIMER_WAIT bigint(20) unsigned NOT NULL comment 'The average wait time of the summarized timed events.',"
+                      "MAX_TIMER_WAIT bigint(20) unsigned NOT NULL comment 'The maximum wait time of the summarized timed events.',"
+                      "COUNT_STATEMENTS bigint(20) unsigned NOT NULL comment 'Total number of nested statements invoked during stored program execution.',"
+                      "SUM_STATEMENTS_WAIT bigint(20) unsigned NOT NULL comment 'The total wait time of the summarized timed statements. This value is calculated only for timed statements because nontimed statements have a wait time of NULL. The same is true for the other xxx_STATEMENT_WAIT values.',"
+                      "MIN_STATEMENTS_WAIT bigint(20) unsigned NOT NULL comment 'The minimum wait time of the summarized timed statements.',"
+                      "AVG_STATEMENTS_WAIT bigint(20) unsigned NOT NULL comment 'The average wait time of the summarized timed statements.',"
+                      "MAX_STATEMENTS_WAIT bigint(20) unsigned NOT NULL comment 'The maximum wait time of the summarized timed statements.',"
+                      "SUM_LOCK_TIME bigint(20) unsigned NOT NULL comment 'The total time spent (in picoseconds) waiting for table locks for the summarized statements.',"
+                      "SUM_ERRORS bigint(20) unsigned NOT NULL comment 'The total number of errors that occurend for the summarized statements.',"
+                      "SUM_WARNINGS bigint(20) unsigned NOT NULL comment 'The total number of warnings that occurend for the summarized statements.',"
+                      "SUM_ROWS_AFFECTED bigint(20) unsigned NOT NULL comment 'The total number of affected rows by the summarized statements.',"
+                      "SUM_ROWS_SENT bigint(20) unsigned NOT NULL comment 'The total number of rows returned by the summarized statements.',"
+                      "SUM_ROWS_EXAMINED bigint(20) unsigned NOT NULL comment 'The total number of rows examined by the summarized statements.',"
+                      "SUM_CREATED_TMP_DISK_TABLES bigint(20) unsigned NOT NULL comment 'The total number of on-disk temporary tables created by the summarized statements.',"
+                      "SUM_CREATED_TMP_TABLES bigint(20) unsigned NOT NULL comment 'The total number of in-memory temporary tables created by the summarized statements.',"
+                      "SUM_SELECT_FULL_JOIN bigint(20) unsigned NOT NULL comment 'The total number of full joins executed by the summarized statements.',"
+                      "SUM_SELECT_FULL_RANGE_JOIN bigint(20) unsigned NOT NULL comment 'The total number of range search joins executed by the summarized statements.',"
+                      "SUM_SELECT_RANGE bigint(20) unsigned NOT NULL comment 'The total number of joins that used ranges on the first table executed by the summarized statements.',"
+                      "SUM_SELECT_RANGE_CHECK bigint(20) unsigned NOT NULL comment 'The total number of joins that check for key usage after each row executed by the summarized statements.',"
+                      "SUM_SELECT_SCAN bigint(20) unsigned NOT NULL comment 'The total number of joins that did a full scan of the first table executed by the summarized statements.',"
+                      "SUM_SORT_MERGE_PASSES bigint(20) unsigned NOT NULL comment 'The total number of merge passes that the sort algorithm has had to do for the summarized statements.',"
+                      "SUM_SORT_RANGE bigint(20) unsigned NOT NULL comment 'The total number of sorts that were done using ranges for the summarized statements.',"
+                      "SUM_SORT_ROWS bigint(20) unsigned NOT NULL comment 'The total number of sorted rows that were sorted by the summarized statements.',"
+                      "SUM_SORT_SCAN bigint(20) unsigned NOT NULL comment 'The total number of sorts that were done by scanning the table by the summarized statements.',"
+                      "SUM_NO_INDEX_USED bigint(20) unsigned NOT NULL comment 'The total number of statements that performed a table scan without using an index.',"
+                      "SUM_NO_GOOD_INDEX_USED bigint(20) unsigned NOT NULL comment 'The total number of statements where no good index was found.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_ets_by_account_by_event_name.cc

@@ -50,24 +50,24 @@ table_ets_by_account_by_event_name::m_share=
   sizeof(pos_ets_by_account_by_event_name),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_transactions_summary_by_account_by_event_name("
-  "USER CHAR(32) collate utf8_bin default null,"
-  "HOST CHAR(60) collate utf8_bin default null,"
-  "EVENT_NAME VARCHAR(128) not null,"
-  "COUNT_STAR BIGINT unsigned not null,"
-  "SUM_TIMER_WAIT BIGINT unsigned not null,"
-  "MIN_TIMER_WAIT BIGINT unsigned not null,"
-  "AVG_TIMER_WAIT BIGINT unsigned not null,"
-  "MAX_TIMER_WAIT BIGINT unsigned not null,"
-  "COUNT_READ_WRITE BIGINT unsigned not null,"
-  "SUM_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MIN_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "AVG_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MAX_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "COUNT_READ_ONLY BIGINT unsigned not null,"
-  "SUM_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MIN_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "AVG_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MAX_TIMER_READ_ONLY BIGINT unsigned not null)")},
+  "USER CHAR(32) collate utf8_bin default null comment 'User for which summary is generated.',"
+  "HOST CHAR(60) collate utf8_bin default null comment 'Host for which summary is generated.',"
+  "EVENT_NAME VARCHAR(128) not null comment 'Event name for which summary is generated.',"
+  "COUNT_STAR BIGINT unsigned not null comment 'The number of summarized events. This value includes all events, whether timed or nontimed.',"
+  "SUM_TIMER_WAIT BIGINT unsigned not null comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+  "MIN_TIMER_WAIT BIGINT unsigned not null comment 'The minimum wait time of the summarized timed events.',"
+  "AVG_TIMER_WAIT BIGINT unsigned not null comment 'The average wait time of the summarized timed events.',"
+  "MAX_TIMER_WAIT BIGINT unsigned not null comment 'The maximum wait time of the summarized timed events.',"
+  "COUNT_READ_WRITE BIGINT unsigned not null comment 'The total number of only READ/WRITE transaction events.',"
+  "SUM_TIMER_READ_WRITE BIGINT unsigned not null comment 'The total wait time of only READ/WRITE transaction events.',"
+  "MIN_TIMER_READ_WRITE BIGINT unsigned not null comment 'The minimum wait time of only READ/WRITE transaction events.',"
+  "AVG_TIMER_READ_WRITE BIGINT unsigned not null comment 'The average wait time of only READ/WRITE transaction events.',"
+  "MAX_TIMER_READ_WRITE BIGINT unsigned not null comment 'The maximum wait time of only READ/WRITE transaction events.',"
+  "COUNT_READ_ONLY BIGINT unsigned not null comment 'The total number of only READ ONLY transaction events.',"
+  "SUM_TIMER_READ_ONLY BIGINT unsigned not null comment 'The total wait time of only READ ONLY transaction events.',"
+  "MIN_TIMER_READ_ONLY BIGINT unsigned not null comment 'The minimum wait time of only READ ONLY transaction events.',"
+  "AVG_TIMER_READ_ONLY BIGINT unsigned not null comment 'The average wait time of only READ ONLY transaction events.',"
+  "MAX_TIMER_READ_ONLY BIGINT unsigned not null comment 'The maximum wait time of only READ ONLY transaction events.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_ets_by_host_by_event_name.cc

@@ -51,23 +51,23 @@ table_ets_by_host_by_event_name::m_share=
   sizeof(pos_ets_by_host_by_event_name),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_transactions_summary_by_host_by_event_name("
-  "HOST CHAR(60) collate utf8_bin default null,"
-  "EVENT_NAME VARCHAR(128) not null,"
-  "COUNT_STAR BIGINT unsigned not null,"
-  "SUM_TIMER_WAIT BIGINT unsigned not null,"
-  "MIN_TIMER_WAIT BIGINT unsigned not null,"
-  "AVG_TIMER_WAIT BIGINT unsigned not null,"
-  "MAX_TIMER_WAIT BIGINT unsigned not null,"
-  "COUNT_READ_WRITE BIGINT unsigned not null,"
-  "SUM_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MIN_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "AVG_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MAX_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "COUNT_READ_ONLY BIGINT unsigned not null,"
-  "SUM_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MIN_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "AVG_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MAX_TIMER_READ_ONLY BIGINT unsigned not null)")},
+  "HOST CHAR(60) collate utf8_bin default null comment 'Host for which summary is generated.',"
+  "EVENT_NAME VARCHAR(128) not null comment 'Event name for which summary is generated.',"
+  "COUNT_STAR BIGINT unsigned not null comment 'The number of summarized events. This value includes all events, whether timed or nontimed.',"
+  "SUM_TIMER_WAIT BIGINT unsigned not null comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+  "MIN_TIMER_WAIT BIGINT unsigned not null comment 'The minimum wait time of the summarized timed events.',"
+  "AVG_TIMER_WAIT BIGINT unsigned not null comment 'The average wait time of the summarized timed events.',"
+  "MAX_TIMER_WAIT BIGINT unsigned not null comment 'The maximum wait time of the summarized timed events.',"
+  "COUNT_READ_WRITE BIGINT unsigned not null comment 'The total number of only READ/WRITE transaction events.',"
+  "SUM_TIMER_READ_WRITE BIGINT unsigned not null comment 'The total wait time of only READ/WRITE transaction events.',"
+  "MIN_TIMER_READ_WRITE BIGINT unsigned not null comment 'The minimum wait time of only READ/WRITE transaction events.',"
+  "AVG_TIMER_READ_WRITE BIGINT unsigned not null comment 'The average wait time of only READ/WRITE transaction events.',"
+  "MAX_TIMER_READ_WRITE BIGINT unsigned not null comment 'The maximum wait time of only READ/WRITE transaction events.',"
+  "COUNT_READ_ONLY BIGINT unsigned not null comment 'The total number of only READ ONLY transaction events.',"
+  "SUM_TIMER_READ_ONLY BIGINT unsigned not null comment 'The total wait time of only READ ONLY transaction events.',"
+  "MIN_TIMER_READ_ONLY BIGINT unsigned not null comment 'The minimum wait time of only READ ONLY transaction events.',"
+  "AVG_TIMER_READ_ONLY BIGINT unsigned not null comment 'The average wait time of only READ ONLY transaction events.',"
+  "MAX_TIMER_READ_ONLY BIGINT unsigned not null comment 'The maximum wait time of only READ ONLY transaction events.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_ets_by_thread_by_event_name.cc

@@ -50,23 +50,23 @@ table_ets_by_thread_by_event_name::m_share=
   sizeof(pos_ets_by_thread_by_event_name),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_transactions_summary_by_thread_by_event_name("
-  "THREAD_ID BIGINT unsigned not null,"
-  "EVENT_NAME VARCHAR(128) not null,"
-  "COUNT_STAR BIGINT unsigned not null,"
-  "SUM_TIMER_WAIT BIGINT unsigned not null,"
-  "MIN_TIMER_WAIT BIGINT unsigned not null,"
-  "AVG_TIMER_WAIT BIGINT unsigned not null,"
-  "MAX_TIMER_WAIT BIGINT unsigned not null,"
-  "COUNT_READ_WRITE BIGINT unsigned not null,"
-  "SUM_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MIN_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "AVG_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MAX_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "COUNT_READ_ONLY BIGINT unsigned not null,"
-  "SUM_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MIN_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "AVG_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MAX_TIMER_READ_ONLY BIGINT unsigned not null)")},
+  "THREAD_ID BIGINT unsigned not null comment 'Thread for which summary is generated.',"
+  "EVENT_NAME VARCHAR(128) not null comment 'Event name for which summary is generated.',"
+  "COUNT_STAR BIGINT unsigned not null comment 'The number of summarized events. This value includes all events, whether timed or nontimed.',"
+  "SUM_TIMER_WAIT BIGINT unsigned not null comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+  "MIN_TIMER_WAIT BIGINT unsigned not null comment 'The minimum wait time of the summarized timed events.',"
+  "AVG_TIMER_WAIT BIGINT unsigned not null comment 'The average wait time of the summarized timed events.',"
+  "MAX_TIMER_WAIT BIGINT unsigned not null comment 'The maximum wait time of the summarized timed events.',"
+  "COUNT_READ_WRITE BIGINT unsigned not null comment 'The total number of only READ/WRITE transaction events.',"
+  "SUM_TIMER_READ_WRITE BIGINT unsigned not null comment 'The total wait time of only READ/WRITE transaction events.',"
+  "MIN_TIMER_READ_WRITE BIGINT unsigned not null comment 'The minimum wait time of only READ/WRITE transaction events.',"
+  "AVG_TIMER_READ_WRITE BIGINT unsigned not null comment 'The average wait time of only READ/WRITE transaction events.',"
+  "MAX_TIMER_READ_WRITE BIGINT unsigned not null comment 'The maximum wait time of only READ/WRITE transaction events.',"
+  "COUNT_READ_ONLY BIGINT unsigned not null comment 'The total number of only READ ONLY transaction events.',"
+  "SUM_TIMER_READ_ONLY BIGINT unsigned not null comment 'The total wait time of only READ ONLY transaction events.',"
+  "MIN_TIMER_READ_ONLY BIGINT unsigned not null comment 'The minimum wait time of only READ ONLY transaction events.',"
+  "AVG_TIMER_READ_ONLY BIGINT unsigned not null comment 'The average wait time of only READ ONLY transaction events.',"
+  "MAX_TIMER_READ_ONLY BIGINT unsigned not null comment 'The maximum wait time of only READ ONLY transaction events.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_ets_by_user_by_event_name.cc

@@ -50,23 +50,23 @@ table_ets_by_user_by_event_name::m_share=
   sizeof(pos_ets_by_user_by_event_name),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_transactions_summary_by_user_by_event_name("
-  "USER CHAR(32) collate utf8_bin default null,"
-  "EVENT_NAME VARCHAR(128) not null,"
-  "COUNT_STAR BIGINT unsigned not null,"
-  "SUM_TIMER_WAIT BIGINT unsigned not null,"
-  "MIN_TIMER_WAIT BIGINT unsigned not null,"
-  "AVG_TIMER_WAIT BIGINT unsigned not null,"
-  "MAX_TIMER_WAIT BIGINT unsigned not null,"
-  "COUNT_READ_WRITE BIGINT unsigned not null,"
-  "SUM_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MIN_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "AVG_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MAX_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "COUNT_READ_ONLY BIGINT unsigned not null,"
-  "SUM_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MIN_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "AVG_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MAX_TIMER_READ_ONLY BIGINT unsigned not null)")},
+  "USER CHAR(32) collate utf8_bin default null comment 'User for which summary is generated.',"
+  "EVENT_NAME VARCHAR(128) not null comment 'Event name for which summary is generated.',"
+  "COUNT_STAR BIGINT unsigned not null comment 'The number of summarized events. This value includes all events, whether timed or nontimed.',"
+  "SUM_TIMER_WAIT BIGINT unsigned not null comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+  "MIN_TIMER_WAIT BIGINT unsigned not null comment 'The minimum wait time of the summarized timed events.',"
+  "AVG_TIMER_WAIT BIGINT unsigned not null comment 'The average wait time of the summarized timed events.',"
+  "MAX_TIMER_WAIT BIGINT unsigned not null comment 'The maximum wait time of the summarized timed events.',"
+  "COUNT_READ_WRITE BIGINT unsigned not null comment 'The total number of only READ/WRITE transaction events.',"
+  "SUM_TIMER_READ_WRITE BIGINT unsigned not null comment 'The total wait time of only READ/WRITE transaction events.',"
+  "MIN_TIMER_READ_WRITE BIGINT unsigned not null comment 'The minimum wait time of only READ/WRITE transaction events.',"
+  "AVG_TIMER_READ_WRITE BIGINT unsigned not null comment 'The average wait time of only READ/WRITE transaction events.',"
+  "MAX_TIMER_READ_WRITE BIGINT unsigned not null comment 'The maximum wait time of only READ/WRITE transaction events.',"
+  "COUNT_READ_ONLY BIGINT unsigned not null comment 'The total number of only READ ONLY transaction events.',"
+  "SUM_TIMER_READ_ONLY BIGINT unsigned not null comment 'The total wait time of only READ ONLY transaction events.',"
+  "MIN_TIMER_READ_ONLY BIGINT unsigned not null comment 'The minimum wait time of only READ ONLY transaction events.',"
+  "AVG_TIMER_READ_ONLY BIGINT unsigned not null comment 'The average wait time of only READ ONLY transaction events.',"
+  "MAX_TIMER_READ_ONLY BIGINT unsigned not null comment 'The maximum wait time of only READ ONLY transaction events.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_ets_global_by_event_name.cc

@@ -51,22 +51,22 @@ table_ets_global_by_event_name::m_share=
   sizeof(PFS_simple_index),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE events_transactions_summary_global_by_event_name("
-  "EVENT_NAME VARCHAR(128) not null,"
-  "COUNT_STAR BIGINT unsigned not null,"
-  "SUM_TIMER_WAIT BIGINT unsigned not null,"
-  "MIN_TIMER_WAIT BIGINT unsigned not null,"
-  "AVG_TIMER_WAIT BIGINT unsigned not null,"
-  "MAX_TIMER_WAIT BIGINT unsigned not null,"
-  "COUNT_READ_WRITE BIGINT unsigned not null,"
-  "SUM_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MIN_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "AVG_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "MAX_TIMER_READ_WRITE BIGINT unsigned not null,"
-  "COUNT_READ_ONLY BIGINT unsigned not null,"
-  "SUM_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MIN_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "AVG_TIMER_READ_ONLY BIGINT unsigned not null,"
-  "MAX_TIMER_READ_ONLY BIGINT unsigned not null)")},
+  "EVENT_NAME VARCHAR(128) not null comment 'Event name for which summary is generated.',"
+  "COUNT_STAR BIGINT unsigned not null comment 'The number of summarized events. This value includes all events, whether timed or nontimed.',"
+  "SUM_TIMER_WAIT BIGINT unsigned not null comment 'The total wait time of the summarized timed events. This value is calculated only for timed events because nontimed events have a wait time of NULL. The same is true for the other xxx_TIMER_WAIT values.',"
+  "MIN_TIMER_WAIT BIGINT unsigned not null comment 'The minimum wait time of the summarized timed events.',"
+  "AVG_TIMER_WAIT BIGINT unsigned not null comment 'The average wait time of the summarized timed events.',"
+  "MAX_TIMER_WAIT BIGINT unsigned not null comment 'The maximum wait time of the summarized timed events.',"
+  "COUNT_READ_WRITE BIGINT unsigned not null comment 'The total number of only READ/WRITE transaction events.',"
+  "SUM_TIMER_READ_WRITE BIGINT unsigned not null comment 'The total wait time of only READ/WRITE transaction events.',"
+  "MIN_TIMER_READ_WRITE BIGINT unsigned not null comment 'The minimum wait time of only READ/WRITE transaction events.',"
+  "AVG_TIMER_READ_WRITE BIGINT unsigned not null comment 'The average wait time of only READ/WRITE transaction events.',"
+  "MAX_TIMER_READ_WRITE BIGINT unsigned not null comment 'The maximum wait time of only READ/WRITE transaction events.',"
+  "COUNT_READ_ONLY BIGINT unsigned not null comment 'The total number of only READ ONLY transaction events.',"
+  "SUM_TIMER_READ_ONLY BIGINT unsigned not null comment 'The total wait time of only READ ONLY transaction events.',"
+  "MIN_TIMER_READ_ONLY BIGINT unsigned not null comment 'The minimum wait time of only READ ONLY transaction events.',"
+  "AVG_TIMER_READ_ONLY BIGINT unsigned not null comment 'The average wait time of only READ ONLY transaction events.',"
+  "MAX_TIMER_READ_ONLY BIGINT unsigned not null comment 'The maximum wait time of only READ ONLY transaction events.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_events_stages.cc

@@ -57,10 +57,10 @@ table_events_stages_current::m_share=
                       "TIMER_START BIGINT unsigned comment 'Value in picoseconds when the event timing started or NULL if timing is not collected.',"
                       "TIMER_END BIGINT unsigned comment 'Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.',"
                       "TIMER_WAIT BIGINT unsigned comment 'Value in picoseconds of the event''s duration or NULL if the event has not ended or timing is not collected.',"
-                      "WORK_COMPLETED BIGINT unsigned,"
-                      "WORK_ESTIMATED BIGINT unsigned,"
+                      "WORK_COMPLETED BIGINT unsigned comment 'The number of work units completed for the stage. NULL if the stage event progress is not instrumented.',"
+                      "WORK_ESTIMATED BIGINT unsigned comment 'The number of work units expected for the stage. NULL if the stage event progress is not instrumented.',"
                       "NESTING_EVENT_ID BIGINT unsigned comment 'EVENT_ID of event within which this event nests.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either statement, stage or wait.')") },
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either transaction, statement, stage or wait.')") },
   false  /* perpetual */
 };
 
@@ -86,10 +86,10 @@ table_events_stages_history::m_share=
                       "TIMER_START BIGINT unsigned comment 'Value in picoseconds when the event timing started or NULL if timing is not collected.',"
                       "TIMER_END BIGINT unsigned comment 'Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.',"
                       "TIMER_WAIT BIGINT unsigned comment 'Value in picoseconds of the event''s duration or NULL if the event has not ended or timing is not collected.',"
-                      "WORK_COMPLETED BIGINT unsigned,"
-                      "WORK_ESTIMATED BIGINT unsigned,"
+                      "WORK_COMPLETED BIGINT unsigned comment 'The number of work units completed for the stage. NULL if the stage event progress is not instrumented.',"
+                      "WORK_ESTIMATED BIGINT unsigned comment 'The number of work units expected for the stage. NULL if the stage event progress is not instrumented.',"
                       "NESTING_EVENT_ID BIGINT unsigned comment 'EVENT_ID of event within which this event nests.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either statement, stage or wait.')") },
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either transaction, statement, stage or wait.')") },
   false  /* perpetual */
 };
 
@@ -115,10 +115,10 @@ table_events_stages_history_long::m_share=
                       "TIMER_START BIGINT unsigned comment 'Value in picoseconds when the event timing started or NULL if timing is not collected.',"
                       "TIMER_END BIGINT unsigned comment 'Value in picoseconds when the event timing ended, or NULL if the event has not ended or timing is not collected.',"
                       "TIMER_WAIT BIGINT unsigned comment 'Value in picoseconds of the event''s duration or NULL if the event has not ended or timing is not collected.',"
-                      "WORK_COMPLETED BIGINT unsigned,"
-                      "WORK_ESTIMATED BIGINT unsigned,"
+                      "WORK_COMPLETED BIGINT unsigned comment 'The number of work units completed for the stage. NULL if the stage event progress is not instrumented.',"
+                      "WORK_ESTIMATED BIGINT unsigned comment 'The number of work units expected for the stage. NULL if the stage event progress is not instrumented.',"
                       "NESTING_EVENT_ID BIGINT unsigned comment 'EVENT_ID of event within which this event nests.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either statement, stage or wait.')") },
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Nesting event type. Either transaction, statement, stage or wait.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_events_statements.cc

@@ -64,9 +64,9 @@ table_events_statements_current::m_share=
                       "DIGEST VARCHAR(32) comment 'Statement digest.',"
                       "DIGEST_TEXT LONGTEXT comment 'Statement digest text.',"
                       "CURRENT_SCHEMA VARCHAR(64) comment 'Statement''s default database for the statement, or NULL if there was none.',"
-                      "OBJECT_TYPE VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_SCHEMA VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_NAME VARCHAR(64) comment 'Reserved, currently NULL',"
+                      "OBJECT_TYPE VARCHAR(64) comment 'NULL for top level statements. The parent statement object type for nested statements (stored programs).',"
+                      "OBJECT_SCHEMA VARCHAR(64) comment 'NULL for top level statements. The parent statement object schema for nested statements (stored programs).',"
+                      "OBJECT_NAME VARCHAR(64) comment 'NULL for top level statements. The parent statement object name for nested statements (stored programs).',"
                       "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Address in memory of the statement object.',"
                       "MYSQL_ERRNO INTEGER comment 'Error code. See MariaDB Error Codes for a full list.',"
                       "RETURNED_SQLSTATE VARCHAR(5) comment 'The SQLSTATE value.',"
@@ -89,9 +89,9 @@ table_events_statements_current::m_share=
                       "SORT_SCAN BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a full table scan.',"
                       "NO_INDEX_USED BIGINT unsigned not null comment '0 if the statement performed a table scan with an index, 1 if without an index.',"
                       "NO_GOOD_INDEX_USED BIGINT unsigned not null comment '0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.',"
-                      "NESTING_EVENT_ID BIGINT unsigned comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_LEVEL INT)") },
+                      "NESTING_EVENT_ID BIGINT unsigned comment 'NULL for top level statements. The parent statement event id for nested statements (stored programs).',"
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'NULL for top level statements. The parent statement event type for nested statements (stored programs).',"
+                      "NESTING_EVENT_LEVEL INT comment '0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).')") },
   false  /* perpetual */
 };
 
@@ -122,9 +122,9 @@ table_events_statements_history::m_share=
                       "DIGEST VARCHAR(32) comment 'Statement digest.',"
                       "DIGEST_TEXT LONGTEXT comment 'Statement digest text.',"
                       "CURRENT_SCHEMA VARCHAR(64) comment 'Statement''s default database for the statement, or NULL if there was none.',"
-                      "OBJECT_TYPE VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_SCHEMA VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_NAME VARCHAR(64) comment 'Reserved, currently NULL',"
+                      "OBJECT_TYPE VARCHAR(64) comment 'NULL for top level statements. The parent statement object type for nested statements (stored programs).',"
+                      "OBJECT_SCHEMA VARCHAR(64) comment 'NULL for top level statements. The parent statement object schema for nested statements (stored programs).',"
+                      "OBJECT_NAME VARCHAR(64) comment 'NULL for top level statements. The parent statement object name for nested statements (stored programs).',"
                       "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Address in memory of the statement object.',"
                       "MYSQL_ERRNO INTEGER comment 'Error code. See MariaDB Error Codes for a full list.',"
                       "RETURNED_SQLSTATE VARCHAR(5) comment 'The SQLSTATE value.',"
@@ -147,9 +147,9 @@ table_events_statements_history::m_share=
                       "SORT_SCAN BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a full table scan.',"
                       "NO_INDEX_USED BIGINT unsigned not null comment '0 if the statement performed a table scan with an index, 1 if without an index.',"
                       "NO_GOOD_INDEX_USED BIGINT unsigned not null comment '0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.',"
-                      "NESTING_EVENT_ID BIGINT unsigned comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_LEVEL INT)") },
+                      "NESTING_EVENT_ID BIGINT unsigned comment 'NULL for top level statements. The parent statement event id for nested statements (stored programs).',"
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'NULL for top level statements. The parent statement event type for nested statements (stored programs).',"
+                      "NESTING_EVENT_LEVEL INT comment '0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).')") },
   false  /* perpetual */
 };
 
@@ -180,9 +180,9 @@ table_events_statements_history_long::m_share=
                       "DIGEST VARCHAR(32) comment 'Statement digest.',"
                       "DIGEST_TEXT LONGTEXT comment 'Statement digest text.',"
                       "CURRENT_SCHEMA VARCHAR(64) comment 'Statement''s default database for the statement, or NULL if there was none.',"
-                      "OBJECT_TYPE VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_SCHEMA VARCHAR(64) comment 'Reserved, currently NULL',"
-                      "OBJECT_NAME VARCHAR(64) comment 'Reserved, currently NULL',"
+                      "OBJECT_TYPE VARCHAR(64) comment 'NULL for top level statements. The parent statement object type for nested statements (stored programs).',"
+                      "OBJECT_SCHEMA VARCHAR(64) comment 'NULL for top level statements. The parent statement object schema for nested statements (stored programs).',"
+                      "OBJECT_NAME VARCHAR(64) comment 'NULL for top level statements. The parent statement object name for nested statements (stored programs).',"
                       "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Address in memory of the statement object.',"
                       "MYSQL_ERRNO INTEGER comment 'Error code. See MariaDB Error Codes for a full list.',"
                       "RETURNED_SQLSTATE VARCHAR(5) comment 'The SQLSTATE value.',"
@@ -205,9 +205,9 @@ table_events_statements_history_long::m_share=
                       "SORT_SCAN BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a full table scan.',"
                       "NO_INDEX_USED BIGINT unsigned not null comment '0 if the statement performed a table scan with an index, 1 if without an index.',"
                       "NO_GOOD_INDEX_USED BIGINT unsigned not null comment '0 if a good index was found for the statement, 1 if no good index was found. See the Range checked for each record description in the EXPLAIN article.',"
-                      "NESTING_EVENT_ID BIGINT unsigned comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'Reserved, currently NULL.',"
-                      "NESTING_EVENT_LEVEL INT)") },
+                      "NESTING_EVENT_ID BIGINT unsigned comment 'NULL for top level statements. The parent statement event id for nested statements (stored programs).',"
+                      "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'NULL for top level statements. The parent statement event type for nested statements (stored programs).',"
+                      "NESTING_EVENT_LEVEL INT comment '0 for top level statements. The parent statement level plus 1 for nested statements (stored programs).')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_global_status.cc

@@ -47,8 +47,8 @@ table_global_status::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE global_status("
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "VARIABLE_NAME VARCHAR(64) not null comment 'The global status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'The global status variable value.')") },
   true   /* perpetual */
 };
 

storage/perfschema/table_prepared_stmt_instances.cc

@@ -53,41 +53,41 @@ table_prepared_stmt_instances::m_share=
   sizeof(PFS_simple_index),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE prepared_statements_instances("
-  "OBJECT_INSTANCE_BEGIN bigint(20) unsigned NOT NULL,"
-  "STATEMENT_ID bigint(20) unsigned NOT NULL,"
-  "STATEMENT_NAME varchar(64) default NULL,"
-  "SQL_TEXT longtext NOT NULL,"
-  "OWNER_THREAD_ID bigint(20) unsigned NOT NULL,"
-  "OWNER_EVENT_ID bigint(20) unsigned NOT NULL,"
-  "OWNER_OBJECT_TYPE enum('EVENT','FUNCTION','PROCEDURE','TABLE','TRIGGER') DEFAULT NULL,"
-  "OWNER_OBJECT_SCHEMA varchar(64) DEFAULT NULL,"
-  "OWNER_OBJECT_NAME varchar(64) DEFAULT NULL,"
-  "TIMER_PREPARE bigint(20) unsigned NOT NULL,"
-  "COUNT_REPREPARE bigint(20) unsigned NOT NULL,"
-  "COUNT_EXECUTE bigint(20) unsigned NOT NULL,"
-  "SUM_TIMER_EXECUTE bigint(20) unsigned NOT NULL,"
-  "MIN_TIMER_EXECUTE bigint(20) unsigned NOT NULL,"
-  "AVG_TIMER_EXECUTE bigint(20) unsigned NOT NULL,"
-  "MAX_TIMER_EXECUTE bigint(20) unsigned NOT NULL,"
-  "SUM_LOCK_TIME bigint(20) unsigned NOT NULL,"
-  "SUM_ERRORS bigint(20) unsigned NOT NULL,"
-  "SUM_WARNINGS bigint(20) unsigned NOT NULL,"
-  "SUM_ROWS_AFFECTED bigint(20) unsigned NOT NULL,"
-  "SUM_ROWS_SENT bigint(20) unsigned NOT NULL,"
-  "SUM_ROWS_EXAMINED bigint(20) unsigned NOT NULL,"
-  "SUM_CREATED_TMP_DISK_TABLES bigint(20) unsigned NOT NULL,"
-  "SUM_CREATED_TMP_TABLES bigint(20) unsigned NOT NULL,"
-  "SUM_SELECT_FULL_JOIN bigint(20) unsigned NOT NULL,"
-  "SUM_SELECT_FULL_RANGE_JOIN bigint(20) unsigned NOT NULL,"
-  "SUM_SELECT_RANGE bigint(20) unsigned NOT NULL,"
-  "SUM_SELECT_RANGE_CHECK bigint(20) unsigned NOT NULL,"
-  "SUM_SELECT_SCAN bigint(20) unsigned NOT NULL,"
-  "SUM_SORT_MERGE_PASSES bigint(20) unsigned NOT NULL,"
-  "SUM_SORT_RANGE bigint(20) unsigned NOT NULL,"
-  "SUM_SORT_ROWS bigint(20) unsigned NOT NULL,"
-  "SUM_SORT_SCAN bigint(20) unsigned NOT NULL,"
-  "SUM_NO_INDEX_USED bigint(20) unsigned NOT NULL,"
-  "SUM_NO_GOOD_INDEX_USED bigint(20) unsigned NOT NULL)")},
+  "OBJECT_INSTANCE_BEGIN bigint(20) unsigned NOT NULL comment 'The address in memory of the instrumented prepared statement.',"
+  "STATEMENT_ID bigint(20) unsigned NOT NULL comment 'The internal statement ID assigned by the server.',"
+  "STATEMENT_NAME varchar(64) default NULL comment 'For the binary protocol, this column is NULL. For the text protocol, this column is the external statement name assigned by the user.',"
+  "SQL_TEXT longtext NOT NULL comment 'The prepared statement text, with ? placeholder markers.',"
+  "OWNER_THREAD_ID bigint(20) unsigned NOT NULL comment 'Event thread id that created the prepared statement.',"
+  "OWNER_EVENT_ID bigint(20) unsigned NOT NULL comment 'Event id that created the prepared statement.',"
+  "OWNER_OBJECT_TYPE enum('EVENT','FUNCTION','PROCEDURE','TABLE','TRIGGER') DEFAULT NULL comment 'NULL for a prepared statement created by a client session. Type of the stored program that created the prepared statement.',"
+  "OWNER_OBJECT_SCHEMA varchar(64) DEFAULT NULL comment 'NULL for a prepared statement created by a client session. Schema of the stored program that created the prepared statement.',"
+  "OWNER_OBJECT_NAME varchar(64) DEFAULT NULL comment 'NULL for a prepared statement created by a client session. Name of the stored program that created the prepared statement.',"
+  "TIMER_PREPARE bigint(20) unsigned NOT NULL comment 'The time spent executing the statement preparation itself.',"
+  "COUNT_REPREPARE bigint(20) unsigned NOT NULL comment 'The number of times the statement was reprepared internally.',"
+  "COUNT_EXECUTE bigint(20) unsigned NOT NULL comment 'Total times the prepared statement was executed.',"
+  "SUM_TIMER_EXECUTE bigint(20) unsigned NOT NULL comment 'Total time spent executing all prepared statements.',"
+  "MIN_TIMER_EXECUTE bigint(20) unsigned NOT NULL comment 'Minimum time spent executing any of the prepared statements.',"
+  "AVG_TIMER_EXECUTE bigint(20) unsigned NOT NULL comment 'Average time spent executing any of the prepared statements.',"
+  "MAX_TIMER_EXECUTE bigint(20) unsigned NOT NULL comment 'Maximum time spent executing any of the prepared statements.',"
+  "SUM_LOCK_TIME bigint(20) unsigned NOT NULL comment 'The total time spent (in picoseconds) waiting for table locks for the prepared statements.',"
+  "SUM_ERRORS bigint(20) unsigned NOT NULL comment 'The total number of errors that occurend for the prepared statements.',"
+  "SUM_WARNINGS bigint(20) unsigned NOT NULL comment 'The total number of warnings that occurend for the prepared statements.',"
+  "SUM_ROWS_AFFECTED bigint(20) unsigned NOT NULL comment 'The total number of affected rows by the prepared statements.',"
+  "SUM_ROWS_SENT bigint(20) unsigned NOT NULL comment 'The total number of rows returned by the prepared statements.',"
+  "SUM_ROWS_EXAMINED bigint(20) unsigned NOT NULL comment 'The total number of rows examined by the prepared statements.',"
+  "SUM_CREATED_TMP_DISK_TABLES bigint(20) unsigned NOT NULL comment 'The total number of on-disk temporary tables created by the prepared statements.',"
+  "SUM_CREATED_TMP_TABLES bigint(20) unsigned NOT NULL comment 'The total number of in-memory temporary tables created by the prepared statements.',"
+  "SUM_SELECT_FULL_JOIN bigint(20) unsigned NOT NULL comment 'The total number of full joins executed by the prepared statements.',"
+  "SUM_SELECT_FULL_RANGE_JOIN bigint(20) unsigned NOT NULL comment 'The total number of range search joins executed by the prepared statements.',"
+  "SUM_SELECT_RANGE bigint(20) unsigned NOT NULL comment 'The total number of joins that used ranges on the first table executed by the prepared statements.',"
+  "SUM_SELECT_RANGE_CHECK bigint(20) unsigned NOT NULL comment 'The total number of joins that check for key usage after each row executed by the prepared statements.',"
+  "SUM_SELECT_SCAN bigint(20) unsigned NOT NULL comment 'The total number of joins that did a full scan of the first table executed by the prepared statements.',"
+  "SUM_SORT_MERGE_PASSES bigint(20) unsigned NOT NULL comment 'The total number of merge passes that the sort algorithm has had to do for the prepared statements.',"
+  "SUM_SORT_RANGE bigint(20) unsigned NOT NULL comment 'The total number of sorts that were done using ranges for the prepared statements.',"
+  "SUM_SORT_ROWS bigint(20) unsigned NOT NULL comment 'The total number of sorted rows that were sorted by the prepared statements.',"
+  "SUM_SORT_SCAN bigint(20) unsigned NOT NULL comment 'The total number of sorts that were done by scanning the table by the prepared statements.',"
+  "SUM_NO_INDEX_USED bigint(20) unsigned NOT NULL comment 'The total number of statements that performed a table scan without using an index.',"
+  "SUM_NO_GOOD_INDEX_USED bigint(20) unsigned NOT NULL comment 'The total number of statements where no good index was found.')")},
   false  /* perpetual */
 };
 

storage/perfschema/table_replication_applier_configuration.cc

@@ -54,8 +54,8 @@ table_replication_applier_configuration::m_share=
   sizeof(pos_t), /* ref length */
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE replication_applier_configuration("
-  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null,"
-  "DESIRED_DELAY INTEGER not null)") },
+  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null comment 'Replication channel name.',"
+  "DESIRED_DELAY INTEGER not null comment 'Desired replica delay functionality not supported by MariaDB. Always 0.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_replication_applier_status.cc

@@ -55,10 +55,10 @@ table_replication_applier_status::m_share=
   sizeof(pos_t), /* ref length */
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE replication_applier_status("
-  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null,"
-  "SERVICE_STATE ENUM('ON','OFF') not null,"
-  "REMAINING_DELAY INTEGER unsigned,"
-  "COUNT_TRANSACTIONS_RETRIES BIGINT unsigned not null)") },
+  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null comment 'The replication channel name.',"
+  "SERVICE_STATE ENUM('ON','OFF') not null comment 'Shows ON when the replication channel''s applier threads are active or idle, OFF means that the applier threads are not active.',"
+  "REMAINING_DELAY INTEGER unsigned comment 'Desired replica delay functionality not supported by MariaDB. Always 0.',"
+  "COUNT_TRANSACTIONS_RETRIES BIGINT unsigned not null comment 'The number of retries that were made because the replication SQL thread failed to apply a transaction.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_replication_applier_status_by_coordinator.cc

@@ -55,12 +55,12 @@ table_replication_applier_status_by_coordinator::m_share=
   sizeof(pos_t), /* ref length */
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE replication_applier_status_by_coordinator("
-  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null,"
-  "THREAD_ID BIGINT UNSIGNED,"
-  "SERVICE_STATE ENUM('ON','OFF') not null,"
-  "LAST_ERROR_NUMBER INTEGER not null,"
-  "LAST_ERROR_MESSAGE VARCHAR(1024) not null,"
-  "LAST_ERROR_TIMESTAMP TIMESTAMP(0) not null)") },
+  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null comment 'Replication channel name.',"
+  "THREAD_ID BIGINT UNSIGNED comment 'The SQL/coordinator thread ID.',"
+  "SERVICE_STATE ENUM('ON','OFF') not null comment 'ON (thread exists and is active or idle) or OFF (thread no longer exists).',"
+  "LAST_ERROR_NUMBER INTEGER not null comment 'Last error number that caused the SQL/coordinator thread to stop.',"
+  "LAST_ERROR_MESSAGE VARCHAR(1024) not null comment 'Last error message that caused the SQL/coordinator thread to stop.',"
+  "LAST_ERROR_TIMESTAMP TIMESTAMP(0) not null comment 'Timestamp that shows when the most recent SQL/coordinator error occured.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_replication_connection_configuration.cc

@@ -54,25 +54,25 @@ table_replication_connection_configuration::m_share=
   sizeof(pos_t), /* ref length */
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE replication_connection_configuration("
-  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null,"
-  "HOST CHAR(60) collate utf8_bin not null,"
-  "PORT INTEGER not null,"
-  "USER CHAR(32) collate utf8_bin not null,"
-  "NETWORK_INTERFACE CHAR(60) collate utf8_bin not null,"
-  "AUTO_POSITION ENUM('1','0') not null,"
-  "SSL_ALLOWED ENUM('YES','NO','IGNORED') not null,"
-  "SSL_CA_FILE VARCHAR(512) not null,"
-  "SSL_CA_PATH VARCHAR(512) not null,"
-  "SSL_CERTIFICATE VARCHAR(512) not null,"
-  "SSL_CIPHER VARCHAR(512) not null,"
-  "SSL_KEY VARCHAR(512) not null,"
-  "SSL_VERIFY_SERVER_CERTIFICATE ENUM('YES','NO') not null,"
-  "SSL_CRL_FILE VARCHAR(255) not null,"
-  "SSL_CRL_PATH VARCHAR(255) not null,"
-  "CONNECTION_RETRY_INTERVAL INTEGER not null,"
-  "CONNECTION_RETRY_COUNT BIGINT unsigned not null,"
-  "HEARTBEAT_INTERVAL DOUBLE(10,3) unsigned not null COMMENT 'Number of seconds after which a heartbeat will be sent .',"
-  "TLS_VERSION VARCHAR(255) not null)") },
+  "CHANNEL_NAME CHAR(64) collate utf8_general_ci not null comment 'The replication channel used.',"
+  "HOST CHAR(60) collate utf8_bin not null comment 'The host name of the source that the replica is connected to.',"
+  "PORT INTEGER not null comment 'The port used to connect to the source.',"
+  "USER CHAR(32) collate utf8_bin not null comment 'The user name of the replication user account used to connect to the source.',"
+  "NETWORK_INTERFACE CHAR(60) collate utf8_bin not null comment 'The network interface that the replica is bound to, if any.',"
+  "AUTO_POSITION ENUM('1','0') not null comment '1 if GTID auto-positioning is in use; otherwise 0.',"
+  "SSL_ALLOWED ENUM('YES','NO','IGNORED') not null comment 'Wether SSL is allowed for the replica connection.',"
+  "SSL_CA_FILE VARCHAR(512) not null comment 'Path to the file that contains one or more certificates for trusted Certificate Authorities (CA) to use for TLS.',"
+  "SSL_CA_PATH VARCHAR(512) not null comment 'Path to a directory that contains one or more PEM files that contain X509 certificates for a trusted Certificate Authority (CA) to use for TLS.',"
+  "SSL_CERTIFICATE VARCHAR(512) not null comment 'Path to the certificate used to authenticate the master.',"
+  "SSL_CIPHER VARCHAR(512) not null comment 'Which cipher is used for encription.',"
+  "SSL_KEY VARCHAR(512) not null comment 'Path to the private key used for TLS.',"
+  "SSL_VERIFY_SERVER_CERTIFICATE ENUM('YES','NO') not null comment 'Wether the server certificate is verified as part of the SSL connection',"
+  "SSL_CRL_FILE VARCHAR(255) not null comment 'Path to the PEM file containing one or more revoked X.509 certificates.',"
+  "SSL_CRL_PATH VARCHAR(255) not null comment 'PATH to a folder containing PEM files containing one or more revoked X.509 certificates.',"
+  "CONNECTION_RETRY_INTERVAL INTEGER not null comment 'The number of seconds between connect retries.',"
+  "CONNECTION_RETRY_COUNT BIGINT unsigned not null comment 'The number of times the replica can attempt to reconnect to the source in the event of a lost connection.',"
+  "HEARTBEAT_INTERVAL DOUBLE(10,3) unsigned not null COMMENT 'Number of seconds after which a heartbeat will be sent.',"
+  "TLS_VERSION VARCHAR(255) not null comment 'Not implemented, always blank.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_session_status.cc

@@ -47,8 +47,8 @@ table_session_status::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE session_status("
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "VARIABLE_NAME VARCHAR(64) not null comment 'The session status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'The session status variable value.')") },
   true   /* perpetual */
 };
 

storage/perfschema/table_setup_actors.cc

@@ -53,8 +53,8 @@ table_setup_actors::m_share=
                       "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default '%' not null comment 'Host name, either a literal, or the % wildcard representing any host.',"
                       "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default '%' not null comment 'User name, either a literal or the % wildcard representing any name.',"
                       "ROLE CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default '%' not null comment 'Unused',"
-                      "ENABLED ENUM('YES', 'NO') not null default 'YES',"
-                      "HISTORY ENUM('YES', 'NO') not null default 'YES')") },
+                      "ENABLED ENUM('YES', 'NO') not null default 'YES' comment 'Whether to enable instrumentation for foreground threads matched by the row.',"
+                      "HISTORY ENUM('YES', 'NO') not null default 'YES' comment 'Whether to log historical events for foreground threads matched by the row.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_status_by_account.cc

@@ -48,10 +48,10 @@ table_status_by_account::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE status_by_account("
-  "USER CHAR(32) collate utf8_bin default null,"
-  "HOST CHAR(60) collate utf8_bin default null,"
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "USER CHAR(32) collate utf8_bin default null comment 'User for which the status variable is reported.',"
+  "HOST CHAR(60) collate utf8_bin default null comment 'Host for which the status variable is reported.',"
+  "VARIABLE_NAME VARCHAR(64) not null comment 'Status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'Aggregated status variable value.' )") },
   false  /* perpetual */
 };
 

storage/perfschema/table_status_by_host.cc

@@ -48,9 +48,9 @@ table_status_by_host::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE status_by_host("
-  "HOST CHAR(60) collate utf8_bin default null,"
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "HOST CHAR(60) collate utf8_bin default null comment 'Host for which the status variable is reported.',"
+  "VARIABLE_NAME VARCHAR(64) not null comment 'Status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'Aggregated status variable value.' )") },
   false  /* perpetual */
 };
 

storage/perfschema/table_status_by_thread.cc

@@ -47,9 +47,9 @@ table_status_by_thread::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE status_by_thread("
-  "THREAD_ID BIGINT unsigned not null,"
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "THREAD_ID BIGINT unsigned not null comment 'The thread identifier of the session in which the status variable is defined.',"
+  "VARIABLE_NAME VARCHAR(64) not null comment 'Status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'Aggregated status variable value.' )") },
   false  /* perpetual */
 };
 

storage/perfschema/table_status_by_user.cc

@@ -49,9 +49,9 @@ table_status_by_user::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE status_by_user("
-  "USER CHAR(32) collate utf8_bin default null,"
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE VARCHAR(1024))") },
+  "USER CHAR(32) collate utf8_bin default null comment 'User for which the status variable is reported.',"
+  "VARIABLE_NAME VARCHAR(64) not null comment 'Status variable name.',"
+  "VARIABLE_VALUE VARCHAR(1024) comment 'Aggregated status variable value.' )") },
   false  /* perpetual */
 };
 

storage/perfschema/table_table_handles.cc

@@ -50,14 +50,14 @@ table_table_handles::m_share=
   sizeof(PFS_simple_index),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE table_handles("
-  "OBJECT_TYPE VARCHAR(64) not null,"
-  "OBJECT_SCHEMA VARCHAR(64) not null,"
-  "OBJECT_NAME VARCHAR(64) not null,"
-  "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
-  "OWNER_THREAD_ID BIGINT unsigned,"
-  "OWNER_EVENT_ID BIGINT unsigned,"
-  "INTERNAL_LOCK VARCHAR(64),"
-  "EXTERNAL_LOCK VARCHAR(64))") },
+  "OBJECT_TYPE VARCHAR(64) not null comment 'The table opened by a table handle.',"
+  "OBJECT_SCHEMA VARCHAR(64) not null comment 'The schema that contains the object.',"
+  "OBJECT_NAME VARCHAR(64) not null comment 'The name of the instrumented object.',"
+  "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'The table handle address in memory.',"
+  "OWNER_THREAD_ID BIGINT unsigned comment 'The thread owning the table handle.',"
+  "OWNER_EVENT_ID BIGINT unsigned comment 'The event which caused the table handle to be opened.',"
+  "INTERNAL_LOCK VARCHAR(64) comment 'The table lock used at the SQL level.',"
+  "EXTERNAL_LOCK VARCHAR(64) comment 'The table lock used at the storage engine level.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_threads.cc

@@ -55,9 +55,9 @@ table_threads::m_share=
                       "PARENT_THREAD_ID BIGINT unsigned comment 'THREAD_ID of the parent thread, if any. Subthreads can for example be spawned as a result of INSERT DELAYED statements.',"
                       "ROLE VARCHAR(64) comment 'Unused.',"
                       "INSTRUMENTED ENUM ('YES', 'NO') not null comment 'YES or NO for Whether the thread is instrumented or not. For foreground threads, the initial value is determined by whether there''s a user/host match in the setup_actors table. Subthreads are again matched, while for background threads, this will be set to YES by default. To monitor events that the thread executes, INSTRUMENTED must be YES and the thread_instrumentation consumer in the setup_consumers table must also be YES.',"
-                      "HISTORY ENUM ('YES', 'NO') not null,"
-                      "CONNECTION_TYPE VARCHAR(16),"
-                      "THREAD_OS_ID BIGINT unsigned)") },
+                      "HISTORY ENUM ('YES', 'NO') not null comment 'Whether to log historical events for the thread.',"
+                      "CONNECTION_TYPE VARCHAR(16) comment 'The protocol used to establish the connection, or NULL for background threads.',"
+                      "THREAD_OS_ID BIGINT unsigned comment 'The thread or task identifier as defined by the underlying operating system, if there is one.')") },
   false  /* perpetual */
 };
 

storage/perfschema/table_uvar_by_thread.cc

@@ -141,9 +141,9 @@ table_uvar_by_thread::m_share=
   sizeof(pos_t),
   &m_table_lock,
   { C_STRING_WITH_LEN("CREATE TABLE user_variables_by_thread("
-  "THREAD_ID BIGINT unsigned not null,"
-  "VARIABLE_NAME VARCHAR(64) not null,"
-  "VARIABLE_VALUE LONGBLOB)") },
+  "THREAD_ID BIGINT unsigned not null comment 'The thread identifier of the session in which the variable is defined.',"
+  "VARIABLE_NAME VARCHAR(64) not null comment 'The variable name, without the leading @ character.',"
+  "VARIABLE_VALUE LONGBLOB comment 'The variable value')") },
   false  /* perpetual */
 };