5.3 The mysql System Database

The mysql database is the system database. It contains tables that store information required by the MySQL server as it runs.

Tables in the mysql database fall into these categories:

• Grant System Tables

• Object Information System Tables

• Log System Tables

• Server-Side Help System Tables

• Time Zone System Tables

• Replication System Tables

• Optimizer System Tables

• Miscellaneous System Tables

The remainder of this section enumerates the tables in each category, with cross references for additional information. System tables use the MyISAM storage engine unless otherwise indicated.

Warning

Do not convert MySQL system tables in the mysql database from MyISAM to InnoDB tables. This is an unsupported operation. If you do this, MySQL does not restart until you restore the old system tables from a backup or regenerate them by reinitializing the data directory (see Section 2.10.1, “Initializing the Data Directory”).

Grant System Tables

These system tables contain grant information about user accounts and the privileges held by them:

• user: User accounts, global privileges, and other nonprivilege columns.

• db: Database-level privileges.

• host: Obsolete. MySQL install operations do not create this table as of MySQL 5.6.7.

• tables_priv: Table-level privileges.

• columns_priv: Column-level privileges.

• procs_priv: Stored procedure and function privileges.

• proxies_priv: Proxy-user privileges.

For more information about the structure, contents, and purpose of the grant tables, see Section 6.2.3, “Grant Tables”.

Object Information System Tables

These system tables contain information about stored programs, user-defined functions, and server-side plugins:

• event: Information about Event Scheduler events. See Section 20.4, “Using the Event Scheduler”. The server loads events listed in this table during its startup sequence, unless started with the --skip-grant-tables option.

• func: Information about user-defined functions (UDFs). See Section 24.4, “Adding Functions to MySQL”. The server loads UDFs listed in this table during its startup sequence, unless started with the --skip-grant-tables option.

• plugin: Information about server-side plugins. See Section 5.5.1, “Installing and Uninstalling Plugins”, and Section 24.2, “The MySQL Plugin API”. The server loads plugins listed in this table during its startup sequence, unless started with the --skip-grant-tables option.

• proc: Information about stored procedures and functions. See Section 20.2, “Using Stored Routines”.

Log System Tables

The server uses these system tables for logging:

• general_log: The general query log table.

• slow_log: The slow query log table.

Log tables use the CSV storage engine.

For more information, see Section 5.4, “MySQL Server Logs”.

Server-Side Help System Tables

These system tables contain server-side help information:

• help_category: Information about help categories.

• help_keyword: Keywords associated with help topics.

• help_relation: Mappings between help keywords and topics.

• help_topic: Help topic contents.

For more information, see Section 5.1.13, “Server-Side Help Support”.

Time Zone System Tables

These system tables contain time zone information:

• time_zone: Time zone IDs and whether they use leap seconds.

• time_zone_leap_second: When leap seconds occur.

• time_zone_name: Mappings between time zone IDs and names.

• time_zone_transition, time_zone_transition_type: Time zone descriptions.

For more information, see Section 5.1.12, “MySQL Server Time Zone Support”.

Replication System Tables

The server uses these system tables to support replication:

• ndb_binlog_index: Binary log information for NDB Cluster replication. See Section 18.6.4, “NDB Cluster Replication Schema and Tables”.

• slave_master_info, slave_relay_log_info, slave_worker_info: Used to store replication information on slave servers. See Section 17.2.2, “Replication Relay and Status Logs”.

  These tables use the InnoDB storage engine as of MySQL 5.6.6, MyISAM before that.

Optimizer System Tables

The innodb_index_stats and innodb_table_stats system tables are used for InnoDB persistent optimizer statistics. See Section 14.8.11.1, “Configuring Persistent Optimizer Statistics Parameters”.

These tables use the InnoDB storage engine.

Miscellaneous System Tables

Other system tables do not fall into the preceding categories:

• firewall_users, firewall_whitelist: If MySQL Enterprise Firewall is installed, these tables provide persistent storage for information used by the firewall. See Section 6.4.5, “MySQL Enterprise Firewall”.

• servers: Used by the FEDERATED storage engine. See Section 15.8.2.2, “Creating a FEDERATED Table Using CREATE SERVER”.