max_heap_table_size

This page is original PmaControl documentation. It keeps a practical index structure for MySQL optimization work, without copying third-party content or depending on an external product.

Role

Maximum size of user MEMORY tables and, with tmp_table_size, some temporary tables.

Diagnosis

SHOW VARIABLES LIKE 'max_heap_table_size';
SHOW GLOBAL STATUS LIKE '%max%';

The status counters do not always use the same name as the variable. Use this command as a starting point, then complete with performance_schema, SHOW ENGINE INNODB STATUS, or system metrics.

Tuning

Treat with tmp_table_size; both affect in-memory temporary tables.

Risks

• A global value that is too high can increase memory consumed at startup.
• A per-connection value can explode with max_connections.
• A change must be tested with a before/after measurement and rollback.