summaryrefslogtreecommitdiff
path: root/storage/perfschema
diff options
context:
space:
mode:
Diffstat (limited to 'storage/perfschema')
-rw-r--r--storage/perfschema/table_accounts.cc8
-rw-r--r--storage/perfschema/table_esgs_by_account_by_event_name.cc16
-rw-r--r--storage/perfschema/table_esgs_by_host_by_event_name.cc14
-rw-r--r--storage/perfschema/table_esgs_by_thread_by_event_name.cc14
-rw-r--r--storage/perfschema/table_esgs_by_user_by_event_name.cc14
-rw-r--r--storage/perfschema/table_esgs_global_by_event_name.cc12
-rw-r--r--storage/perfschema/table_esms_by_account_by_event_name.cc54
-rw-r--r--storage/perfschema/table_esms_by_digest.cc58
-rw-r--r--storage/perfschema/table_esms_by_host_by_event_name.cc52
-rw-r--r--storage/perfschema/table_esms_by_program.cc64
-rw-r--r--storage/perfschema/table_esms_by_thread_by_event_name.cc52
-rw-r--r--storage/perfschema/table_esms_by_user_by_event_name.cc52
-rw-r--r--storage/perfschema/table_esms_global_by_event_name.cc50
-rw-r--r--storage/perfschema/table_ets_by_account_by_event_name.cc36
-rw-r--r--storage/perfschema/table_ets_by_host_by_event_name.cc34
-rw-r--r--storage/perfschema/table_ets_by_thread_by_event_name.cc34
-rw-r--r--storage/perfschema/table_ets_by_user_by_event_name.cc34
-rw-r--r--storage/perfschema/table_ets_global_by_event_name.cc32
-rw-r--r--storage/perfschema/table_events_stages.cc72
-rw-r--r--storage/perfschema/table_events_statements.cc246
-rw-r--r--storage/perfschema/table_events_transactions.cc144
-rw-r--r--storage/perfschema/table_events_waits.cc114
-rw-r--r--storage/perfschema/table_events_waits_summary.cc14
-rw-r--r--storage/perfschema/table_ews_by_account_by_event_name.cc16
-rw-r--r--storage/perfschema/table_ews_by_host_by_event_name.cc14
-rw-r--r--storage/perfschema/table_ews_by_thread_by_event_name.cc14
-rw-r--r--storage/perfschema/table_ews_by_user_by_event_name.cc14
-rw-r--r--storage/perfschema/table_ews_global_by_event_name.cc12
-rw-r--r--storage/perfschema/table_file_instances.cc6
-rw-r--r--storage/perfschema/table_file_summary_by_event_name.cc46
-rw-r--r--storage/perfschema/table_file_summary_by_instance.cc50
-rw-r--r--storage/perfschema/table_global_status.cc4
-rw-r--r--storage/perfschema/table_host_cache.cc58
-rw-r--r--storage/perfschema/table_hosts.cc6
-rw-r--r--storage/perfschema/table_md_locks.cc20
-rw-r--r--storage/perfschema/table_mems_by_account_by_event_name.cc26
-rw-r--r--storage/perfschema/table_mems_by_host_by_event_name.cc24
-rw-r--r--storage/perfschema/table_mems_by_thread_by_event_name.cc24
-rw-r--r--storage/perfschema/table_mems_by_user_by_event_name.cc24
-rw-r--r--storage/perfschema/table_mems_global_by_event_name.cc22
-rw-r--r--storage/perfschema/table_os_global_by_type.cc16
-rw-r--r--storage/perfschema/table_performance_timers.cc8
-rw-r--r--storage/perfschema/table_prepared_stmt_instances.cc70
-rw-r--r--storage/perfschema/table_replication_applier_configuration.cc4
-rw-r--r--storage/perfschema/table_replication_applier_status.cc8
-rw-r--r--storage/perfschema/table_replication_applier_status_by_coordinator.cc16
-rw-r--r--storage/perfschema/table_replication_applier_status_by_worker.cc18
-rw-r--r--storage/perfschema/table_replication_connection_configuration.cc40
-rw-r--r--storage/perfschema/table_session_account_connect_attrs.cc8
-rw-r--r--storage/perfschema/table_session_connect_attrs.cc8
-rw-r--r--storage/perfschema/table_session_status.cc4
-rw-r--r--storage/perfschema/table_setup_actors.cc10
-rw-r--r--storage/perfschema/table_setup_consumers.cc4
-rw-r--r--storage/perfschema/table_setup_instruments.cc6
-rw-r--r--storage/perfschema/table_setup_objects.cc10
-rw-r--r--storage/perfschema/table_setup_timers.cc4
-rw-r--r--storage/perfschema/table_socket_instances.cc14
-rw-r--r--storage/perfschema/table_socket_summary_by_event_name.cc46
-rw-r--r--storage/perfschema/table_socket_summary_by_instance.cc48
-rw-r--r--storage/perfschema/table_status_by_account.cc8
-rw-r--r--storage/perfschema/table_status_by_host.cc6
-rw-r--r--storage/perfschema/table_status_by_thread.cc6
-rw-r--r--storage/perfschema/table_status_by_user.cc6
-rw-r--r--storage/perfschema/table_sync_instances.cc18
-rw-r--r--storage/perfschema/table_table_handles.cc16
-rw-r--r--storage/perfschema/table_threads.cc34
-rw-r--r--storage/perfschema/table_tiws_by_index_usage.cc78
-rw-r--r--storage/perfschema/table_tiws_by_table.cc76
-rw-r--r--storage/perfschema/table_tlws_by_table.cc146
-rw-r--r--storage/perfschema/table_users.cc6
-rw-r--r--storage/perfschema/table_uvar_by_thread.cc6
71 files changed, 1174 insertions, 1174 deletions
diff --git a/storage/perfschema/table_accounts.cc b/storage/perfschema/table_accounts.cc
index 310c81f26b3..781f408adcb 100644
--- a/storage/perfschema/table_accounts.cc
+++ b/storage/perfschema/table_accounts.cc
@@ -45,10 +45,10 @@ table_accounts::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE accounts("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null,"
- "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default null,"
- "CURRENT_CONNECTIONS bigint not null,"
- "TOTAL_CONNECTIONS bigint not null)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'The connection''s client user name for the connection, or NULL if an internal thread.',"
+ "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default null comment 'The connection client''s host name, or NULL if an internal thread.',"
+ "CURRENT_CONNECTIONS bigint not null comment 'Current connections for the account.',"
+ "TOTAL_CONNECTIONS bigint not null comment 'Total connections for the account.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esgs_by_account_by_event_name.cc b/storage/perfschema/table_esgs_by_account_by_event_name.cc
index 42bef1aa4de..48777f99ed4 100644
--- a/storage/perfschema/table_esgs_by_account_by_event_name.cc
+++ b/storage/perfschema/table_esgs_by_account_by_event_name.cc
@@ -50,14 +50,14 @@ table_esgs_by_account_by_event_name::m_share=
sizeof(pos_esgs_by_account_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_summary_by_account_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null,"
- "HOST CHAR(" HOSTNAME_LENGTH_STR ") 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)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with HOST and EVENT_NAME for grouping events.',"
+ "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default null comment 'Host. Used together with USER and EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER and HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events, which includes all timed and untimed events.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the timed summarized events.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the timed summarized events.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the timed summarized events.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the timed summarized events.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esgs_by_host_by_event_name.cc b/storage/perfschema/table_esgs_by_host_by_event_name.cc
index ebacdc6e5b0..34210c2a66e 100644
--- a/storage/perfschema/table_esgs_by_host_by_event_name.cc
+++ b/storage/perfschema/table_esgs_by_host_by_event_name.cc
@@ -51,13 +51,13 @@ table_esgs_by_host_by_event_name::m_share=
sizeof(pos_esgs_by_host_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_summary_by_host_by_event_name("
- "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") 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)") },
+ "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") collate utf8_bin default null comment 'Host. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events, which includes all timed and untimed events.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the timed summarized events.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the timed summarized events.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the timed summarized events.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the timed summarized events.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esgs_by_thread_by_event_name.cc b/storage/perfschema/table_esgs_by_thread_by_event_name.cc
index c266bfaf7a6..4d7b8a1ebcb 100644
--- a/storage/perfschema/table_esgs_by_thread_by_event_name.cc
+++ b/storage/perfschema/table_esgs_by_thread_by_event_name.cc
@@ -50,13 +50,13 @@ table_esgs_by_thread_by_event_name::m_share=
sizeof(pos_esgs_by_thread_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_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)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_NAME uniquely identifies the row.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with THREAD_ID for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events, which includes all timed and untimed events.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the timed summarized events.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the timed summarized events.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the timed summarized events.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the timed summarized events.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esgs_by_user_by_event_name.cc b/storage/perfschema/table_esgs_by_user_by_event_name.cc
index e6e6c321888..3e712e59327 100644
--- a/storage/perfschema/table_esgs_by_user_by_event_name.cc
+++ b/storage/perfschema/table_esgs_by_user_by_event_name.cc
@@ -50,13 +50,13 @@ table_esgs_by_user_by_event_name::m_share=
sizeof(pos_esgs_by_user_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_summary_by_user_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") 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)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events, which includes all timed and untimed events.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the timed summarized events.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the timed summarized events.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the timed summarized events.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the timed summarized events.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esgs_global_by_event_name.cc b/storage/perfschema/table_esgs_global_by_event_name.cc
index 71145844f9d..a7ea841a4a4 100644
--- a/storage/perfschema/table_esgs_global_by_event_name.cc
+++ b/storage/perfschema/table_esgs_global_by_event_name.cc
@@ -51,12 +51,12 @@ table_esgs_global_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_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)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events, which includes all timed and untimed events.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the timed summarized events.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the timed summarized events.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the timed summarized events.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the timed summarized events.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_by_account_by_event_name.cc b/storage/perfschema/table_esms_by_account_by_event_name.cc
index 589f62b9eca..fc08373341a 100644
--- a/storage/perfschema/table_esms_by_account_by_event_name.cc
+++ b/storage/perfschema/table_esms_by_account_by_event_name.cc
@@ -50,33 +50,33 @@ table_esms_by_account_by_event_name::m_share=
sizeof(pos_esms_by_account_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_summary_by_account_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null,"
- "HOST CHAR(" HOSTNAME_LENGTH_STR ") 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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with HOST and EVENT_NAME for grouping events.',"
+ "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default null comment 'Host. Used together with USER and EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER and HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_current table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_by_digest.cc b/storage/perfschema/table_esms_by_digest.cc
index acb9e059711..ade27883707 100644
--- a/storage/perfschema/table_esms_by_digest.cc
+++ b/storage/perfschema/table_esms_by_digest.cc
@@ -53,35 +53,35 @@ table_esms_by_digest::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_summary_by_digest("
- "SCHEMA_NAME VARCHAR(64),"
- "DIGEST VARCHAR(32),"
- "DIGEST_TEXT LONGTEXT,"
- "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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null,"
- "FIRST_SEEN TIMESTAMP(0) NOT NULL default 0,"
- "LAST_SEEN TIMESTAMP(0) NOT NULL default 0)") },
+ "SCHEMA_NAME VARCHAR(64) comment 'Database name. Records are summarised together with DIGEST.',"
+ "DIGEST VARCHAR(32) comment 'Performance Schema digest. Records are summarised together with SCHEMA NAME.',"
+ "DIGEST_TEXT LONGTEXT comment 'The unhashed form of the digest.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_current table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.',"
+ "FIRST_SEEN TIMESTAMP(0) NOT NULL default 0 comment 'Time at which the digest was first seen.',"
+ "LAST_SEEN TIMESTAMP(0) NOT NULL default 0 comment 'Time at which the digest was most recently seen.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_by_host_by_event_name.cc b/storage/perfschema/table_esms_by_host_by_event_name.cc
index f5f6372d7e7..c186311ce41 100644
--- a/storage/perfschema/table_esms_by_host_by_event_name.cc
+++ b/storage/perfschema/table_esms_by_host_by_event_name.cc
@@ -51,32 +51,32 @@ table_esms_by_host_by_event_name::m_share=
sizeof(pos_esms_by_host_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_summary_by_host_by_event_name("
- "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") 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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null)") },
+ "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") collate utf8_bin default null comment 'Host. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_currentd table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOINW column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_by_program.cc b/storage/perfschema/table_esms_by_program.cc
index 3cb2e4a4d46..59202230ef0 100644
--- a/storage/perfschema/table_esms_by_program.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_esms_by_thread_by_event_name.cc b/storage/perfschema/table_esms_by_thread_by_event_name.cc
index 306edc769c8..6db44a61600 100644
--- a/storage/perfschema/table_esms_by_thread_by_event_name.cc
+++ b/storage/perfschema/table_esms_by_thread_by_event_name.cc
@@ -50,32 +50,32 @@ table_esms_by_thread_by_event_name::m_share=
sizeof(pos_esms_by_thread_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_NAME uniquely identifies the row.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with THREAD_ID for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_current table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_by_user_by_event_name.cc b/storage/perfschema/table_esms_by_user_by_event_name.cc
index c0517748b99..0016b6ea823 100644
--- a/storage/perfschema/table_esms_by_user_by_event_name.cc
+++ b/storage/perfschema/table_esms_by_user_by_event_name.cc
@@ -50,32 +50,32 @@ table_esms_by_user_by_event_name::m_share=
sizeof(pos_esms_by_user_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_summary_by_user_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") 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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_current table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_esms_global_by_event_name.cc b/storage/perfschema/table_esms_global_by_event_name.cc
index 6e2408be26a..09b6d5bb4b0 100644
--- a/storage/perfschema/table_esms_global_by_event_name.cc
+++ b/storage/perfschema/table_esms_global_by_event_name.cc
@@ -51,31 +51,31 @@ table_esms_global_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_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,"
- "SUM_LOCK_TIME BIGINT unsigned not null,"
- "SUM_ERRORS BIGINT unsigned not null,"
- "SUM_WARNINGS BIGINT unsigned not null,"
- "SUM_ROWS_AFFECTED BIGINT unsigned not null,"
- "SUM_ROWS_SENT BIGINT unsigned not null,"
- "SUM_ROWS_EXAMINED BIGINT unsigned not null,"
- "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "SUM_CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SUM_SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SUM_SELECT_RANGE BIGINT unsigned not null,"
- "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SUM_SELECT_SCAN BIGINT unsigned not null,"
- "SUM_SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SUM_SORT_RANGE BIGINT unsigned not null,"
- "SUM_SORT_ROWS BIGINT unsigned not null,"
- "SUM_SORT_SCAN BIGINT unsigned not null,"
- "SUM_NO_INDEX_USED BIGINT unsigned not null,"
- "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "SUM_LOCK_TIME BIGINT unsigned not null comment 'Sum of the LOCK_TIME column in the events_statements_current table.',"
+ "SUM_ERRORS BIGINT unsigned not null comment 'Sum of the ERRORS column in the events_statements_current table.',"
+ "SUM_WARNINGS BIGINT unsigned not null comment 'Sum of the WARNINGS column in the events_statements_current table.',"
+ "SUM_ROWS_AFFECTED BIGINT unsigned not null comment 'Sum of the ROWS_AFFECTED column in the events_statements_current table.',"
+ "SUM_ROWS_SENT BIGINT unsigned not null comment 'Sum of the ROWS_SENT column in the events_statements_current table.',"
+ "SUM_ROWS_EXAMINED BIGINT unsigned not null comment 'Sum of the ROWS_EXAMINED column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_DISK_TABLES column in the events_statements_current table.',"
+ "SUM_CREATED_TMP_TABLES BIGINT unsigned not null comment 'Sum of the CREATED_TMP_TABLES column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Sum of the SELECT_FULL_RANGE_JOIN column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE BIGINT unsigned not null comment 'Sum of the SELECT_RANGE column in the events_statements_current table.',"
+ "SUM_SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Sum of the SELECT_RANGE_CHECK column in the events_statements_current table.',"
+ "SUM_SELECT_SCAN BIGINT unsigned not null comment 'Sum of the SELECT_SCAN column in the events_statements_current table.',"
+ "SUM_SORT_MERGE_PASSES BIGINT unsigned not null comment 'Sum of the SORT_MERGE_PASSES column in the events_statements_current table.',"
+ "SUM_SORT_RANGE BIGINT unsigned not null comment 'Sum of the SORT_RANGE column in the events_statements_current table.',"
+ "SUM_SORT_ROWS BIGINT unsigned not null comment 'Sum of the SORT_ROWS column in the events_statements_current table.',"
+ "SUM_SORT_SCAN BIGINT unsigned not null comment 'Sum of the SORT_SCAN column in the events_statements_current table.',"
+ "SUM_NO_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_INDEX_USED column in the events_statements_current table.',"
+ "SUM_NO_GOOD_INDEX_USED BIGINT unsigned not null comment 'Sum of the NO_GOOD_INDEX_USED column in the events_statements_current table.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ets_by_account_by_event_name.cc b/storage/perfschema/table_ets_by_account_by_event_name.cc
index f951be2104a..801c9db443f 100644
--- a/storage/perfschema/table_ets_by_account_by_event_name.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_ets_by_host_by_event_name.cc b/storage/perfschema/table_ets_by_host_by_event_name.cc
index f02936241a0..17cccf372b9 100644
--- a/storage/perfschema/table_ets_by_host_by_event_name.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_ets_by_thread_by_event_name.cc b/storage/perfschema/table_ets_by_thread_by_event_name.cc
index 81ebf23bbfb..464bad8c202 100644
--- a/storage/perfschema/table_ets_by_thread_by_event_name.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_ets_by_user_by_event_name.cc b/storage/perfschema/table_ets_by_user_by_event_name.cc
index 66aae431782..afe0c5f8649 100644
--- a/storage/perfschema/table_ets_by_user_by_event_name.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_ets_global_by_event_name.cc b/storage/perfschema/table_ets_global_by_event_name.cc
index 6c13871a746..be3fbb60ac9 100644
--- a/storage/perfschema/table_ets_global_by_event_name.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_events_stages.cc b/storage/perfschema/table_events_stages.cc
index cd6c79df36c..dedfd92f9ec 100644
--- a/storage/perfschema/table_events_stages.cc
+++ b/storage/perfschema/table_events_stages.cc
@@ -49,18 +49,18 @@ table_events_stages_current::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_current("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "WORK_COMPLETED BIGINT unsigned,"
- "WORK_ESTIMATED BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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 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 transaction, statement, stage or wait.')") },
false /* perpetual */
};
@@ -78,18 +78,18 @@ table_events_stages_history::m_share=
sizeof(pos_events_stages_history), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_history("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "WORK_COMPLETED BIGINT unsigned,"
- "WORK_ESTIMATED BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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 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 transaction, statement, stage or wait.')") },
false /* perpetual */
};
@@ -107,18 +107,18 @@ table_events_stages_history_long::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_stages_history_long("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "WORK_COMPLETED BIGINT unsigned,"
- "WORK_ESTIMATED BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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 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 transaction, statement, stage or wait.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_events_statements.cc b/storage/perfschema/table_events_statements.cc
index c3667f061fd..9404bd87fcb 100644
--- a/storage/perfschema/table_events_statements.cc
+++ b/storage/perfschema/table_events_statements.cc
@@ -51,47 +51,47 @@ table_events_statements_current::m_share=
sizeof(pos_events_statements_current), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_current("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "LOCK_TIME bigint unsigned not null,"
- "SQL_TEXT LONGTEXT,"
- "DIGEST VARCHAR(32),"
- "DIGEST_TEXT LONGTEXT,"
- "CURRENT_SCHEMA VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "MYSQL_ERRNO INTEGER,"
- "RETURNED_SQLSTATE VARCHAR(5),"
- "MESSAGE_TEXT VARCHAR(128),"
- "ERRORS BIGINT unsigned not null,"
- "WARNINGS BIGINT unsigned not null,"
- "ROWS_AFFECTED BIGINT unsigned not null,"
- "ROWS_SENT BIGINT unsigned not null,"
- "ROWS_EXAMINED BIGINT unsigned not null,"
- "CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SELECT_RANGE BIGINT unsigned not null,"
- "SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SELECT_SCAN BIGINT unsigned not null,"
- "SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SORT_RANGE BIGINT unsigned not null,"
- "SORT_ROWS BIGINT unsigned not null,"
- "SORT_SCAN BIGINT unsigned not null,"
- "NO_INDEX_USED BIGINT unsigned not null,"
- "NO_GOOD_INDEX_USED BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "NESTING_EVENT_LEVEL INT)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "LOCK_TIME bigint unsigned not null comment 'Time in picoseconds spent waiting for locks. The time is calculated in microseconds but stored in picoseconds for compatibility with other timings.',"
+ "SQL_TEXT LONGTEXT comment 'The SQL statement, or NULL if the command is not associated with an SQL statement.',"
+ "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 '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.',"
+ "MESSAGE_TEXT VARCHAR(128) comment 'Statement error message. See MariaDB Error Codes.',"
+ "ERRORS BIGINT unsigned not null comment '0 if SQLSTATE signifies completion (starting with 00) or warning (01), otherwise 1.',"
+ "WARNINGS BIGINT unsigned not null comment 'Number of warnings from the diagnostics area.',"
+ "ROWS_AFFECTED BIGINT unsigned not null comment 'Number of rows affected the statement affected.',"
+ "ROWS_SENT BIGINT unsigned not null comment 'Number of rows returned.',"
+ "ROWS_EXAMINED BIGINT unsigned not null comment 'Number of rows read during the statement''s execution.',"
+ "CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Number of on-disk temp tables created by the statement.',"
+ "CREATED_TMP_TABLES BIGINT unsigned not null comment 'Number of temp tables created by the statement.',"
+ "SELECT_FULL_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which did not use an index.',"
+ "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range search of the first table.',"
+ "SELECT_RANGE BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range of the first table.',"
+ "SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Number of joins without keys performed by the statement that check for key usage after each row.',"
+ "SELECT_SCAN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a full scan of the first table.',"
+ "SORT_MERGE_PASSES BIGINT unsigned not null comment 'Number of merge passes by the sort algorithm performed by the statement. If too high, you may need to increase the sort_buffer_size.',"
+ "SORT_RANGE BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a range.',"
+ "SORT_ROWS BIGINT unsigned not null comment 'Number of rows sorted by the statement.',"
+ "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 '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 */
};
@@ -109,47 +109,47 @@ table_events_statements_history::m_share=
sizeof(pos_events_statements_history), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_history("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "LOCK_TIME bigint unsigned not null,"
- "SQL_TEXT LONGTEXT,"
- "DIGEST VARCHAR(32),"
- "DIGEST_TEXT LONGTEXT,"
- "CURRENT_SCHEMA VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "MYSQL_ERRNO INTEGER,"
- "RETURNED_SQLSTATE VARCHAR(5),"
- "MESSAGE_TEXT VARCHAR(128),"
- "ERRORS BIGINT unsigned not null,"
- "WARNINGS BIGINT unsigned not null,"
- "ROWS_AFFECTED BIGINT unsigned not null,"
- "ROWS_SENT BIGINT unsigned not null,"
- "ROWS_EXAMINED BIGINT unsigned not null,"
- "CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SELECT_RANGE BIGINT unsigned not null,"
- "SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SELECT_SCAN BIGINT unsigned not null,"
- "SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SORT_RANGE BIGINT unsigned not null,"
- "SORT_ROWS BIGINT unsigned not null,"
- "SORT_SCAN BIGINT unsigned not null,"
- "NO_INDEX_USED BIGINT unsigned not null,"
- "NO_GOOD_INDEX_USED BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "NESTING_EVENT_LEVEL INT)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "LOCK_TIME bigint unsigned not null comment 'Time in picoseconds spent waiting for locks. The time is calculated in microseconds but stored in picoseconds for compatibility with other timings.',"
+ "SQL_TEXT LONGTEXT comment 'The SQL statement, or NULL if the command is not associated with an SQL statement.',"
+ "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 '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.',"
+ "MESSAGE_TEXT VARCHAR(128) comment 'Statement error message. See MariaDB Error Codes.',"
+ "ERRORS BIGINT unsigned not null comment '0 if SQLSTATE signifies completion (starting with 00) or warning (01), otherwise 1.',"
+ "WARNINGS BIGINT unsigned not null comment 'Number of warnings from the diagnostics area.',"
+ "ROWS_AFFECTED BIGINT unsigned not null comment 'Number of rows affected the statement affected.',"
+ "ROWS_SENT BIGINT unsigned not null comment 'Number of rows returned.',"
+ "ROWS_EXAMINED BIGINT unsigned not null comment 'Number of rows read during the statement''s execution.',"
+ "CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Number of on-disk temp tables created by the statement.',"
+ "CREATED_TMP_TABLES BIGINT unsigned not null comment 'Number of temp tables created by the statement.',"
+ "SELECT_FULL_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which did not use an index.',"
+ "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range search of the first table.',"
+ "SELECT_RANGE BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range of the first table.',"
+ "SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Number of joins without keys performed by the statement that check for key usage after each row.',"
+ "SELECT_SCAN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a full scan of the first table.',"
+ "SORT_MERGE_PASSES BIGINT unsigned not null comment 'Number of merge passes by the sort algorithm performed by the statement. If too high, you may need to increase the sort_buffer_size.',"
+ "SORT_RANGE BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a range.',"
+ "SORT_ROWS BIGINT unsigned not null comment 'Number of rows sorted by the statement.',"
+ "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 '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 */
};
@@ -167,47 +167,47 @@ table_events_statements_history_long::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_statements_history_long("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "LOCK_TIME bigint unsigned not null,"
- "SQL_TEXT LONGTEXT,"
- "DIGEST VARCHAR(32),"
- "DIGEST_TEXT LONGTEXT,"
- "CURRENT_SCHEMA VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "MYSQL_ERRNO INTEGER,"
- "RETURNED_SQLSTATE VARCHAR(5),"
- "MESSAGE_TEXT VARCHAR(128),"
- "ERRORS BIGINT unsigned not null,"
- "WARNINGS BIGINT unsigned not null,"
- "ROWS_AFFECTED BIGINT unsigned not null,"
- "ROWS_SENT BIGINT unsigned not null,"
- "ROWS_EXAMINED BIGINT unsigned not null,"
- "CREATED_TMP_DISK_TABLES BIGINT unsigned not null,"
- "CREATED_TMP_TABLES BIGINT unsigned not null,"
- "SELECT_FULL_JOIN BIGINT unsigned not null,"
- "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null,"
- "SELECT_RANGE BIGINT unsigned not null,"
- "SELECT_RANGE_CHECK BIGINT unsigned not null,"
- "SELECT_SCAN BIGINT unsigned not null,"
- "SORT_MERGE_PASSES BIGINT unsigned not null,"
- "SORT_RANGE BIGINT unsigned not null,"
- "SORT_ROWS BIGINT unsigned not null,"
- "SORT_SCAN BIGINT unsigned not null,"
- "NO_INDEX_USED BIGINT unsigned not null,"
- "NO_GOOD_INDEX_USED BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "NESTING_EVENT_LEVEL INT)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "LOCK_TIME bigint unsigned not null comment 'Time in picoseconds spent waiting for locks. The time is calculated in microseconds but stored in picoseconds for compatibility with other timings.',"
+ "SQL_TEXT LONGTEXT comment 'The SQL statement, or NULL if the command is not associated with an SQL statement.',"
+ "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 '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.',"
+ "MESSAGE_TEXT VARCHAR(128) comment 'Statement error message. See MariaDB Error Codes.',"
+ "ERRORS BIGINT unsigned not null comment '0 if SQLSTATE signifies completion (starting with 00) or warning (01), otherwise 1.',"
+ "WARNINGS BIGINT unsigned not null comment 'Number of warnings from the diagnostics area.',"
+ "ROWS_AFFECTED BIGINT unsigned not null comment 'Number of rows affected the statement affected.',"
+ "ROWS_SENT BIGINT unsigned not null comment 'Number of rows returned.',"
+ "ROWS_EXAMINED BIGINT unsigned not null comment 'Number of rows read during the statement''s execution.',"
+ "CREATED_TMP_DISK_TABLES BIGINT unsigned not null comment 'Number of on-disk temp tables created by the statement.',"
+ "CREATED_TMP_TABLES BIGINT unsigned not null comment 'Number of temp tables created by the statement.',"
+ "SELECT_FULL_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which did not use an index.',"
+ "SELECT_FULL_RANGE_JOIN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range search of the first table.',"
+ "SELECT_RANGE BIGINT unsigned not null comment 'Number of joins performed by the statement which used a range of the first table.',"
+ "SELECT_RANGE_CHECK BIGINT unsigned not null comment 'Number of joins without keys performed by the statement that check for key usage after each row.',"
+ "SELECT_SCAN BIGINT unsigned not null comment 'Number of joins performed by the statement which used a full scan of the first table.',"
+ "SORT_MERGE_PASSES BIGINT unsigned not null comment 'Number of merge passes by the sort algorithm performed by the statement. If too high, you may need to increase the sort_buffer_size.',"
+ "SORT_RANGE BIGINT unsigned not null comment 'Number of sorts performed by the statement which used a range.',"
+ "SORT_ROWS BIGINT unsigned not null comment 'Number of rows sorted by the statement.',"
+ "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 '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 */
};
diff --git a/storage/perfschema/table_events_transactions.cc b/storage/perfschema/table_events_transactions.cc
index 1d717979a2f..ef2575b4d8b 100644
--- a/storage/perfschema/table_events_transactions.cc
+++ b/storage/perfschema/table_events_transactions.cc
@@ -51,30 +51,30 @@ table_events_transactions_current::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_transactions_current("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK'),"
- "TRX_ID BIGINT unsigned,"
- "GTID VARCHAR(64),"
- "XID_FORMAT_ID INTEGER,"
- "XID_GTRID VARCHAR(130),"
- "XID_BQUAL VARCHAR(130),"
- "XA_STATE VARCHAR(64),"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE'),"
- "ISOLATION_LEVEL VARCHAR(64),"
- "AUTOCOMMIT ENUM('YES','NO') not null,"
- "NUMBER_OF_SAVEPOINTS BIGINT unsigned,"
- "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned,"
- "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))")},
+ "THREAD_ID BIGINT unsigned not null comment 'The thread associated with the event.',"
+ "EVENT_ID BIGINT unsigned not null comment 'The event id associated with the event.',"
+ "END_EVENT_ID BIGINT unsigned comment 'This column is set to NULL when the event starts and updated to the thread current event number when the event ends.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'The name of the instrument from which the event was collected. This is a NAME value from the setup_instruments table.',"
+ "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK') comment 'The current transaction state. The value is ACTIVE (after START TRANSACTION or BEGIN), COMMITTED (after COMMIT), or ROLLED BACK (after ROLLBACK).',"
+ "TRX_ID BIGINT unsigned comment 'Unused.',"
+ "GTID VARCHAR(64) comment 'Transaction GTID, using the format DOMAIN-SERVER_ID-SEQUENCE_NO.',"
+ "XID_FORMAT_ID INTEGER comment 'XA transaction format ID for GTRID and BQUAL values.',"
+ "XID_GTRID VARCHAR(130) comment 'XA global transaction ID.',"
+ "XID_BQUAL VARCHAR(130) comment 'XA transaction branch qualifier.',"
+ "XA_STATE VARCHAR(64) comment 'The state of the XA transaction. The value is ACTIVE (after XA START), IDLE (after XA END), PREPARED (after XA PREPARE), ROLLED BACK (after XA ROLLBACK), or COMMITTED (after XA COMMIT).',"
+ "SOURCE VARCHAR(64) comment 'The name of the source file containing the instrumented code that produced the event and the line number in the file at which the instrumentation occurs.',"
+ "TIMER_START BIGINT unsigned comment 'The unit is picoseconds. When event timing started. NULL if event has no timing information.',"
+ "TIMER_END BIGINT unsigned comment 'The unit is picoseconds. When event timing ended. NULL if event has no timing information.',"
+ "TIMER_WAIT BIGINT unsigned comment 'The unit is picoseconds. Event duration. NULL if event has not timing information.',"
+ "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE') comment 'Transaction access mode.',"
+ "ISOLATION_LEVEL VARCHAR(64) comment 'Transaction isolation level. One of: REPEATABLE READ, READ COMMITTED, READ UNCOMMITTED, or SERIALIZABLE.',"
+ "AUTOCOMMIT ENUM('YES','NO') not null comment 'Whether autcommit mode was enabled when the transaction started.',"
+ "NUMBER_OF_SAVEPOINTS BIGINT unsigned comment 'The number of SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned comment 'The number of ROLLBACK_TO_SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned comment 'The number of RELEASE_SAVEPOINT statements issued during the transaction.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Unused.',"
+ "NESTING_EVENT_ID BIGINT unsigned comment 'The EVENT_ID value of the event within which this event is nested.',"
+ "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'The nesting event type.')")},
false /* perpetual */
};
@@ -92,30 +92,30 @@ table_events_transactions_history::m_share=
sizeof(pos_events_transactions_history), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_transactions_history("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK'),"
- "TRX_ID BIGINT unsigned,"
- "GTID VARCHAR(64),"
- "XID_FORMAT_ID INTEGER,"
- "XID_GTRID VARCHAR(130),"
- "XID_BQUAL VARCHAR(130),"
- "XA_STATE VARCHAR(64),"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE'),"
- "ISOLATION_LEVEL VARCHAR(64),"
- "AUTOCOMMIT ENUM('YES','NO') not null,"
- "NUMBER_OF_SAVEPOINTS BIGINT unsigned,"
- "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned,"
- "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))")},
+ "THREAD_ID BIGINT unsigned not null comment 'The thread associated with the event.',"
+ "EVENT_ID BIGINT unsigned not null comment 'The event id associated with the event.',"
+ "END_EVENT_ID BIGINT unsigned comment 'This column is set to NULL when the event starts and updated to the thread current event number when the event ends.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'The name of the instrument from which the event was collected. This is a NAME value from the setup_instruments table.',"
+ "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK') comment 'The current transaction state. The value is ACTIVE (after START TRANSACTION or BEGIN), COMMITTED (after COMMIT), or ROLLED BACK (after ROLLBACK).',"
+ "TRX_ID BIGINT unsigned comment 'Unused.',"
+ "GTID VARCHAR(64) comment 'Transaction GTID, using the format DOMAIN-SERVER_ID-SEQUENCE_NO.',"
+ "XID_FORMAT_ID INTEGER comment 'XA transaction format ID for GTRID and BQUAL values.',"
+ "XID_GTRID VARCHAR(130) comment 'XA global transaction ID.',"
+ "XID_BQUAL VARCHAR(130) comment 'XA transaction branch qualifier.',"
+ "XA_STATE VARCHAR(64) comment 'The state of the XA transaction. The value is ACTIVE (after XA START), IDLE (after XA END), PREPARED (after XA PREPARE), ROLLED BACK (after XA ROLLBACK), or COMMITTED (after XA COMMIT).',"
+ "SOURCE VARCHAR(64) comment 'The name of the source file containing the instrumented code that produced the event and the line number in the file at which the instrumentation occurs.',"
+ "TIMER_START BIGINT unsigned comment 'The unit is picoseconds. When event timing started. NULL if event has no timing information.',"
+ "TIMER_END BIGINT unsigned comment 'The unit is picoseconds. When event timing ended. NULL if event has no timing information.',"
+ "TIMER_WAIT BIGINT unsigned comment 'The unit is picoseconds. Event duration. NULL if event has not timing information.',"
+ "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE') comment 'Transaction access mode.',"
+ "ISOLATION_LEVEL VARCHAR(64) comment 'Transaction isolation level. One of: REPEATABLE READ, READ COMMITTED, READ UNCOMMITTED, or SERIALIZABLE.',"
+ "AUTOCOMMIT ENUM('YES','NO') not null comment 'Whether autcommit mode was enabled when the transaction started.',"
+ "NUMBER_OF_SAVEPOINTS BIGINT unsigned comment 'The number of SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned comment 'The number of ROLLBACK_TO_SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned comment 'The number of RELEASE_SAVEPOINT statements issued during the transaction.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Unused.',"
+ "NESTING_EVENT_ID BIGINT unsigned comment 'The EVENT_ID value of the event within which this event is nested.',"
+ "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'The nesting event type.')")},
false /* perpetual */
};
@@ -133,30 +133,30 @@ table_events_transactions_history_long::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_transactions_history_long("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK'),"
- "TRX_ID BIGINT unsigned,"
- "GTID VARCHAR(64),"
- "XID_FORMAT_ID INTEGER,"
- "XID_GTRID VARCHAR(130),"
- "XID_BQUAL VARCHAR(130),"
- "XA_STATE VARCHAR(64),"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE'),"
- "ISOLATION_LEVEL VARCHAR(64),"
- "AUTOCOMMIT ENUM('YES','NO') not null,"
- "NUMBER_OF_SAVEPOINTS BIGINT unsigned,"
- "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned,"
- "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'))")},
+ "THREAD_ID BIGINT unsigned not null comment 'The thread associated with the event.',"
+ "EVENT_ID BIGINT unsigned not null comment 'The event id associated with the event.',"
+ "END_EVENT_ID BIGINT unsigned comment 'This column is set to NULL when the event starts and updated to the thread current event number when the event ends.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'The name of the instrument from which the event was collected. This is a NAME value from the setup_instruments table.',"
+ "STATE ENUM('ACTIVE', 'COMMITTED', 'ROLLED BACK') comment 'The current transaction state. The value is ACTIVE (after START TRANSACTION or BEGIN), COMMITTED (after COMMIT), or ROLLED BACK (after ROLLBACK).',"
+ "TRX_ID BIGINT unsigned comment 'Unused.',"
+ "GTID VARCHAR(64) comment 'Transaction GTID, using the format DOMAIN-SERVER_ID-SEQUENCE_NO.',"
+ "XID_FORMAT_ID INTEGER comment 'XA transaction format ID for GTRID and BQUAL values.',"
+ "XID_GTRID VARCHAR(130) comment 'XA global transaction ID.',"
+ "XID_BQUAL VARCHAR(130) comment 'XA transaction branch qualifier.',"
+ "XA_STATE VARCHAR(64) comment 'The state of the XA transaction. The value is ACTIVE (after XA START), IDLE (after XA END), PREPARED (after XA PREPARE), ROLLED BACK (after XA ROLLBACK), or COMMITTED (after XA COMMIT).',"
+ "SOURCE VARCHAR(64) comment 'The name of the source file containing the instrumented code that produced the event and the line number in the file at which the instrumentation occurs.',"
+ "TIMER_START BIGINT unsigned comment 'The unit is picoseconds. When event timing started. NULL if event has no timing information.',"
+ "TIMER_END BIGINT unsigned comment 'The unit is picoseconds. When event timing ended. NULL if event has no timing information.',"
+ "TIMER_WAIT BIGINT unsigned comment 'The unit is picoseconds. Event duration. NULL if event has not timing information.',"
+ "ACCESS_MODE ENUM('READ ONLY', 'READ WRITE') comment 'Transaction access mode.',"
+ "ISOLATION_LEVEL VARCHAR(64) comment 'Transaction isolation level. One of: REPEATABLE READ, READ COMMITTED, READ UNCOMMITTED, or SERIALIZABLE.',"
+ "AUTOCOMMIT ENUM('YES','NO') not null comment 'Whether autcommit mode was enabled when the transaction started.',"
+ "NUMBER_OF_SAVEPOINTS BIGINT unsigned comment 'The number of SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_ROLLBACK_TO_SAVEPOINT BIGINT unsigned comment 'The number of ROLLBACK_TO_SAVEPOINT statements issued during the transaction.',"
+ "NUMBER_OF_RELEASE_SAVEPOINT BIGINT unsigned comment 'The number of RELEASE_SAVEPOINT statements issued during the transaction.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned comment 'Unused.',"
+ "NESTING_EVENT_ID BIGINT unsigned comment 'The EVENT_ID value of the event within which this event is nested.',"
+ "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT') comment 'The nesting event type.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_events_waits.cc b/storage/perfschema/table_events_waits.cc
index aa73344fff7..ae6530a0d48 100644
--- a/storage/perfschema/table_events_waits.cc
+++ b/storage/perfschema/table_events_waits.cc
@@ -51,25 +51,25 @@ table_events_waits_current::m_share=
sizeof(pos_events_waits_current), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_current("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "SPINS INTEGER unsigned,"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(512),"
- "INDEX_NAME VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "OPERATION VARCHAR(32) not null,"
- "NUMBER_OF_BYTES BIGINT,"
- "FLAGS INTEGER unsigned)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "SPINS INTEGER unsigned comment 'Number of spin rounds for a mutex, or NULL if spin rounds are not used, or spinning is not instrumented.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Name of the schema that contains the table for table I/O objects, otherwise NULL for file I/O and synchronization objects.',"
+ "OBJECT_NAME VARCHAR(512) comment 'File name for file I/O objects, table name for table I/O objects, the socket''s IP:PORT value for a socket object or NULL for a synchronization object.',"
+ "INDEX_NAME VARCHAR(64) comment 'Name of the index, PRIMARY for the primary key, or NULL for no index used.',"
+ "OBJECT_TYPE VARCHAR(64) comment 'FILE for a file object, TABLE or TEMPORARY TABLE for a table object, or NULL for a synchronization object.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the object.',"
+ "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.',"
+ "OPERATION VARCHAR(32) not null comment 'Operation type, for example read, write or lock',"
+ "NUMBER_OF_BYTES BIGINT comment 'Number of bytes that the operation read or wrote, or NULL for table I/O waits.',"
+ "FLAGS INTEGER unsigned comment 'Reserved for use in the future.')") },
false /* perpetual */
};
@@ -87,25 +87,25 @@ table_events_waits_history::m_share=
sizeof(pos_events_waits_history), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_history("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "SPINS INTEGER unsigned,"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(512),"
- "INDEX_NAME VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "OPERATION VARCHAR(32) not null,"
- "NUMBER_OF_BYTES BIGINT,"
- "FLAGS INTEGER unsigned)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "SPINS INTEGER unsigned comment 'Number of spin rounds for a mutex, or NULL if spin rounds are not used, or spinning is not instrumented.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Name of the schema that contains the table for table I/O objects, otherwise NULL for file I/O and synchronization objects.',"
+ "OBJECT_NAME VARCHAR(512) comment 'File name for file I/O objects, table name for table I/O objects, the socket''s IP:PORT value for a socket object or NULL for a synchronization object.',"
+ "INDEX_NAME VARCHAR(64) comment 'Name of the index, PRIMARY for the primary key, or NULL for no index used.',"
+ "OBJECT_TYPE VARCHAR(64) comment 'FILE for a file object, TABLE or TEMPORARY TABLE for a table object, or NULL for a synchronization object.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the object.',"
+ "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.',"
+ "OPERATION VARCHAR(32) not null comment 'Operation type, for example read, write or lock',"
+ "NUMBER_OF_BYTES BIGINT comment 'Number of bytes that the operation read or wrote, or NULL for table I/O waits.',"
+ "FLAGS INTEGER unsigned comment 'Reserved for use in the future.')") },
false /* perpetual */
};
@@ -123,25 +123,25 @@ table_events_waits_history_long::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_history_long("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_ID BIGINT unsigned not null,"
- "END_EVENT_ID BIGINT unsigned,"
- "EVENT_NAME VARCHAR(128) not null,"
- "SOURCE VARCHAR(64),"
- "TIMER_START BIGINT unsigned,"
- "TIMER_END BIGINT unsigned,"
- "TIMER_WAIT BIGINT unsigned,"
- "SPINS INTEGER unsigned,"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(512),"
- "INDEX_NAME VARCHAR(64),"
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "NESTING_EVENT_ID BIGINT unsigned,"
- "NESTING_EVENT_TYPE ENUM('TRANSACTION', 'STATEMENT', 'STAGE', 'WAIT'),"
- "OPERATION VARCHAR(32) not null,"
- "NUMBER_OF_BYTES BIGINT,"
- "FLAGS INTEGER unsigned)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_ID uniquely identifies the row.',"
+ "EVENT_ID BIGINT unsigned not null comment 'Thread''s current event number at the start of the event. Together with THREAD_ID uniquely identifies the row.',"
+ "END_EVENT_ID BIGINT unsigned comment 'NULL when the event starts, set to the thread''s current event number at the end of the event.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event instrument name and a NAME from the setup_instruments table',"
+ "SOURCE VARCHAR(64) comment 'Name and line number of the source file containing the instrumented code that produced the event.',"
+ "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.',"
+ "SPINS INTEGER unsigned comment 'Number of spin rounds for a mutex, or NULL if spin rounds are not used, or spinning is not instrumented.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Name of the schema that contains the table for table I/O objects, otherwise NULL for file I/O and synchronization objects.',"
+ "OBJECT_NAME VARCHAR(512) comment 'File name for file I/O objects, table name for table I/O objects, the socket''s IP:PORT value for a socket object or NULL for a synchronization object.',"
+ "INDEX_NAME VARCHAR(64) comment 'Name of the index, PRIMARY for the primary key, or NULL for no index used.',"
+ "OBJECT_TYPE VARCHAR(64) comment 'FILE for a file object, TABLE or TEMPORARY TABLE for a table object, or NULL for a synchronization object.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the object.',"
+ "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.',"
+ "OPERATION VARCHAR(32) not null comment 'Operation type, for example read, write or lock',"
+ "NUMBER_OF_BYTES BIGINT comment 'Number of bytes that the operation read or wrote, or NULL for table I/O waits.',"
+ "FLAGS INTEGER unsigned comment 'Reserved for use in the future.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_events_waits_summary.cc b/storage/perfschema/table_events_waits_summary.cc
index 71ae6eae685..dfc89596469 100644
--- a/storage/perfschema/table_events_waits_summary.cc
+++ b/storage/perfschema/table_events_waits_summary.cc
@@ -48,13 +48,13 @@ table_events_waits_summary_by_instance::m_share=
sizeof(pos_all_instr),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_summary_by_instance("
- "EVENT_NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned 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)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with OBJECT_INSTANCE_BEGIN for grouping events.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'If an instrument creates multiple instances, each instance has a unique OBJECT_INSTANCE_BEGIN value to allow for grouping by instance.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ews_by_account_by_event_name.cc b/storage/perfschema/table_ews_by_account_by_event_name.cc
index 05c874eab88..f04df499670 100644
--- a/storage/perfschema/table_ews_by_account_by_event_name.cc
+++ b/storage/perfschema/table_ews_by_account_by_event_name.cc
@@ -50,14 +50,14 @@ table_ews_by_account_by_event_name::m_share=
sizeof(pos_ews_by_account_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_summary_by_account_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null,"
- "HOST CHAR(" HOSTNAME_LENGTH_STR ") 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)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with HOST and EVENT_NAME for grouping events.',"
+ "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default null comment 'Host. Used together with USER and EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER and HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ews_by_host_by_event_name.cc b/storage/perfschema/table_ews_by_host_by_event_name.cc
index 129709b8c72..6d94dd851a5 100644
--- a/storage/perfschema/table_ews_by_host_by_event_name.cc
+++ b/storage/perfschema/table_ews_by_host_by_event_name.cc
@@ -51,13 +51,13 @@ table_ews_by_host_by_event_name::m_share=
sizeof(pos_ews_by_host_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_summary_by_host_by_event_name("
- "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") 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)") },
+ "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") collate utf8_bin default null comment 'Host. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER and HOST for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.' )") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ews_by_thread_by_event_name.cc b/storage/perfschema/table_ews_by_thread_by_event_name.cc
index 11b8a84dd46..89a34665e79 100644
--- a/storage/perfschema/table_ews_by_thread_by_event_name.cc
+++ b/storage/perfschema/table_ews_by_thread_by_event_name.cc
@@ -50,13 +50,13 @@ table_ews_by_thread_by_event_name::m_share=
sizeof(pos_ews_by_thread_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_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)") },
+ "THREAD_ID BIGINT unsigned not null comment 'Thread associated with the event. Together with EVENT_NAME uniquely identifies the row.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with THREAD_ID for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ews_by_user_by_event_name.cc b/storage/perfschema/table_ews_by_user_by_event_name.cc
index 5425d773f85..446ce860792 100644
--- a/storage/perfschema/table_ews_by_user_by_event_name.cc
+++ b/storage/perfschema/table_ews_by_user_by_event_name.cc
@@ -50,13 +50,13 @@ table_ews_by_user_by_event_name::m_share=
sizeof(pos_ews_by_user_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_summary_by_user_by_event_name("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") 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)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'User. Used together with EVENT_NAME for grouping events.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name. Used together with USER for grouping events.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_ews_global_by_event_name.cc b/storage/perfschema/table_ews_global_by_event_name.cc
index 13839ddba2b..eaea6c68176 100644
--- a/storage/perfschema/table_ews_global_by_event_name.cc
+++ b/storage/perfschema/table_ews_global_by_event_name.cc
@@ -51,12 +51,12 @@ table_ews_global_by_event_name::m_share=
sizeof(pos_ews_global_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE events_waits_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)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_file_instances.cc b/storage/perfschema/table_file_instances.cc
index ca77b606200..ebd2371900d 100644
--- a/storage/perfschema/table_file_instances.cc
+++ b/storage/perfschema/table_file_instances.cc
@@ -49,9 +49,9 @@ table_file_instances::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE file_instances("
- "FILE_NAME VARCHAR(512) not null,"
- "EVENT_NAME VARCHAR(128) not null,"
- "OPEN_COUNT INTEGER unsigned not null)") },
+ "FILE_NAME VARCHAR(512) not null comment 'File name.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Instrument name associated with the file.',"
+ "OPEN_COUNT INTEGER unsigned not null comment 'Open handles on the file. A value of greater than zero means that the file is currently open.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_file_summary_by_event_name.cc b/storage/perfschema/table_file_summary_by_event_name.cc
index 404b58187ff..b6ecb35e6fa 100644
--- a/storage/perfschema/table_file_summary_by_event_name.cc
+++ b/storage/perfschema/table_file_summary_by_event_name.cc
@@ -49,29 +49,29 @@ table_file_summary_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE file_summary_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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_READ BIGINT not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_WRITE BIGINT not null,"
- "COUNT_MISC BIGINT unsigned not null,"
- "SUM_TIMER_MISC BIGINT unsigned not null,"
- "MIN_TIMER_MISC BIGINT unsigned not null,"
- "AVG_TIMER_MISC BIGINT unsigned not null,"
- "MAX_TIMER_MISC BIGINT unsigned not null)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, including FGETS, FGETC, FREAD, and READ.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_READ BIGINT not null comment 'Bytes read by read operations.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, including FPUTS, FPUTC, FPRINTF, VFPRINTF, FWRITE, and PWRITE.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_WRITE BIGINT not null comment 'Bytes written by write operations.',"
+ "COUNT_MISC BIGINT unsigned not null comment 'Number of all miscellaneous operations not counted above, including CREATE, DELETE, OPEN, CLOSE, STREAM_OPEN, STREAM_CLOSE, SEEK, TELL, FLUSH, STAT, FSTAT, CHSIZE, RENAME, and SYNC.',"
+ "SUM_TIMER_MISC BIGINT unsigned not null comment 'Total wait time of all miscellaneous operations that are timed.',"
+ "MIN_TIMER_MISC BIGINT unsigned not null comment 'Minimum wait time of all miscellaneous operations that are timed.',"
+ "AVG_TIMER_MISC BIGINT unsigned not null comment 'Average wait time of all miscellaneous operations that are timed.',"
+ "MAX_TIMER_MISC BIGINT unsigned not null comment 'Maximum wait time of all miscellaneous operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_file_summary_by_instance.cc b/storage/perfschema/table_file_summary_by_instance.cc
index b05d1f24b60..854054b8b4e 100644
--- a/storage/perfschema/table_file_summary_by_instance.cc
+++ b/storage/perfschema/table_file_summary_by_instance.cc
@@ -49,31 +49,31 @@ table_file_summary_by_instance::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE file_summary_by_instance("
- "FILE_NAME VARCHAR(512) not null,"
- "EVENT_NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned 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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_READ BIGINT not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_WRITE BIGINT not null,"
- "COUNT_MISC BIGINT unsigned not null,"
- "SUM_TIMER_MISC BIGINT unsigned not null,"
- "MIN_TIMER_MISC BIGINT unsigned not null,"
- "AVG_TIMER_MISC BIGINT unsigned not null,"
- "MAX_TIMER_MISC BIGINT unsigned not null)") },
+ "FILE_NAME VARCHAR(512) not null comment 'File name.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory. Together with FILE_NAME and EVENT_NAME uniquely identifies a row.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, including FGETS, FGETC, FREAD, and READ.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_READ BIGINT not null comment 'Bytes read by read operations.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, including FPUTS, FPUTC, FPRINTF, VFPRINTF, FWRITE, and PWRITE.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_WRITE BIGINT not null comment 'Bytes written by write operations.',"
+ "COUNT_MISC BIGINT unsigned not null comment 'Number of all miscellaneous operations not counted above, including CREATE, DELETE, OPEN, CLOSE, STREAM_OPEN, STREAM_CLOSE, SEEK, TELL, FLUSH, STAT, FSTAT, CHSIZE, RENAME, and SYNC.',"
+ "SUM_TIMER_MISC BIGINT unsigned not null comment 'Total wait time of all miscellaneous operations that are timed.',"
+ "MIN_TIMER_MISC BIGINT unsigned not null comment 'Minimum wait time of all miscellaneous operations that are timed.',"
+ "AVG_TIMER_MISC BIGINT unsigned not null comment 'Average wait time of all miscellaneous operations that are timed.',"
+ "MAX_TIMER_MISC BIGINT unsigned not null comment 'Maximum wait time of all miscellaneous operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_global_status.cc b/storage/perfschema/table_global_status.cc
index a8d5bacf2f3..53e6fddef7a 100644
--- a/storage/perfschema/table_global_status.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_host_cache.cc b/storage/perfschema/table_host_cache.cc
index e482ead215c..6fbafea4c88 100644
--- a/storage/perfschema/table_host_cache.cc
+++ b/storage/perfschema/table_host_cache.cc
@@ -46,35 +46,35 @@ table_host_cache::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE host_cache("
- "IP VARCHAR(64) not null,"
- "HOST VARCHAR(255) collate utf8_bin,"
- "HOST_VALIDATED ENUM ('YES', 'NO') not null,"
- "SUM_CONNECT_ERRORS BIGINT not null,"
- "COUNT_HOST_BLOCKED_ERRORS BIGINT not null,"
- "COUNT_NAMEINFO_TRANSIENT_ERRORS BIGINT not null,"
- "COUNT_NAMEINFO_PERMANENT_ERRORS BIGINT not null,"
- "COUNT_FORMAT_ERRORS BIGINT not null,"
- "COUNT_ADDRINFO_TRANSIENT_ERRORS BIGINT not null,"
- "COUNT_ADDRINFO_PERMANENT_ERRORS BIGINT not null,"
- "COUNT_FCRDNS_ERRORS BIGINT not null,"
- "COUNT_HOST_ACL_ERRORS BIGINT not null,"
- "COUNT_NO_AUTH_PLUGIN_ERRORS BIGINT not null,"
- "COUNT_AUTH_PLUGIN_ERRORS BIGINT not null,"
- "COUNT_HANDSHAKE_ERRORS BIGINT not null,"
- "COUNT_PROXY_USER_ERRORS BIGINT not null,"
- "COUNT_PROXY_USER_ACL_ERRORS BIGINT not null,"
- "COUNT_AUTHENTICATION_ERRORS BIGINT not null,"
- "COUNT_SSL_ERRORS BIGINT not null,"
- "COUNT_MAX_USER_CONNECTIONS_ERRORS BIGINT not null,"
- "COUNT_MAX_USER_CONNECTIONS_PER_HOUR_ERRORS BIGINT not null,"
- "COUNT_DEFAULT_DATABASE_ERRORS BIGINT not null,"
- "COUNT_INIT_CONNECT_ERRORS BIGINT not null,"
- "COUNT_LOCAL_ERRORS BIGINT not null,"
- "COUNT_UNKNOWN_ERRORS BIGINT not null,"
- "FIRST_SEEN TIMESTAMP(0) NOT NULL default 0,"
- "LAST_SEEN TIMESTAMP(0) NOT NULL default 0,"
- "FIRST_ERROR_SEEN TIMESTAMP(0) null default 0,"
- "LAST_ERROR_SEEN TIMESTAMP(0) null default 0)") },
+ "IP VARCHAR(64) not null comment 'Client IP address.',"
+ "HOST VARCHAR(255) collate utf8_bin comment 'IP''s resolved DNS host name, or NULL if unknown.',"
+ "HOST_VALIDATED ENUM ('YES', 'NO') not null comment 'YES if the IP-to-host DNS lookup was successful, and the HOST column can be used to avoid DNS calls, or NO if unsuccessful, in which case DNS lookup is performed for each connect until either successful or a permanent error.',"
+ "SUM_CONNECT_ERRORS BIGINT not null comment 'Number of connection errors. Counts only protocol handshake errors for hosts that passed validation. These errors count towards max_connect_errors.',"
+ "COUNT_HOST_BLOCKED_ERRORS BIGINT not null comment 'Number of blocked connections because SUM_CONNECT_ERRORS exceeded the max_connect_errors system variable.',"
+ "COUNT_NAMEINFO_TRANSIENT_ERRORS BIGINT not null comment 'Number of transient errors during IP-to-host DNS lookups.',"
+ "COUNT_NAMEINFO_PERMANENT_ERRORS BIGINT not null comment 'Number of permanent errors during IP-to-host DNS lookups.',"
+ "COUNT_FORMAT_ERRORS BIGINT not null comment 'Number of host name format errors, for example a numeric host column.',"
+ "COUNT_ADDRINFO_TRANSIENT_ERRORS BIGINT not null comment 'Number of transient errors during host-to-IP reverse DNS lookups.',"
+ "COUNT_ADDRINFO_PERMANENT_ERRORS BIGINT not null comment 'Number of permanent errors during host-to-IP reverse DNS lookups.',"
+ "COUNT_FCRDNS_ERRORS BIGINT not null comment 'Number of forward-confirmed reverse DNS errors, which occur when IP-to-host DNS lookup does not match the originating IP address.',"
+ "COUNT_HOST_ACL_ERRORS BIGINT not null comment 'Number of errors occurring because no user from the host is permitted to log in. These attempts return error code 1130 ER_HOST_NOT_PRIVILEGED and do not proceed to username and password authentication.',"
+ "COUNT_NO_AUTH_PLUGIN_ERRORS BIGINT not null comment 'Number of errors due to requesting an authentication plugin that was not available. This can be due to the plugin never having been loaded, or the load attempt failing.',"
+ "COUNT_AUTH_PLUGIN_ERRORS BIGINT not null comment 'Number of errors reported by an authentication plugin. Plugins can increment COUNT_AUTHENTICATION_ERRORS or COUNT_HANDSHAKE_ERRORS instead, but, if specified or the error is unknown, this column is incremented.',"
+ "COUNT_HANDSHAKE_ERRORS BIGINT not null comment 'Number of errors detected at the wire protocol level.',"
+ "COUNT_PROXY_USER_ERRORS BIGINT not null comment 'Number of errors detected when a proxy user is proxied to a user that does not exist.',"
+ "COUNT_PROXY_USER_ACL_ERRORS BIGINT not null comment 'Number of errors detected when a proxy user is proxied to a user that exists, but the proxy user doesn''t have the PROXY privilege.',"
+ "COUNT_AUTHENTICATION_ERRORS BIGINT not null comment 'Number of errors where authentication failed.',"
+ "COUNT_SSL_ERRORS BIGINT not null comment 'Number of errors due to TLS problems.',"
+ "COUNT_MAX_USER_CONNECTIONS_ERRORS BIGINT not null comment 'Number of errors due to the per-user quota being exceeded.',"
+ "COUNT_MAX_USER_CONNECTIONS_PER_HOUR_ERRORS BIGINT not null comment 'Number of errors due to the per-hour quota being exceeded.',"
+ "COUNT_DEFAULT_DATABASE_ERRORS BIGINT not null comment 'Number of errors due to the user not having permission to access the specified default database, or it not existing.',"
+ "COUNT_INIT_CONNECT_ERRORS BIGINT not null comment 'Number of errors due to statements in the init_connect system variable.',"
+ "COUNT_LOCAL_ERRORS BIGINT not null comment 'Number of local server errors, such as out-of-memory errors, unrelated to network, authentication, or authorization.',"
+ "COUNT_UNKNOWN_ERRORS BIGINT not null comment 'Number of unknown errors that cannot be allocated to another column.',"
+ "FIRST_SEEN TIMESTAMP(0) NOT NULL default 0 comment 'Timestamp of the first connection attempt by the IP.',"
+ "LAST_SEEN TIMESTAMP(0) NOT NULL default 0 comment 'Timestamp of the most recent connection attempt by the IP.',"
+ "FIRST_ERROR_SEEN TIMESTAMP(0) null default 0 comment 'Timestamp of the first error seen from the IP.',"
+ "LAST_ERROR_SEEN TIMESTAMP(0) null default 0 comment 'Timestamp of the most recent error seen from the IP.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_hosts.cc b/storage/perfschema/table_hosts.cc
index 8e71bfc69bf..ccf8b7e7896 100644
--- a/storage/perfschema/table_hosts.cc
+++ b/storage/perfschema/table_hosts.cc
@@ -46,9 +46,9 @@ table_hosts::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE hosts("
- "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") collate utf8_bin default null,"
- "CURRENT_CONNECTIONS bigint not null,"
- "TOTAL_CONNECTIONS bigint not null)") },
+ "HOST CHAR(" STRINGIFY_ARG(HOSTNAME_LENGTH) ") collate utf8_bin default null comment 'Host name used by the client to connect, NULL for internal threads or user sessions that failed to authenticate.',"
+ "CURRENT_CONNECTIONS bigint not null comment 'Current number of the host''s connections.',"
+ "TOTAL_CONNECTIONS bigint not null comment 'Total number of the host''s connections')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_md_locks.cc b/storage/perfschema/table_md_locks.cc
index 9f78750e89b..a6bfdd25b68 100644
--- a/storage/perfschema/table_md_locks.cc
+++ b/storage/perfschema/table_md_locks.cc
@@ -49,16 +49,16 @@ table_metadata_locks::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE metadata_locks("
- "OBJECT_TYPE VARCHAR(64) not null,"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "LOCK_TYPE VARCHAR(32) not null,"
- "LOCK_DURATION VARCHAR(32) not null,"
- "LOCK_STATUS VARCHAR(32) not null,"
- "SOURCE VARCHAR(64),"
- "OWNER_THREAD_ID BIGINT unsigned,"
- "OWNER_EVENT_ID BIGINT unsigned)")},
+ "OBJECT_TYPE VARCHAR(64) not null comment 'Object type. One of BACKUP, COMMIT, EVENT, FUNCTION, GLOBAL, LOCKING SERVICE, PROCEDURE, SCHEMA, TABLE, TABLESPACE, TRIGGER (unused) or USER LEVEL LOCK.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Object schema.',"
+ "OBJECT_NAME VARCHAR(64) comment 'Object name.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the instrumented object.',"
+ "LOCK_TYPE VARCHAR(32) not null comment 'Lock type. One of BACKUP_FTWRL1, BACKUP_START, BACKUP_TRANS_DML, EXCLUSIVE, INTENTION_EXCLUSIVE, SHARED, SHARED_HIGH_PRIO, SHARED_NO_READ_WRITE, SHARED_NO_WRITE, SHARED_READ, SHARED_UPGRADABLE or SHARED_WRITE.',"
+ "LOCK_DURATION VARCHAR(32) not null comment 'Lock duration. One of EXPLICIT (locks released by explicit action, for example a global lock acquired with FLUSH TABLES WITH READ LOCK) , STATEMENT (locks implicitly released at statement end) or TRANSACTION (locks implicitly released at transaction end).',"
+ "LOCK_STATUS VARCHAR(32) not null comment 'Lock status. One of GRANTED, KILLED, PENDING, POST_RELEASE_NOTIFY, PRE_ACQUIRE_NOTIFY, TIMEOUT or VICTIM.',"
+ "SOURCE VARCHAR(64) comment 'Source file containing the instrumented code that produced the event, as well as the line number where the instrumentation occurred. This allows one to examine the source code involved.',"
+ "OWNER_THREAD_ID BIGINT unsigned comment 'Thread that requested the lock.',"
+ "OWNER_EVENT_ID BIGINT unsigned comment 'Event that requested the lock.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_mems_by_account_by_event_name.cc b/storage/perfschema/table_mems_by_account_by_event_name.cc
index 5c83c225d11..7a0254d91a2 100644
--- a/storage/perfschema/table_mems_by_account_by_event_name.cc
+++ b/storage/perfschema/table_mems_by_account_by_event_name.cc
@@ -51,19 +51,19 @@ table_mems_by_account_by_event_name::m_share=
sizeof(pos_mems_by_account_by_event_name),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE memory_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_ALLOC BIGINT unsigned not null,"
- "COUNT_FREE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null,"
- "LOW_COUNT_USED BIGINT not null,"
- "CURRENT_COUNT_USED BIGINT not null,"
- "HIGH_COUNT_USED BIGINT not null,"
- "LOW_NUMBER_OF_BYTES_USED BIGINT not null,"
- "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null,"
- "HIGH_NUMBER_OF_BYTES_USED BIGINT not null)")},
+ "USER CHAR(32) collate utf8_bin default null comment 'User portion of the account.',"
+ "HOST CHAR(60) collate utf8_bin default null comment 'Host portion of the account.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_ALLOC BIGINT unsigned not null comment 'Total number of allocations to memory.',"
+ "COUNT_FREE BIGINT unsigned not null comment 'Total number of attempts to free the allocated memory.',"
+ "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null comment 'Total number of bytes allocated.',"
+ "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null comment 'Total number of bytes freed',"
+ "LOW_COUNT_USED BIGINT not null comment 'Lowest number of allocated blocks (lowest value of CURRENT_COUNT_USED).',"
+ "CURRENT_COUNT_USED BIGINT not null comment 'Currently allocated blocks that have not been freed (COUNT_ALLOC minus COUNT_FREE).',"
+ "HIGH_COUNT_USED BIGINT not null comment 'Highest number of allocated blocks (highest value of CURRENT_COUNT_USED).',"
+ "LOW_NUMBER_OF_BYTES_USED BIGINT not null comment 'Lowest number of bytes used.',"
+ "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null comment 'Current number of bytes used (total allocated minus total freed).',"
+ "HIGH_NUMBER_OF_BYTES_USED BIGINT not null comment 'Highest number of bytes used.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_mems_by_host_by_event_name.cc b/storage/perfschema/table_mems_by_host_by_event_name.cc
index 0921dfa49c8..4b91d0420d5 100644
--- a/storage/perfschema/table_mems_by_host_by_event_name.cc
+++ b/storage/perfschema/table_mems_by_host_by_event_name.cc
@@ -51,18 +51,18 @@ table_mems_by_host_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE memory_summary_by_host_by_event_name("
- "HOST CHAR(60) collate utf8_bin default null,"
- "EVENT_NAME VARCHAR(128) not null,"
- "COUNT_ALLOC BIGINT unsigned not null,"
- "COUNT_FREE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null,"
- "LOW_COUNT_USED BIGINT not null,"
- "CURRENT_COUNT_USED BIGINT not null,"
- "HIGH_COUNT_USED BIGINT not null,"
- "LOW_NUMBER_OF_BYTES_USED BIGINT not null,"
- "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null,"
- "HIGH_NUMBER_OF_BYTES_USED BIGINT not null)")},
+ "HOST CHAR(60) collate utf8_bin default null comment 'Host portion of the account.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_ALLOC BIGINT unsigned not null comment 'Total number of allocations to memory.',"
+ "COUNT_FREE BIGINT unsigned not null comment 'Total number of attempts to free the allocated memory.',"
+ "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null comment 'Total number of bytes allocated.',"
+ "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null comment 'Total number of bytes freed',"
+ "LOW_COUNT_USED BIGINT not null comment 'Lowest number of allocated blocks (lowest value of CURRENT_COUNT_USED).',"
+ "CURRENT_COUNT_USED BIGINT not null comment 'Currently allocated blocks that have not been freed (COUNT_ALLOC minus COUNT_FREE).',"
+ "HIGH_COUNT_USED BIGINT not null comment 'Highest number of allocated blocks (highest value of CURRENT_COUNT_USED).',"
+ "LOW_NUMBER_OF_BYTES_USED BIGINT not null comment 'Lowest number of bytes used.',"
+ "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null comment 'Current number of bytes used (total allocated minus total freed).',"
+ "HIGH_NUMBER_OF_BYTES_USED BIGINT not null comment 'Highest number of bytes used.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_mems_by_thread_by_event_name.cc b/storage/perfschema/table_mems_by_thread_by_event_name.cc
index 9e36cb76dd7..3c25e948cbf 100644
--- a/storage/perfschema/table_mems_by_thread_by_event_name.cc
+++ b/storage/perfschema/table_mems_by_thread_by_event_name.cc
@@ -51,18 +51,18 @@ table_mems_by_thread_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE memory_summary_by_thread_by_event_name("
- "THREAD_ID BIGINT unsigned not null,"
- "EVENT_NAME VARCHAR(128) not null,"
- "COUNT_ALLOC BIGINT unsigned not null,"
- "COUNT_FREE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null,"
- "LOW_COUNT_USED BIGINT not null,"
- "CURRENT_COUNT_USED BIGINT not null,"
- "HIGH_COUNT_USED BIGINT not null,"
- "LOW_NUMBER_OF_BYTES_USED BIGINT not null,"
- "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null,"
- "HIGH_NUMBER_OF_BYTES_USED BIGINT not null)")},
+ "THREAD_ID BIGINT unsigned not null comment 'Thread id.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_ALLOC BIGINT unsigned not null comment 'Total number of allocations to memory.',"
+ "COUNT_FREE BIGINT unsigned not null comment 'Total number of attempts to free the allocated memory.',"
+ "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null comment 'Total number of bytes allocated.',"
+ "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null comment 'Total number of bytes freed',"
+ "LOW_COUNT_USED BIGINT not null comment 'Lowest number of allocated blocks (lowest value of CURRENT_COUNT_USED).',"
+ "CURRENT_COUNT_USED BIGINT not null comment 'Currently allocated blocks that have not been freed (COUNT_ALLOC minus COUNT_FREE).',"
+ "HIGH_COUNT_USED BIGINT not null comment 'Highest number of allocated blocks (highest value of CURRENT_COUNT_USED).',"
+ "LOW_NUMBER_OF_BYTES_USED BIGINT not null comment 'Lowest number of bytes used.',"
+ "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null comment 'Current number of bytes used (total allocated minus total freed).',"
+ "HIGH_NUMBER_OF_BYTES_USED BIGINT not null comment 'Highest number of bytes used.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_mems_by_user_by_event_name.cc b/storage/perfschema/table_mems_by_user_by_event_name.cc
index 5d5ee89d6bd..dbb4b19c430 100644
--- a/storage/perfschema/table_mems_by_user_by_event_name.cc
+++ b/storage/perfschema/table_mems_by_user_by_event_name.cc
@@ -51,18 +51,18 @@ table_mems_by_user_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE memory_summary_by_user_by_event_name("
- "USER CHAR(32) collate utf8_bin default null,"
- "EVENT_NAME VARCHAR(128) not null,"
- "COUNT_ALLOC BIGINT unsigned not null,"
- "COUNT_FREE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null,"
- "LOW_COUNT_USED BIGINT not null,"
- "CURRENT_COUNT_USED BIGINT not null,"
- "HIGH_COUNT_USED BIGINT not null,"
- "LOW_NUMBER_OF_BYTES_USED BIGINT not null,"
- "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null,"
- "HIGH_NUMBER_OF_BYTES_USED BIGINT not null)")},
+ "USER CHAR(32) collate utf8_bin default null comment 'User portion of the account.',"
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_ALLOC BIGINT unsigned not null comment 'Total number of allocations to memory.',"
+ "COUNT_FREE BIGINT unsigned not null comment 'Total number of attempts to free the allocated memory.',"
+ "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null comment 'Total number of bytes allocated.',"
+ "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null comment 'Total number of bytes freed',"
+ "LOW_COUNT_USED BIGINT not null comment 'Lowest number of allocated blocks (lowest value of CURRENT_COUNT_USED).',"
+ "CURRENT_COUNT_USED BIGINT not null comment 'Currently allocated blocks that have not been freed (COUNT_ALLOC minus COUNT_FREE).',"
+ "HIGH_COUNT_USED BIGINT not null comment 'Highest number of allocated blocks (highest value of CURRENT_COUNT_USED).',"
+ "LOW_NUMBER_OF_BYTES_USED BIGINT not null comment 'Lowest number of bytes used.',"
+ "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null comment 'Current number of bytes used (total allocated minus total freed).',"
+ "HIGH_NUMBER_OF_BYTES_USED BIGINT not null comment 'Highest number of bytes used.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_mems_global_by_event_name.cc b/storage/perfschema/table_mems_global_by_event_name.cc
index 93496e38cf4..4a6f7e86fed 100644
--- a/storage/perfschema/table_mems_global_by_event_name.cc
+++ b/storage/perfschema/table_mems_global_by_event_name.cc
@@ -51,17 +51,17 @@ table_mems_global_by_event_name::m_share=
sizeof(pos_t),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE memory_summary_global_by_event_name("
- "EVENT_NAME VARCHAR(128) not null,"
- "COUNT_ALLOC BIGINT unsigned not null,"
- "COUNT_FREE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null,"
- "LOW_COUNT_USED BIGINT not null,"
- "CURRENT_COUNT_USED BIGINT not null,"
- "HIGH_COUNT_USED BIGINT not null,"
- "LOW_NUMBER_OF_BYTES_USED BIGINT not null,"
- "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null,"
- "HIGH_NUMBER_OF_BYTES_USED BIGINT not null)")},
+ "EVENT_NAME VARCHAR(128) not null comment 'Event name.',"
+ "COUNT_ALLOC BIGINT unsigned not null comment 'Total number of allocations to memory.',"
+ "COUNT_FREE BIGINT unsigned not null comment 'Total number of attempts to free the allocated memory.',"
+ "SUM_NUMBER_OF_BYTES_ALLOC BIGINT unsigned not null comment 'Total number of bytes allocated.',"
+ "SUM_NUMBER_OF_BYTES_FREE BIGINT unsigned not null comment 'Total number of bytes freed',"
+ "LOW_COUNT_USED BIGINT not null comment 'Lowest number of allocated blocks (lowest value of CURRENT_COUNT_USED).',"
+ "CURRENT_COUNT_USED BIGINT not null comment 'Currently allocated blocks that have not been freed (COUNT_ALLOC minus COUNT_FREE).',"
+ "HIGH_COUNT_USED BIGINT not null comment 'Highest number of allocated blocks (highest value of CURRENT_COUNT_USED).',"
+ "LOW_NUMBER_OF_BYTES_USED BIGINT not null comment 'Lowest number of bytes used.',"
+ "CURRENT_NUMBER_OF_BYTES_USED BIGINT not null comment 'Current number of bytes used (total allocated minus total freed).',"
+ "HIGH_NUMBER_OF_BYTES_USED BIGINT not null comment 'Highest number of bytes used.')")},
false /* perpetual */
};
diff --git a/storage/perfschema/table_os_global_by_type.cc b/storage/perfschema/table_os_global_by_type.cc
index f693a0f16da..04592e70f41 100644
--- a/storage/perfschema/table_os_global_by_type.cc
+++ b/storage/perfschema/table_os_global_by_type.cc
@@ -49,14 +49,14 @@ table_os_global_by_type::m_share=
sizeof(pos_os_global_by_type),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE objects_summary_global_by_type("
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "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)") },
+ "OBJECT_TYPE VARCHAR(64) comment 'Groups records together with OBJECT_SCHEMA and OBJECT_NAME.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Groups records together with OBJECT_TYPE and OBJECT_NAME.',"
+ "OBJECT_NAME VARCHAR(64) comment 'Groups records together with OBJECT_SCHEMA and OBJECT_TYPE.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_performance_timers.cc b/storage/perfschema/table_performance_timers.cc
index 1c1d9c5afef..5f8714a356d 100644
--- a/storage/perfschema/table_performance_timers.cc
+++ b/storage/perfschema/table_performance_timers.cc
@@ -46,10 +46,10 @@ table_performance_timers::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE performance_timers("
- "TIMER_NAME ENUM ('CYCLE', 'NANOSECOND', 'MICROSECOND', 'MILLISECOND', 'TICK') not null,"
- "TIMER_FREQUENCY BIGINT,"
- "TIMER_RESOLUTION BIGINT,"
- "TIMER_OVERHEAD BIGINT)") },
+ "TIMER_NAME ENUM ('CYCLE', 'NANOSECOND', 'MICROSECOND', 'MILLISECOND', 'TICK') not null comment 'Time name, used in the setup_timers table.',"
+ "TIMER_FREQUENCY BIGINT comment 'Number of timer units per second. Dependent on the processor speed.',"
+ "TIMER_RESOLUTION BIGINT comment 'Number of timer units by which timed values increase each time.',"
+ "TIMER_OVERHEAD BIGINT comment 'Minimum timer overhead, determined during initialization by calling the timer 20 times and selecting the smallest value. Total overhead will be at least double this, as the timer is called at the beginning and end of each timed event.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_prepared_stmt_instances.cc b/storage/perfschema/table_prepared_stmt_instances.cc
index 6e93523deb4..c63827ec0ed 100644
--- a/storage/perfschema/table_prepared_stmt_instances.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_replication_applier_configuration.cc b/storage/perfschema/table_replication_applier_configuration.cc
index 1abe4e1e6e7..a9e3aabd2d9 100644
--- a/storage/perfschema/table_replication_applier_configuration.cc
+++ b/storage/perfschema/table_replication_applier_configuration.cc
@@ -52,8 +52,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 VARCHAR(256) collate utf8_general_ci not null,"
- "DESIRED_DELAY INTEGER not null)") },
+ "CHANNEL_NAME VARCHAR(256) collate utf8_general_ci not null comment 'Replication channel name.',"
+ "DESIRED_DELAY INTEGER not null comment 'Target number of seconds the replica should be delayed to the master.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_replication_applier_status.cc b/storage/perfschema/table_replication_applier_status.cc
index bea0894e3ae..c258eb244fd 100644
--- a/storage/perfschema/table_replication_applier_status.cc
+++ b/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 VARCHAR(256) 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 VARCHAR(256) 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 'Seconds the replica needs to wait to reach the desired delay from master.',"
+ "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 */
};
diff --git a/storage/perfschema/table_replication_applier_status_by_coordinator.cc b/storage/perfschema/table_replication_applier_status_by_coordinator.cc
index eae9251f232..c71aed0a359 100644
--- a/storage/perfschema/table_replication_applier_status_by_coordinator.cc
+++ b/storage/perfschema/table_replication_applier_status_by_coordinator.cc
@@ -55,14 +55,14 @@ 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 VARCHAR(256) 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,"
- "LAST_SEEN_TRANSACTION CHAR(57) not null,"
- "LAST_TRANS_RETRY_COUNT INTEGER not null)") },
+ "CHANNEL_NAME VARCHAR(256) 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.',"
+ "LAST_SEEN_TRANSACTION CHAR(57) not null comment 'The transaction the worker has last seen.',"
+ "LAST_TRANS_RETRY_COUNT INTEGER not null comment 'Total number of retries attempted by last transaction.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_replication_applier_status_by_worker.cc b/storage/perfschema/table_replication_applier_status_by_worker.cc
index bb7ec50a533..083da44dd49 100644
--- a/storage/perfschema/table_replication_applier_status_by_worker.cc
+++ b/storage/perfschema/table_replication_applier_status_by_worker.cc
@@ -52,15 +52,15 @@ table_replication_applier_status_by_worker::m_share=
sizeof(pos_t), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE replication_applier_status_by_worker("
- "CHANNEL_NAME VARCHAR(256) collate utf8_general_ci not null,"
- "THREAD_ID BIGINT UNSIGNED,"
- "SERVICE_STATE ENUM('ON','OFF') not null,"
- "LAST_SEEN_TRANSACTION CHAR(57) not null,"
- "LAST_ERROR_NUMBER INTEGER not null,"
- "LAST_ERROR_MESSAGE VARCHAR(1024) not null,"
- "LAST_ERROR_TIMESTAMP TIMESTAMP(0) not null,"
- "WORKER_IDLE_TIME BIGINT UNSIGNED not null,"
- "LAST_TRANS_RETRY_COUNT INTEGER not null)") },
+ "CHANNEL_NAME VARCHAR(256) collate utf8_general_ci not null comment 'Name of replication channel through which the transaction is received.',"
+ "THREAD_ID BIGINT UNSIGNED comment 'Thread_Id as displayed in the performance_schema.threads table for thread with name ''thread/sql/rpl_parallel_thread''. THREAD_ID will be NULL when worker threads are stopped due to error/force stop.',"
+ "SERVICE_STATE ENUM('ON','OFF') not null comment 'Whether or not the thread is running.',"
+ "LAST_SEEN_TRANSACTION CHAR(57) not null comment 'Last GTID executed by worker',"
+ "LAST_ERROR_NUMBER INTEGER not null comment 'Last Error that occurred on a particular worker.',"
+ "LAST_ERROR_MESSAGE VARCHAR(1024) not null comment 'Last error specific message.',"
+ "LAST_ERROR_TIMESTAMP TIMESTAMP(0) not null comment 'Time stamp of last error.',"
+ "WORKER_IDLE_TIME BIGINT UNSIGNED not null comment 'Total idle time in seconds that the worker thread has spent waiting for work from SQL thread.',"
+ "LAST_TRANS_RETRY_COUNT INTEGER not null comment 'Total number of retries attempted by last transaction.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_replication_connection_configuration.cc b/storage/perfschema/table_replication_connection_configuration.cc
index d6258d247f5..abcc2070dd1 100644
--- a/storage/perfschema/table_replication_connection_configuration.cc
+++ b/storage/perfschema/table_replication_connection_configuration.cc
@@ -54,26 +54,26 @@ 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 VARCHAR(256) 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,"
- "USING_GTID ENUM('NO','CURRENT_POS','SLAVE_POS') 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 .',"
- "IGNORE_SERVER_IDS LONGTEXT not null,"
- "REPL_DO_DOMAIN_IDS LONGTEXT not null,"
- "REPL_IGNORE_DOMAIN_IDS LONGTEXT not null)") },
+ "CHANNEL_NAME VARCHAR(256) 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.',"
+ "USING_GTID ENUM('NO','CURRENT_POS','SLAVE_POS') not null comment 'Whether replication is using GTIDs or not',"
+ "SSL_ALLOWED ENUM('YES','NO','IGNORED') not null comment 'Whether 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 'Whether 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.',"
+ "IGNORE_SERVER_IDS LONGTEXT not null comment 'Binary log events from servers (ids) to ignore.',"
+ "REPL_DO_DOMAIN_IDS LONGTEXT not null comment 'Only apply binary logs from these domain ids.',"
+ "REPL_IGNORE_DOMAIN_IDS LONGTEXT not null comment 'Binary log events from domains to ignore.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_session_account_connect_attrs.cc b/storage/perfschema/table_session_account_connect_attrs.cc
index 0e8be68d602..90c9fa37d6d 100644
--- a/storage/perfschema/table_session_account_connect_attrs.cc
+++ b/storage/perfschema/table_session_account_connect_attrs.cc
@@ -37,10 +37,10 @@ table_session_account_connect_attrs::m_share=
sizeof(pos_connect_attr_by_thread_by_attr), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE session_account_connect_attrs("
- "PROCESSLIST_ID INT NOT NULL,"
- "ATTR_NAME VARCHAR(32) NOT NULL,"
- "ATTR_VALUE VARCHAR(1024),"
- "ORDINAL_POSITION INT"
+ "PROCESSLIST_ID INT NOT NULL comment 'Session connection identifier.',"
+ "ATTR_NAME VARCHAR(32) NOT NULL comment 'Attribute name.',"
+ "ATTR_VALUE VARCHAR(1024) comment 'Attribute value.',"
+ "ORDINAL_POSITION INT comment 'Order in which attribute was added to the connection attributes.'"
") CHARACTER SET utf8 COLLATE utf8_bin") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_session_connect_attrs.cc b/storage/perfschema/table_session_connect_attrs.cc
index cc3fae46290..d0090374ddd 100644
--- a/storage/perfschema/table_session_connect_attrs.cc
+++ b/storage/perfschema/table_session_connect_attrs.cc
@@ -37,10 +37,10 @@ table_session_connect_attrs::m_share=
sizeof(pos_connect_attr_by_thread_by_attr), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE session_connect_attrs("
- "PROCESSLIST_ID INT NOT NULL,"
- "ATTR_NAME VARCHAR(32) NOT NULL,"
- "ATTR_VALUE VARCHAR(1024),"
- "ORDINAL_POSITION INT"
+ "PROCESSLIST_ID INT NOT NULL comment 'Session connection identifier.',"
+ "ATTR_NAME VARCHAR(32) NOT NULL comment 'Attribute name.',"
+ "ATTR_VALUE VARCHAR(1024) comment 'Attribute value.',"
+ "ORDINAL_POSITION INT comment 'Order in which attribute was added to the connection attributes.'"
") CHARACTER SET utf8 COLLATE utf8_bin") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_session_status.cc b/storage/perfschema/table_session_status.cc
index acff99caed0..b9e19b99a69 100644
--- a/storage/perfschema/table_session_status.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_setup_actors.cc b/storage/perfschema/table_setup_actors.cc
index e17bf3121da..3dadf9a031e 100644
--- a/storage/perfschema/table_setup_actors.cc
+++ b/storage/perfschema/table_setup_actors.cc
@@ -50,11 +50,11 @@ table_setup_actors::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE setup_actors("
- "HOST CHAR(" HOSTNAME_LENGTH_STR ") collate utf8_bin default '%' not null,"
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default '%' not null,"
- "ROLE CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default '%' not null,"
- "ENABLED ENUM('YES', 'NO') not null default 'YES',"
- "HISTORY ENUM('YES', 'NO') not null default 'YES')") },
+ "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' 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 */
};
diff --git a/storage/perfschema/table_setup_consumers.cc b/storage/perfschema/table_setup_consumers.cc
index 1745bf35c56..02f4dc0009f 100644
--- a/storage/perfschema/table_setup_consumers.cc
+++ b/storage/perfschema/table_setup_consumers.cc
@@ -143,8 +143,8 @@ table_setup_consumers::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE setup_consumers("
- "NAME VARCHAR(64) not null,"
- "ENABLED ENUM ('YES', 'NO') not null)") },
+ "NAME VARCHAR(64) not null comment 'Consumer name',"
+ "ENABLED ENUM ('YES', 'NO') not null comment 'YES or NO for whether or not the consumer is enabled. You can modify this column to ensure that event information is added, or is not added.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_setup_instruments.cc b/storage/perfschema/table_setup_instruments.cc
index 69e48b9c2ad..077c2a07b4f 100644
--- a/storage/perfschema/table_setup_instruments.cc
+++ b/storage/perfschema/table_setup_instruments.cc
@@ -51,9 +51,9 @@ table_setup_instruments::m_share=
sizeof(pos_setup_instruments),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE setup_instruments("
- "NAME VARCHAR(128) not null,"
- "ENABLED ENUM ('YES', 'NO') not null,"
- "TIMED ENUM ('YES', 'NO') not null)") },
+ "NAME VARCHAR(128) not null comment 'Instrument name',"
+ "ENABLED ENUM ('YES', 'NO') not null comment 'Whether or not the instrument is enabled. It can be disabled, and the instrument will produce no events.',"
+ "TIMED ENUM ('YES', 'NO') not null comment 'Whether or not the instrument is timed. It can be set, but if disabled, events produced by the instrument will have NULL values for the corresponding TIMER_START, TIMER_END, and TIMER_WAIT values.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_setup_objects.cc b/storage/perfschema/table_setup_objects.cc
index cccbd64f803..41551617a99 100644
--- a/storage/perfschema/table_setup_objects.cc
+++ b/storage/perfschema/table_setup_objects.cc
@@ -51,11 +51,11 @@ table_setup_objects::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE setup_objects("
- "OBJECT_TYPE ENUM ('EVENT','FUNCTION','PROCEDURE','TABLE','TRIGGER') not null default 'TABLE',"
- "OBJECT_SCHEMA VARCHAR(64) default '%',"
- "OBJECT_NAME VARCHAR(64) not null default '%',"
- "ENABLED ENUM ('YES', 'NO') not null default 'YES',"
- "TIMED ENUM ('YES', 'NO') not null default 'YES')") },
+ "OBJECT_TYPE ENUM ('EVENT','FUNCTION','PROCEDURE','TABLE','TRIGGER') not null default 'TABLE' comment 'Type of object to instrument.',"
+ "OBJECT_SCHEMA VARCHAR(64) default '%' comment 'Schema containing the object, either the literal or % for any schema.',"
+ "OBJECT_NAME VARCHAR(64) not null default '%' comment 'Name of the instrumented object, either the literal or % for any object.',"
+ "ENABLED ENUM ('YES', 'NO') not null default 'YES' comment 'Whether the object''s events are instrumented or not. Can be disabled, in which case monitoring is not enabled for those objects.',"
+ "TIMED ENUM ('YES', 'NO') not null default 'YES' comment 'Whether the object''s events are timed or not. Can be modified.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_setup_timers.cc b/storage/perfschema/table_setup_timers.cc
index d5656ea261e..fe8931a443e 100644
--- a/storage/perfschema/table_setup_timers.cc
+++ b/storage/perfschema/table_setup_timers.cc
@@ -73,8 +73,8 @@ table_setup_timers::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE setup_timers("
- "NAME VARCHAR(64) not null,"
- "TIMER_NAME ENUM ('CYCLE', 'NANOSECOND', 'MICROSECOND', 'MILLISECOND', 'TICK') not null)") },
+ "NAME VARCHAR(64) not null comment 'Type of instrument the timer is used for.',"
+ "TIMER_NAME ENUM ('CYCLE', 'NANOSECOND', 'MICROSECOND', 'MILLISECOND', 'TICK') not null comment 'Timer applying to the instrument type. Can be modified.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_socket_instances.cc b/storage/perfschema/table_socket_instances.cc
index 24c9b0d02a9..b976f981848 100644
--- a/storage/perfschema/table_socket_instances.cc
+++ b/storage/perfschema/table_socket_instances.cc
@@ -49,13 +49,13 @@ table_socket_instances::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE socket_instances("
- "EVENT_NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "THREAD_ID BIGINT unsigned,"
- "SOCKET_ID INTEGER not null,"
- "IP VARCHAR(64) not null,"
- "PORT INTEGER not null,"
- "STATE ENUM('IDLE','ACTIVE') not null)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'NAME from the setup_instruments table, and the name of the wait/io/socket/* instrument that produced the event.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Memory address of the object.',"
+ "THREAD_ID BIGINT unsigned comment 'Thread identifier that the server assigns to each socket.',"
+ "SOCKET_ID INTEGER not null comment 'The socket''s internal file handle.',"
+ "IP VARCHAR(64) not null comment 'Client IP address. Blank for Unix socket file, otherwise an IPv4 or IPv6 address. Together with the PORT identifies the connection.',"
+ "PORT INTEGER not null comment 'TCP/IP port number, from 0 to 65535. Together with the IP identifies the connection.',"
+ "STATE ENUM('IDLE','ACTIVE') not null comment 'Socket status, either IDLE if waiting to receive a request from a client, or ACTIVE')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_socket_summary_by_event_name.cc b/storage/perfschema/table_socket_summary_by_event_name.cc
index bdfff75614d..f5214a4ea25 100644
--- a/storage/perfschema/table_socket_summary_by_event_name.cc
+++ b/storage/perfschema/table_socket_summary_by_event_name.cc
@@ -49,29 +49,29 @@ table_socket_summary_by_event_name::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE socket_summary_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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_READ BIGINT unsigned not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_WRITE BIGINT unsigned not null,"
- "COUNT_MISC BIGINT unsigned not null,"
- "SUM_TIMER_MISC BIGINT unsigned not null,"
- "MIN_TIMER_MISC BIGINT unsigned not null,"
- "AVG_TIMER_MISC BIGINT unsigned not null,"
- "MAX_TIMER_MISC BIGINT unsigned not null)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Socket instrument.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, including RECV, RECVFROM, and RECVMSG.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_READ BIGINT unsigned not null comment 'Bytes read by read operations.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, including SEND, SENDTO, and SENDMSG.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_WRITE BIGINT unsigned not null comment 'Bytes written by write operations.',"
+ "COUNT_MISC BIGINT unsigned not null comment 'Number of all miscellaneous operations not counted above, including CONNECT, LISTEN, ACCEPT, CLOSE, and SHUTDOWN.',"
+ "SUM_TIMER_MISC BIGINT unsigned not null comment 'Total wait time of all miscellaneous operations that are timed.',"
+ "MIN_TIMER_MISC BIGINT unsigned not null comment 'Minimum wait time of all miscellaneous operations that are timed.',"
+ "AVG_TIMER_MISC BIGINT unsigned not null comment 'Average wait time of all miscellaneous operations that are timed.',"
+ "MAX_TIMER_MISC BIGINT unsigned not null comment 'Maximum wait time of all miscellaneous operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_socket_summary_by_instance.cc b/storage/perfschema/table_socket_summary_by_instance.cc
index 372cde61a87..bbd57e73be7 100644
--- a/storage/perfschema/table_socket_summary_by_instance.cc
+++ b/storage/perfschema/table_socket_summary_by_instance.cc
@@ -49,30 +49,30 @@ table_socket_summary_by_instance::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE socket_summary_by_instance("
- "EVENT_NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned 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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_READ BIGINT unsigned not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "SUM_NUMBER_OF_BYTES_WRITE BIGINT unsigned not null,"
- "COUNT_MISC BIGINT unsigned not null,"
- "SUM_TIMER_MISC BIGINT unsigned not null,"
- "MIN_TIMER_MISC BIGINT unsigned not null,"
- "AVG_TIMER_MISC BIGINT unsigned not null,"
- "MAX_TIMER_MISC BIGINT unsigned not null)") },
+ "EVENT_NAME VARCHAR(128) not null comment 'Socket instrument.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, including RECV, RECVFROM, and RECVMSG.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_READ BIGINT unsigned not null comment 'Bytes read by read operations.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, including SEND, SENDTO, and SENDMSG.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "SUM_NUMBER_OF_BYTES_WRITE BIGINT unsigned not null comment 'Bytes written by write operations.',"
+ "COUNT_MISC BIGINT unsigned not null comment 'Number of all miscellaneous operations not counted above, including CONNECT, LISTEN, ACCEPT, CLOSE, and SHUTDOWN.',"
+ "SUM_TIMER_MISC BIGINT unsigned not null comment 'Total wait time of all miscellaneous operations that are timed.',"
+ "MIN_TIMER_MISC BIGINT unsigned not null comment 'Minimum wait time of all miscellaneous operations that are timed.',"
+ "AVG_TIMER_MISC BIGINT unsigned not null comment 'Average wait time of all miscellaneous operations that are timed.',"
+ "MAX_TIMER_MISC BIGINT unsigned not null comment 'Maximum wait time of all miscellaneous operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_status_by_account.cc b/storage/perfschema/table_status_by_account.cc
index 30a1b6db036..6868fab1186 100644
--- a/storage/perfschema/table_status_by_account.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_status_by_host.cc b/storage/perfschema/table_status_by_host.cc
index cd41fcaa469..756414ff06a 100644
--- a/storage/perfschema/table_status_by_host.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_status_by_thread.cc b/storage/perfschema/table_status_by_thread.cc
index d9af7e49aa4..4c09dfc2b70 100644
--- a/storage/perfschema/table_status_by_thread.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_status_by_user.cc b/storage/perfschema/table_status_by_user.cc
index 921a72247b6..fb9324bebe7 100644
--- a/storage/perfschema/table_status_by_user.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_sync_instances.cc b/storage/perfschema/table_sync_instances.cc
index 5b9f90c1092..6187923df3e 100644
--- a/storage/perfschema/table_sync_instances.cc
+++ b/storage/perfschema/table_sync_instances.cc
@@ -50,9 +50,9 @@ table_mutex_instances::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE mutex_instances("
- "NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "LOCKED_BY_THREAD_ID BIGINT unsigned)") },
+ "NAME VARCHAR(128) not null comment 'Instrument name associated with the mutex.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Memory address of the instrumented mutex.',"
+ "LOCKED_BY_THREAD_ID BIGINT unsigned comment 'The THREAD_ID of the locking thread if a thread has a mutex locked, otherwise NULL.')") },
false /* perpetual */
};
@@ -198,10 +198,10 @@ table_rwlock_instances::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE rwlock_instances("
- "NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null,"
- "WRITE_LOCKED_BY_THREAD_ID BIGINT unsigned,"
- "READ_LOCKED_BY_COUNT INTEGER unsigned not null)") },
+ "NAME VARCHAR(128) not null comment 'Instrument name associated with the read write lock',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the instrumented lock',"
+ "WRITE_LOCKED_BY_THREAD_ID BIGINT unsigned comment 'THREAD_ID of the locking thread if locked in write (exclusive) mode, otherwise NULL.',"
+ "READ_LOCKED_BY_COUNT INTEGER unsigned not null comment 'Count of current read locks held')") },
false /* perpetual */
};
@@ -354,8 +354,8 @@ table_cond_instances::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE cond_instances("
- "NAME VARCHAR(128) not null,"
- "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null)") },
+ "NAME VARCHAR(128) not null comment 'Client user name for the connection, or NULL if an internal thread.',"
+ "OBJECT_INSTANCE_BEGIN BIGINT unsigned not null comment 'Address in memory of the instrumented condition.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_table_handles.cc b/storage/perfschema/table_table_handles.cc
index ab6ed357687..03431bbf1ad 100644
--- a/storage/perfschema/table_table_handles.cc
+++ b/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 */
};
diff --git a/storage/perfschema/table_threads.cc b/storage/perfschema/table_threads.cc
index a752902c787..fcf0a7ad80e 100644
--- a/storage/perfschema/table_threads.cc
+++ b/storage/perfschema/table_threads.cc
@@ -41,23 +41,23 @@ table_threads::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE threads("
- "THREAD_ID BIGINT unsigned not null,"
- "NAME VARCHAR(128) not null,"
- "TYPE VARCHAR(10) not null,"
- "PROCESSLIST_ID BIGINT unsigned,"
- "PROCESSLIST_USER VARCHAR(" USERNAME_CHAR_LENGTH_STR "),"
- "PROCESSLIST_HOST VARCHAR(" HOSTNAME_LENGTH_STR "),"
- "PROCESSLIST_DB VARCHAR(64),"
- "PROCESSLIST_COMMAND VARCHAR(16),"
- "PROCESSLIST_TIME BIGINT,"
- "PROCESSLIST_STATE VARCHAR(64),"
- "PROCESSLIST_INFO LONGTEXT,"
- "PARENT_THREAD_ID BIGINT unsigned,"
- "ROLE VARCHAR(64),"
- "INSTRUMENTED ENUM ('YES', 'NO') not null,"
- "HISTORY ENUM ('YES', 'NO') not null,"
- "CONNECTION_TYPE VARCHAR(16),"
- "THREAD_OS_ID BIGINT unsigned)") },
+ "THREAD_ID BIGINT unsigned not null comment 'A unique thread identifier.',"
+ "NAME VARCHAR(128) not null comment 'Name associated with the server''s thread instrumentation code, for example thread/sql/main for the server''s main() function, and thread/sql/one_connection for a user connection.',"
+ "TYPE VARCHAR(10) not null comment 'FOREGROUND or BACKGROUND, depending on the thread type. User connection threads are FOREGROUND, internal server threads are BACKGROUND.',"
+ "PROCESSLIST_ID BIGINT unsigned comment 'The PROCESSLIST.ID value for threads displayed in the INFORMATION_SCHEMA.PROCESSLIST table, or 0 for background threads. Also corresponds with the CONNECTION_ID() return value for the thread.',"
+ "PROCESSLIST_USER VARCHAR(" USERNAME_CHAR_LENGTH_STR ") comment 'Foreground thread user, or NULL for a background thread.',"
+ "PROCESSLIST_HOST VARCHAR(" HOSTNAME_LENGTH_STR ") comment 'Foreground thread host, or NULL for a background thread.',"
+ "PROCESSLIST_DB VARCHAR(64) comment 'Thread''s default database, or NULL if none exists.',"
+ "PROCESSLIST_COMMAND VARCHAR(16) comment 'Type of command executed by the thread. These correspond to the the COM_xxx client/server protocol commands, and the Com_xxx status variables. See Thread Command Values.',"
+ "PROCESSLIST_TIME BIGINT comment 'Time in seconds the thread has been in its current state.',"
+ "PROCESSLIST_STATE VARCHAR(64) comment 'Action, event or state indicating what the thread is doing.',"
+ "PROCESSLIST_INFO LONGTEXT comment 'Statement being executed by the thread, or NULL if a statement is not being executed. If a statement results in calling other statements, such as for a stored procedure, the innermost statement from the stored procedure is shown here.',"
+ "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 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 */
};
diff --git a/storage/perfschema/table_tiws_by_index_usage.cc b/storage/perfschema/table_tiws_by_index_usage.cc
index a1a7343e65b..8f11c35be56 100644
--- a/storage/perfschema/table_tiws_by_index_usage.cc
+++ b/storage/perfschema/table_tiws_by_index_usage.cc
@@ -50,45 +50,45 @@ table_tiws_by_index_usage::m_share=
sizeof(pos_tiws_by_index_usage),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE table_io_waits_summary_by_index_usage("
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "INDEX_NAME VARCHAR(64),"
- "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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "COUNT_FETCH BIGINT unsigned not null,"
- "SUM_TIMER_FETCH BIGINT unsigned not null,"
- "MIN_TIMER_FETCH BIGINT unsigned not null,"
- "AVG_TIMER_FETCH BIGINT unsigned not null,"
- "MAX_TIMER_FETCH BIGINT unsigned not null,"
- "COUNT_INSERT BIGINT unsigned not null,"
- "SUM_TIMER_INSERT BIGINT unsigned not null,"
- "MIN_TIMER_INSERT BIGINT unsigned not null,"
- "AVG_TIMER_INSERT BIGINT unsigned not null,"
- "MAX_TIMER_INSERT BIGINT unsigned not null,"
- "COUNT_UPDATE BIGINT unsigned not null,"
- "SUM_TIMER_UPDATE BIGINT unsigned not null,"
- "MIN_TIMER_UPDATE BIGINT unsigned not null,"
- "AVG_TIMER_UPDATE BIGINT unsigned not null,"
- "MAX_TIMER_UPDATE BIGINT unsigned not null,"
- "COUNT_DELETE BIGINT unsigned not null,"
- "SUM_TIMER_DELETE BIGINT unsigned not null,"
- "MIN_TIMER_DELETE BIGINT unsigned not null,"
- "AVG_TIMER_DELETE BIGINT unsigned not null,"
- "MAX_TIMER_DELETE BIGINT unsigned not null)") },
+ "OBJECT_TYPE VARCHAR(64) comment 'TABLE in the case of all indexes.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Schema name.',"
+ "OBJECT_NAME VARCHAR(64) comment 'Table name.',"
+ "INDEX_NAME VARCHAR(64) comment 'Index name, or PRIMARY for the primary index, NULL for no index (inserts are counted in this case).',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events and the sum of the x_READ and x_WRITE columns.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, and the sum of the equivalent x_FETCH columns.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, and the sum of the equivalent x_INSERT, x_UPDATE and x_DELETE columns.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "COUNT_FETCH BIGINT unsigned not null comment 'Number of all fetch operations.',"
+ "SUM_TIMER_FETCH BIGINT unsigned not null comment 'Total wait time of all fetch operations that are timed.',"
+ "MIN_TIMER_FETCH BIGINT unsigned not null comment 'Minimum wait time of all fetch operations that are timed.',"
+ "AVG_TIMER_FETCH BIGINT unsigned not null comment 'Average wait time of all fetch operations that are timed.',"
+ "MAX_TIMER_FETCH BIGINT unsigned not null comment 'Maximum wait time of all fetch operations that are timed.',"
+ "COUNT_INSERT BIGINT unsigned not null comment 'Number of all insert operations.',"
+ "SUM_TIMER_INSERT BIGINT unsigned not null comment 'Total wait time of all insert operations that are timed.',"
+ "MIN_TIMER_INSERT BIGINT unsigned not null comment 'Minimum wait time of all insert operations that are timed.',"
+ "AVG_TIMER_INSERT BIGINT unsigned not null comment 'Average wait time of all insert operations that are timed.',"
+ "MAX_TIMER_INSERT BIGINT unsigned not null comment 'Maximum wait time of all insert operations that are timed.',"
+ "COUNT_UPDATE BIGINT unsigned not null comment 'Number of all update operations.',"
+ "SUM_TIMER_UPDATE BIGINT unsigned not null comment 'Total wait time of all update operations that are timed.',"
+ "MIN_TIMER_UPDATE BIGINT unsigned not null comment 'Minimum wait time of all update operations that are timed.',"
+ "AVG_TIMER_UPDATE BIGINT unsigned not null comment 'Average wait time of all update operations that are timed.',"
+ "MAX_TIMER_UPDATE BIGINT unsigned not null comment 'Maximum wait time of all update operations that are timed.',"
+ "COUNT_DELETE BIGINT unsigned not null comment 'Number of all delete operations.',"
+ "SUM_TIMER_DELETE BIGINT unsigned not null comment 'Total wait time of all delete operations that are timed.',"
+ "MIN_TIMER_DELETE BIGINT unsigned not null comment 'Minimum wait time of all delete operations that are timed.',"
+ "AVG_TIMER_DELETE BIGINT unsigned not null comment 'Average wait time of all delete operations that are timed.',"
+ "MAX_TIMER_DELETE BIGINT unsigned not null comment 'Maximum wait time of all delete operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_tiws_by_table.cc b/storage/perfschema/table_tiws_by_table.cc
index abd45a7bf3a..e6cf8e53b64 100644
--- a/storage/perfschema/table_tiws_by_table.cc
+++ b/storage/perfschema/table_tiws_by_table.cc
@@ -50,44 +50,44 @@ table_tiws_by_table::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE table_io_waits_summary_by_table("
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "COUNT_FETCH BIGINT unsigned not null,"
- "SUM_TIMER_FETCH BIGINT unsigned not null,"
- "MIN_TIMER_FETCH BIGINT unsigned not null,"
- "AVG_TIMER_FETCH BIGINT unsigned not null,"
- "MAX_TIMER_FETCH BIGINT unsigned not null,"
- "COUNT_INSERT BIGINT unsigned not null,"
- "SUM_TIMER_INSERT BIGINT unsigned not null,"
- "MIN_TIMER_INSERT BIGINT unsigned not null,"
- "AVG_TIMER_INSERT BIGINT unsigned not null,"
- "MAX_TIMER_INSERT BIGINT unsigned not null,"
- "COUNT_UPDATE BIGINT unsigned not null,"
- "SUM_TIMER_UPDATE BIGINT unsigned not null,"
- "MIN_TIMER_UPDATE BIGINT unsigned not null,"
- "AVG_TIMER_UPDATE BIGINT unsigned not null,"
- "MAX_TIMER_UPDATE BIGINT unsigned not null,"
- "COUNT_DELETE BIGINT unsigned not null,"
- "SUM_TIMER_DELETE BIGINT unsigned not null,"
- "MIN_TIMER_DELETE BIGINT unsigned not null,"
- "AVG_TIMER_DELETE BIGINT unsigned not null,"
- "MAX_TIMER_DELETE BIGINT unsigned not null)") },
+ "OBJECT_TYPE VARCHAR(64) comment 'Since this table records waits by table, always set to TABLE.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Schema name.',"
+ "OBJECT_NAME VARCHAR(64) comment 'Table name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events and the sum of the x_READ and x_WRITE columns.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, and the sum of the equivalent x_FETCH columns.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, and the sum of the equivalent x_INSERT, x_UPDATE and x_DELETE columns.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "COUNT_FETCH BIGINT unsigned not null comment 'Number of all fetch operations.',"
+ "SUM_TIMER_FETCH BIGINT unsigned not null comment 'Total wait time of all fetch operations that are timed.',"
+ "MIN_TIMER_FETCH BIGINT unsigned not null comment 'Minimum wait time of all fetch operations that are timed.',"
+ "AVG_TIMER_FETCH BIGINT unsigned not null comment 'Average wait time of all fetch operations that are timed.',"
+ "MAX_TIMER_FETCH BIGINT unsigned not null comment 'Maximum wait time of all fetch operations that are timed.',"
+ "COUNT_INSERT BIGINT unsigned not null comment 'Number of all insert operations.',"
+ "SUM_TIMER_INSERT BIGINT unsigned not null comment 'Total wait time of all insert operations that are timed.',"
+ "MIN_TIMER_INSERT BIGINT unsigned not null comment 'Minimum wait time of all insert operations that are timed.',"
+ "AVG_TIMER_INSERT BIGINT unsigned not null comment 'Average wait time of all insert operations that are timed.',"
+ "MAX_TIMER_INSERT BIGINT unsigned not null comment 'Maximum wait time of all insert operations that are timed.',"
+ "COUNT_UPDATE BIGINT unsigned not null comment 'Number of all update operations.',"
+ "SUM_TIMER_UPDATE BIGINT unsigned not null comment 'Total wait time of all update operations that are timed.',"
+ "MIN_TIMER_UPDATE BIGINT unsigned not null comment 'Minimum wait time of all update operations that are timed.',"
+ "AVG_TIMER_UPDATE BIGINT unsigned not null comment 'Average wait time of all update operations that are timed.',"
+ "MAX_TIMER_UPDATE BIGINT unsigned not null comment 'Maximum wait time of all update operations that are timed.',"
+ "COUNT_DELETE BIGINT unsigned not null comment 'Number of all delete operations.',"
+ "SUM_TIMER_DELETE BIGINT unsigned not null comment 'Total wait time of all delete operations that are timed.',"
+ "MIN_TIMER_DELETE BIGINT unsigned not null comment 'Minimum wait time of all delete operations that are timed.',"
+ "AVG_TIMER_DELETE BIGINT unsigned not null comment 'Average wait time of all delete operations that are timed.',"
+ "MAX_TIMER_DELETE BIGINT unsigned not null comment 'Maximum wait time of all delete operations that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_tlws_by_table.cc b/storage/perfschema/table_tlws_by_table.cc
index 8f4bc2aea84..ea24d11187e 100644
--- a/storage/perfschema/table_tlws_by_table.cc
+++ b/storage/perfschema/table_tlws_by_table.cc
@@ -50,79 +50,79 @@ table_tlws_by_table::m_share=
sizeof(PFS_simple_index),
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE table_lock_waits_summary_by_table("
- "OBJECT_TYPE VARCHAR(64),"
- "OBJECT_SCHEMA VARCHAR(64),"
- "OBJECT_NAME VARCHAR(64),"
- "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 BIGINT unsigned not null,"
- "SUM_TIMER_READ BIGINT unsigned not null,"
- "MIN_TIMER_READ BIGINT unsigned not null,"
- "AVG_TIMER_READ BIGINT unsigned not null,"
- "MAX_TIMER_READ BIGINT unsigned not null,"
- "COUNT_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE BIGINT unsigned not null,"
- "COUNT_READ_NORMAL BIGINT unsigned not null,"
- "SUM_TIMER_READ_NORMAL BIGINT unsigned not null,"
- "MIN_TIMER_READ_NORMAL BIGINT unsigned not null,"
- "AVG_TIMER_READ_NORMAL BIGINT unsigned not null,"
- "MAX_TIMER_READ_NORMAL BIGINT unsigned not null,"
- "COUNT_READ_WITH_SHARED_LOCKS BIGINT unsigned not null,"
- "SUM_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null,"
- "MIN_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null,"
- "AVG_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null,"
- "MAX_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null,"
- "COUNT_READ_HIGH_PRIORITY BIGINT unsigned not null,"
- "SUM_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null,"
- "MIN_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null,"
- "AVG_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null,"
- "MAX_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null,"
- "COUNT_READ_NO_INSERT BIGINT unsigned not null,"
- "SUM_TIMER_READ_NO_INSERT BIGINT unsigned not null,"
- "MIN_TIMER_READ_NO_INSERT BIGINT unsigned not null,"
- "AVG_TIMER_READ_NO_INSERT BIGINT unsigned not null,"
- "MAX_TIMER_READ_NO_INSERT BIGINT unsigned not null,"
- "COUNT_READ_EXTERNAL BIGINT unsigned not null,"
- "SUM_TIMER_READ_EXTERNAL BIGINT unsigned not null,"
- "MIN_TIMER_READ_EXTERNAL BIGINT unsigned not null,"
- "AVG_TIMER_READ_EXTERNAL BIGINT unsigned not null,"
- "MAX_TIMER_READ_EXTERNAL BIGINT unsigned not null,"
- "COUNT_WRITE_ALLOW_WRITE BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null,"
- "COUNT_WRITE_CONCURRENT_INSERT BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null,"
- "COUNT_WRITE_DELAYED BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_DELAYED BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_DELAYED BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_DELAYED BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_DELAYED BIGINT unsigned not null,"
- "COUNT_WRITE_LOW_PRIORITY BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null,"
- "COUNT_WRITE_NORMAL BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_NORMAL BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_NORMAL BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_NORMAL BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_NORMAL BIGINT unsigned not null,"
- "COUNT_WRITE_EXTERNAL BIGINT unsigned not null,"
- "SUM_TIMER_WRITE_EXTERNAL BIGINT unsigned not null,"
- "MIN_TIMER_WRITE_EXTERNAL BIGINT unsigned not null,"
- "AVG_TIMER_WRITE_EXTERNAL BIGINT unsigned not null,"
- "MAX_TIMER_WRITE_EXTERNAL BIGINT unsigned not null)") },
+ "OBJECT_TYPE VARCHAR(64) comment 'Since this table records waits by table, always set to TABLE.',"
+ "OBJECT_SCHEMA VARCHAR(64) comment 'Schema name.',"
+ "OBJECT_NAME VARCHAR(64) comment 'Table name.',"
+ "COUNT_STAR BIGINT unsigned not null comment 'Number of summarized events and the sum of the x_READ and x_WRITE columns.',"
+ "SUM_TIMER_WAIT BIGINT unsigned not null comment 'Total wait time of the summarized events that are timed.',"
+ "MIN_TIMER_WAIT BIGINT unsigned not null comment 'Minimum wait time of the summarized events that are timed.',"
+ "AVG_TIMER_WAIT BIGINT unsigned not null comment 'Average wait time of the summarized events that are timed.',"
+ "MAX_TIMER_WAIT BIGINT unsigned not null comment 'Maximum wait time of the summarized events that are timed.',"
+ "COUNT_READ BIGINT unsigned not null comment 'Number of all read operations, and the sum of the equivalent x_READ_NORMAL, x_READ_WITH_SHARED_LOCKS, x_READ_HIGH_PRIORITY and x_READ_NO_INSERT columns.',"
+ "SUM_TIMER_READ BIGINT unsigned not null comment 'Total wait time of all read operations that are timed.',"
+ "MIN_TIMER_READ BIGINT unsigned not null comment 'Minimum wait time of all read operations that are timed.',"
+ "AVG_TIMER_READ BIGINT unsigned not null comment 'Average wait time of all read operations that are timed.',"
+ "MAX_TIMER_READ BIGINT unsigned not null comment 'Maximum wait time of all read operations that are timed.',"
+ "COUNT_WRITE BIGINT unsigned not null comment 'Number of all write operations, and the sum of the equivalent x_WRITE_ALLOW_WRITE, x_WRITE_CONCURRENT_INSERT, x_WRITE_DELAYED, x_WRITE_LOW_PRIORITY and x_WRITE_NORMAL columns.',"
+ "SUM_TIMER_WRITE BIGINT unsigned not null comment 'Total wait time of all write operations that are timed.',"
+ "MIN_TIMER_WRITE BIGINT unsigned not null comment 'Minimum wait time of all write operations that are timed.',"
+ "AVG_TIMER_WRITE BIGINT unsigned not null comment 'Average wait time of all write operations that are timed.',"
+ "MAX_TIMER_WRITE BIGINT unsigned not null comment 'Maximum wait time of all write operations that are timed.',"
+ "COUNT_READ_NORMAL BIGINT unsigned not null comment 'Number of all internal read normal locks.',"
+ "SUM_TIMER_READ_NORMAL BIGINT unsigned not null comment 'Total wait time of all internal read normal locks that are timed.',"
+ "MIN_TIMER_READ_NORMAL BIGINT unsigned not null comment 'Minimum wait time of all internal read normal locks that are timed.',"
+ "AVG_TIMER_READ_NORMAL BIGINT unsigned not null comment 'Average wait time of all internal read normal locks that are timed.',"
+ "MAX_TIMER_READ_NORMAL BIGINT unsigned not null comment 'Maximum wait time of all internal read normal locks that are timed.',"
+ "COUNT_READ_WITH_SHARED_LOCKS BIGINT unsigned not null comment 'Number of all internal read with shared locks.',"
+ "SUM_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null comment 'Total wait time of all internal read with shared locks that are timed.',"
+ "MIN_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null comment 'Minimum wait time of all internal read with shared locks that are timed.',"
+ "AVG_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null comment 'Average wait time of all internal read with shared locks that are timed.',"
+ "MAX_TIMER_READ_WITH_SHARED_LOCKS BIGINT unsigned not null comment 'Maximum wait time of all internal read with shared locks that are timed.',"
+ "COUNT_READ_HIGH_PRIORITY BIGINT unsigned not null comment 'Number of all internal read high priority locks.',"
+ "SUM_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null comment 'Total wait time of all internal read high priority locks that are timed.',"
+ "MIN_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null comment 'Minimum wait time of all internal read high priority locks that are timed.',"
+ "AVG_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null comment 'Average wait time of all internal read high priority locks that are timed.',"
+ "MAX_TIMER_READ_HIGH_PRIORITY BIGINT unsigned not null comment 'Maximum wait time of all internal read high priority locks that are timed.',"
+ "COUNT_READ_NO_INSERT BIGINT unsigned not null comment 'Number of all internal read no insert locks.',"
+ "SUM_TIMER_READ_NO_INSERT BIGINT unsigned not null comment 'Total wait time of all internal read no insert locks that are timed.',"
+ "MIN_TIMER_READ_NO_INSERT BIGINT unsigned not null comment 'Minimum wait time of all internal read no insert locks that are timed.',"
+ "AVG_TIMER_READ_NO_INSERT BIGINT unsigned not null comment 'Average wait time of all internal read no insert locks that are timed.',"
+ "MAX_TIMER_READ_NO_INSERT BIGINT unsigned not null comment 'Maximum wait time of all internal read no insert locks that are timed.',"
+ "COUNT_READ_EXTERNAL BIGINT unsigned not null comment 'Number of all external read locks.',"
+ "SUM_TIMER_READ_EXTERNAL BIGINT unsigned not null comment 'Total wait time of all external read locks that are timed.',"
+ "MIN_TIMER_READ_EXTERNAL BIGINT unsigned not null comment 'Minimum wait time of all external read locks that are timed.',"
+ "AVG_TIMER_READ_EXTERNAL BIGINT unsigned not null comment 'Average wait time of all external read locks that are timed.',"
+ "MAX_TIMER_READ_EXTERNAL BIGINT unsigned not null comment 'Maximum wait time of all external read locks that are timed.',"
+ "COUNT_WRITE_ALLOW_WRITE BIGINT unsigned not null comment 'Number of all internal read normal locks.',"
+ "SUM_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null comment 'Total wait time of all internal write allow write locks that are timed.',"
+ "MIN_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null comment 'Minimum wait time of all internal write allow write locks that are timed.',"
+ "AVG_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null comment 'Average wait time of all internal write allow write locks that are timed.',"
+ "MAX_TIMER_WRITE_ALLOW_WRITE BIGINT unsigned not null comment 'Maximum wait time of all internal write allow write locks that are timed.',"
+ "COUNT_WRITE_CONCURRENT_INSERT BIGINT unsigned not null comment 'Number of all internal concurrent insert write locks.',"
+ "SUM_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null comment 'Total wait time of all internal concurrent insert write locks that are timed.',"
+ "MIN_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null comment 'Minimum wait time of all internal concurrent insert write locks that are timed.',"
+ "AVG_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null comment 'Average wait time of all internal concurrent insert write locks that are timed.',"
+ "MAX_TIMER_WRITE_CONCURRENT_INSERT BIGINT unsigned not null comment 'Maximum wait time of all internal concurrent insert write locks that are timed.',"
+ "COUNT_WRITE_DELAYED BIGINT unsigned not null comment 'Number of all internal write delayed locks.',"
+ "SUM_TIMER_WRITE_DELAYED BIGINT unsigned not null comment 'Total wait time of all internal write delayed locks that are timed.',"
+ "MIN_TIMER_WRITE_DELAYED BIGINT unsigned not null comment 'Minimum wait time of all internal write delayed locks that are timed.',"
+ "AVG_TIMER_WRITE_DELAYED BIGINT unsigned not null comment 'Average wait time of all internal write delayed locks that are timed.',"
+ "MAX_TIMER_WRITE_DELAYED BIGINT unsigned not null comment 'Maximum wait time of all internal write delayed locks that are timed.',"
+ "COUNT_WRITE_LOW_PRIORITY BIGINT unsigned not null comment 'Number of all internal write low priority locks.',"
+ "SUM_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null comment 'Total wait time of all internal write low priority locks that are timed.',"
+ "MIN_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null comment 'Minimum wait time of all internal write low priority locks that are timed.',"
+ "AVG_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null comment 'Average wait time of all internal write low priority locks that are timed.',"
+ "MAX_TIMER_WRITE_LOW_PRIORITY BIGINT unsigned not null comment 'Maximum wait time of all internal write low priority locks that are timed.',"
+ "COUNT_WRITE_NORMAL BIGINT unsigned not null comment 'Number of all internal write normal locks.',"
+ "SUM_TIMER_WRITE_NORMAL BIGINT unsigned not null comment 'Total wait time of all internal write normal locks that are timed.',"
+ "MIN_TIMER_WRITE_NORMAL BIGINT unsigned not null comment 'Minimum wait time of all internal write normal locks that are timed.',"
+ "AVG_TIMER_WRITE_NORMAL BIGINT unsigned not null comment 'Average wait time of all internal write normal locks that are timed.',"
+ "MAX_TIMER_WRITE_NORMAL BIGINT unsigned not null comment 'Maximum wait time of all internal write normal locks that are timed.',"
+ "COUNT_WRITE_EXTERNAL BIGINT unsigned not null comment 'Number of all external write locks.',"
+ "SUM_TIMER_WRITE_EXTERNAL BIGINT unsigned not null comment 'Total wait time of all external write locks that are timed.',"
+ "MIN_TIMER_WRITE_EXTERNAL BIGINT unsigned not null comment 'Minimum wait time of all external write locks that are timed.',"
+ "AVG_TIMER_WRITE_EXTERNAL BIGINT unsigned not null comment 'Average wait time of all external write locks that are timed.',"
+ "MAX_TIMER_WRITE_EXTERNAL BIGINT unsigned not null comment 'Maximum wait time of all external write locks that are timed.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_users.cc b/storage/perfschema/table_users.cc
index 734ff7a4e51..007b20c15e2 100644
--- a/storage/perfschema/table_users.cc
+++ b/storage/perfschema/table_users.cc
@@ -46,9 +46,9 @@ table_users::m_share=
sizeof(PFS_simple_index), /* ref length */
&m_table_lock,
{ C_STRING_WITH_LEN("CREATE TABLE users("
- "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null,"
- "CURRENT_CONNECTIONS bigint not null,"
- "TOTAL_CONNECTIONS bigint not null)") },
+ "USER CHAR(" USERNAME_CHAR_LENGTH_STR ") collate utf8_bin default null comment 'The connection''s client user name for the connection, or NULL if an internal thread.',"
+ "CURRENT_CONNECTIONS bigint not null comment 'Current connections for the user.',"
+ "TOTAL_CONNECTIONS bigint not null comment 'Total connections for the user.')") },
false /* perpetual */
};
diff --git a/storage/perfschema/table_uvar_by_thread.cc b/storage/perfschema/table_uvar_by_thread.cc
index 77764c002cc..36f142da7ad 100644
--- a/storage/perfschema/table_uvar_by_thread.cc
+++ b/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 */
};