MySQL :: MySQL 8.0 Reference Manual :: 29.12.8.3 The users Table (original) (raw)

29.12.8.3 The users Table

The users table contains a row for each user who has connected to the MySQL server. For each user name, the table counts the current and total number of connections. The table size is autosized at server startup. To set the table size explicitly, set theperformance_schema_users_size system variable at server startup. To disable user statistics, set this variable to 0.

The users table has the following columns. For a description of how the Performance Schema maintains rows in this table, including the effect ofTRUNCATE TABLE, seeSection 29.12.8, “Performance Schema Connection Tables”.

• USER
  The client user name for the connection. This isNULL for an internal thread, or for a user session that failed to authenticate.
• CURRENT_CONNECTIONS
  The current number of connections for the user.
• TOTAL_CONNECTIONS
  The total number of connections for the user.
• MAX_SESSION_CONTROLLED_MEMORY
  Reports the maximum amount of controlled memory used by a session belonging to the user.
  This column was added in MySQL 8.0.31.
• MAX_SESSION_TOTAL_MEMORY
  Reports the maximum amount of memory used by a session belonging to the user.
  This column was added in MySQL 8.0.31.

The users table has these indexes:

• Primary key on (USER)