14.8.11.2 Configuring Non-Persistent Optimizer Statistics Parameters
This section describes how to configure non-persistent optimizer statistics. Optimizer statistics are not persisted to disk when innodb_stats_persistent=OFF or when individual tables are created or altered with STATS_PERSISTENT=0. Instead, statistics are stored in memory, and are lost when the server is shut down. Statistics are also updated periodically by certain operations and under certain conditions.
As of MySQL 5.6.6, optimizer statistics are persisted to disk by default, enabled by the innodb_stats_persistent configuration option. For information about persistent optimizer statistics, see Section 14.8.11.1, “Configuring Persistent Optimizer Statistics Parameters”.
Optimizer Statistics Updates
Non-persistent optimizer statistics are updated when:
Running
ANALYZE TABLE.-
Running
SHOW TABLE STATUS,SHOW INDEX, or querying the Information SchemaTABLESorSTATISTICStables with theinnodb_stats_on_metadataoption enabled.The default setting for
innodb_stats_on_metadatawas changed toOFFwhen persistent optimizer statistics were enabled by default in MySQL 5.6.6. Enablinginnodb_stats_on_metadatamay reduce access speed for schemas that have a large number of tables or indexes, and reduce stability of execution plans for queries that involveInnoDBtables.innodb_stats_on_metadatais configured globally using aSETstatement.SET GLOBAL innodb_stats_on_metadata=ON
Noteinnodb_stats_on_metadataonly applies when optimizer are configured to be non-persistent (wheninnodb_stats_persistentis disabled). -
Starting a mysql client with the
--auto-rehashoption enabled, which is the default. Theauto-rehashoption causes allInnoDBtables to be opened, and the open table operations cause statistics to be recalculated.To improve the start up time of the mysql client and to updating statistics, you can turn off
auto-rehashusing the--disable-auto-rehashoption. Theauto-rehashfeature enables automatic name completion of database, table, and column names for interactive users. A table is first opened.
InnoDBdetects that 1 / 16 of table has been modified since the last time statistics were updated.
Configuring the Number of Sampled Pages
The MySQL query optimizer uses estimated about key distributions to choose the indexes for an execution plan, based on the relative of the index. When InnoDB updates optimizer statistics, it samples random pages from each index on a table to estimate the of the index. (This technique is known as .)
To give you control over the quality of the statistics estimate (and thus better information for the query optimizer), you can change the number of sampled pages using the parameter innodb_stats_transient_sample_pages. The default number of sampled pages is 8, which could be insufficient to produce an accurate estimate, leading to poor index choices by the query optimizer. This technique is especially important for large tables and tables used in . Unnecessary for such tables can be a substantial performance issue. See Section 8.2.1.20, “Avoiding Full Table Scans” for tips on tuning such queries. innodb_stats_transient_sample_pages is a global parameter that can be set at runtime.
The value of innodb_stats_transient_sample_pages affects the index sampling for all InnoDB tables and indexes when innodb_stats_persistent=0. Be aware of the following potentially significant impacts when you change the index sample size:
Small values like 1 or 2 can result in inaccurate estimates of cardinality.
Increasing the
innodb_stats_transient_sample_pagesvalue might require more disk reads. Values much larger than 8 (say, 100), can cause a significant slowdown in the time it takes to open a table or executeSHOW TABLE STATUS.The optimizer might choose very different query plans based on different estimates of index selectivity.
Whatever value of innodb_stats_transient_sample_pages works best for a system, set the option and leave it at that value. Choose a value that results in reasonably accurate estimates for all tables in your database without requiring excessive I/O. Because the statistics are automatically recalculated at various times other than on execution of ANALYZE TABLE, it does not make sense to increase the index sample size, run ANALYZE TABLE, then decrease sample size again.
Smaller tables generally require fewer index samples than larger tables. If your database has many large tables, consider using a higher value for innodb_stats_transient_sample_pages than if you have mostly smaller tables.
© 2025 Oracle
Licensed under the GPLv2 License.