ANALYZE
ANALYZE — собрать статистику по базе данных
Синтаксис
ANALYZE [ (параметр[, ...] ) ] [таблица_и_столбцы[, ...] ] Здесь допускаетсяпараметр: VERBOSE [boolean] SKIP_LOCKED [boolean] BUFFER_USAGE_LIMITразмеритаблица_и_столбцы: [ ONLY ]имя_таблицы[ * ] [ (имя_столбца[, ...] ) ]
Описание
ANALYZE собирает статистическую информацию о содержимом таблиц в базе данных и сохраняет результаты в системном каталоге pg_statistic. Впоследствии планировщик запросов будет использовать эту статистику для выбора наиболее эффективных планов выполнения запросов.
Без списка таблица_и_столбцы команда ANALYZE обрабатывает все таблицы и материализованные представления в текущей базе данных, на анализ которых текущий пользователь имеет право. Со списком ANALYZE обрабатывает только указанные в нём таблицы. Дополнительно можно задать для таблицы список имён столбцов, в этом случае статистика будет собираться только по этим столбцам.
Параметры
VERBOSEВключает вывод сообщений о процессе выполнения на уровне
INFO.SKIP_LOCKEDУказывает, что команда
ANALYZEне должна ждать освобождения конфликтующих блокировок, начиная обработку отношения: если отношение не удаётся заблокировать сразу, без ожидания, оно пропускается. Заметьте, что даже с этим указаниемANALYZEможет заблокироваться, открывая индексы отношения или получая выборку строк из секций, потомков в иерархии наследования или некоторых видов сторонних таблиц. Учтите также, что при наличии конфликтующей блокировки в секционированной таблице командаANALYZEпропускает все её секции, тогда как обычно все они обрабатываются.BUFFER_USAGE_LIMITУказывает размер кольцевого буфера стратегии доступа к буферам (Buffer Access Strategy) для
ANALYZE. Этот размер используется для расчёта количества общих буферов, переиспользуемых в рамках этой стратегии. С значением0использование стратегии доступа к буферам отключается. Если не задать этот параметр,ANALYZEиспользует значение из vacuum_buffer_usage_limit. С большим значением параметраANALYZEможет выполняться быстрее, но при слишком большом значении многие полезные страницы могут вытесняться из общих буферов. Минимальное значение —128 kB, максимальное —16 GB.booleanВключает или отключает заданный параметр. Для включения параметра можно написать
TRUE,ONили1, а для отключения —FALSE,OFFили0. Значениеbooleanможно опустить, в этом случае подразумеваетсяTRUE.размерЗадаёт объём памяти в килобайтах. Можно также указать в виде строки, содержащей числовой размер, за которым следует одна из следующих единиц информации:
B(байты),kB(килобайты),MB(мегабайты),GB(гигабайты) илиTB(терабайты).имя_таблицыИмя (возможно, дополненное схемой) определённой таблицы, подлежащей анализу. Если опущено, анализироваться будут все обычные и секционированные таблицы, а также материализованные представления в текущей базе данных (но не сторонние таблицы). Если перед именем таблицы указать
ONLY, будет проанализирована только эта таблица. Если не указатьONLY, будет проанализирована как сама таблица, так и все её наследуемые дочерние таблицы или секции (если есть). Дополнительно можно указать*после имени таблицы, чтобы явно обозначить необходимость анализа наследуемых дочерних таблиц (или секций).имя_столбцаИмя столбца, подлежащего анализу. По умолчанию анализируются все столбцы.
Выводимая информация
С указанием VERBOSE команда ANALYZE выдаёт сообщения о процессе анализа, отмечая текущую обрабатываемую таблицу. Также она выводит различные статистические сведения о таблицах.
Примечания
Чтобы осуществить анализ таблицы, обычно нужно иметь право MAINTAIN для таблицы. Однако владельцам баз данных также разрешено выполнять анализ всех таблиц в своих базах, за исключением общих каталогов. ANALYZE пропускает все таблицы, на анализ которых текущий пользователь не имеет прав.
Сторонние таблицы анализируются только при явном указании и только если соответствующая обёртка сторонних данных поддерживает команду ANALYZE. Если эта команда не поддерживается, при выполнении ANALYZE выводится предупреждение и больше ничего не происходит.
В стандартной конфигурации PostgreSQL работающий демон автоочистки (см. Подраздел 24.1.6) запускает анализ таблиц автоматически, когда они изначально заполняются данными, и периодически, по мере того, как они меняются. Если автоочистка отключена, рекомендуется запускать ANALYZE время от времени, либо после кардинальных изменений в таблице. Точная статистика помогает планировщику выбрать наиболее эффективный план запроса и тем самым увеличивает скорость выполнения запроса. Обычно для баз, где данные в основном читаются, выполняют VACUUM и ANALYZE раз в день, во время наименьшей активности. (Этого будет недостаточно, если данные меняются очень активно.)
На время выполнения команды ANALYZE search_path временно меняется на pg_catalog, pg_temp.
ANALYZE запрашивает для целевой таблицы блокировку только на чтение, поэтому данная команда может выполняться параллельно с другими не DDL-операциями с таблицей.
Статистика, собираемая командой ANALYZE, обычно включает список из нескольких самых частых значений в каждом столбце и гистограмму, отражающую примерное распределение данных во всех столбцах. Один или оба этих элемента статистики могут быть опущены, если ANALYZE сочтёт их неинтересными (например, в столбце уникального ключа нет повторяющихся значений), либо если тип данных столбца не поддерживает соответствующие операторы. Более подробно статистика описывается в Главе 24.
В больших таблицах ANALYZE не просматривает все строки, а обрабатывает только небольшую случайную выборку. Это позволяет проанализировать за короткое время даже очень большие таблицы. Однако учтите, что такая статистика будет лишь приблизительной и может немного меняться при каждом выполнении ANALYZE, даже если фактическое содержимое таблицы остаётся неизменным. Это может приводить к небольшим изменениям в оценках стоимости запросов, выводимых командой EXPLAIN. В редких случаях вследствие этой недетерменированности планировщик меняет свой выбор после выполнения ANALYZE. Чтобы избежать этого, увеличьте объём статистики, собираемой командой ANALYZE, как описано ниже.
Количеством статистики можно управлять, настраивая конфигурационную переменную default_statistics_target или устанавливая ориентир статистики на уровне столбцов командой ALTER TABLE ... ALTER COLUMN ... SET STATISTICS (см. ALTER TABLE). Ориентир задаёт максимальное число записей в списке наиболее распространённых значений и максимальное число интервалов в гистограмме. По умолчанию значение ориентира равно 100, но его можно увеличить или уменьшить в поисках баланса между точностью оценок планировщика и временем, требующимся для выполнения ANALYZE, а также объёмом статистики в таблице pg_statistic. Если установить ориентир статистики равным нулю, статистика по таким столбцам собираться не будет. Это может быть полезно для столбцов, которые никогда не фигурируют в предложениях WHERE, GROUP BY и ORDER BY, так как планировщик никогда не будет использовать их статистику.
Число строк таблицы, выбираемых для подготовки статистики, определяется наибольшим ориентиром статистики по всем анализируемым столбцам этой таблицы. Увеличение ориентира приводит к пропорциональному увеличению времени и пространства, требуемого для выполнения ANALYZE.
Одним из показателей, оцениваемых командой ANALYZE, является число различных значений, встречающихся в каждом столбце. Так как рассматривается только подмножество всех строк, эта оценка иногда может быть весьма неточной, даже при самых больших ориентирах статистики. Если эта неточность приводит к плохому выбору плана запроса, более точное значение можно определить вручную и затем задать его командой ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...).
Если у анализируемой таблицы есть потомки, ANALYZE соберёт два набора статистик: один по строкам только родительской таблицы, а второй по строкам родительской и всех дочерних таблиц. Второй набор статистики необходим для планирования запросов, обращающихся к дереву наследования как одному целому. Демон автоочистки, однако, принимая решение об автоматическом запуске анализа, будет учитывать операции добавления или изменения данных только в самой родительской таблице. Если изменения и добавления в этой таблице происходят редко, наследуемая статистика может терять актуальность, если не запускать ANALYZE вручную. По умолчанию ANALYZE также рекурсивно собирает и обновляет статистику для каждой дочерней таблицы. Чтобы отключить эту рекурсивную обработку, можно использовать ключевое слово ONLY.
Для секционированных таблиц ANALYZE собирает статистику, обрабатывая выборки строки из всех секций. По умолчанию ANALYZE также рекурсивно собирает и обновляет статистику для каждой секции. Чтобы отключить эту рекурсивную обработку, можно использовать ключевое слово ONLY.
Процесс автоочистки не затрагивает секционированные таблицы и родительские таблицы в иерархии наследования, если изменения происходят только в дочерних таблицах. Поэтому, чтобы статистика всей иерархии наследования была актуальной, обычно необходимо периодически выполнять ANALYZE вручную.
Если какие-либо из дочерних таблиц или секций являются сторонними таблицами и их обёртки сторонних данных не поддерживают ANALYZE, эти дочерние таблицы игнорируются при сборе статистики наследования.
Если анализируемая таблица оказалась пустой, ANALYZE не будет обновлять статистику по этой таблице; в базе сохранится статистика, собранная ранее.
Каждый процесс, выполняющий операцию ANALYZE, будет выдавать информацию о ходе её выполнения, отображаемую в представлении pg_stat_progress_analyze. За подробностями обратитесь к Подразделу 27.4.1.
Совместимость
Оператор ANALYZE отсутствует в стандарте SQL.
До версии PostgreSQL 11 использовался и по-прежнему поддерживается следующий синтаксис:
ANALYZE [ VERBOSE ] [ таблица_и_столбцы [, ...] ]
См. также
VACUUM, vacuumdb, Подраздел 19.10.2, Подраздел 24.1.6, Подраздел 27.4.1ANALYZE
ANALYZE — collect statistics about a database
Synopsis
ANALYZE [ (option[, ...] ) ] [table_and_columns[, ...] ] whereoptioncan be one of: VERBOSE [boolean] SKIP_LOCKED [boolean] BUFFER_USAGE_LIMITsizeandtable_and_columnsis: [ ONLY ]table_name[ * ] [ (column_name[, ...] ) ]
Description
ANALYZE collects statistics about the contents of tables in the database, and stores the results in the pg_statistic system catalog. Subsequently, the query planner uses these statistics to help determine the most efficient execution plans for queries.
Without a table_and_columns list, ANALYZE processes every table and materialized view in the current database that the current user has permission to analyze. With a list, ANALYZE processes only those table(s). It is further possible to give a list of column names for a table, in which case only the statistics for those columns are collected.
Parameters
VERBOSEEnables display of progress messages at
INFOlevel.SKIP_LOCKEDSpecifies that
ANALYZEshould not wait for any conflicting locks to be released when beginning work on a relation: if a relation cannot be locked immediately without waiting, the relation is skipped. Note that even with this option,ANALYZEmay still block when opening the relation's indexes or when acquiring sample rows from partitions, table inheritance children, and some types of foreign tables. Also, whileANALYZEordinarily processes all partitions of specified partitioned tables, this option will causeANALYZEto skip all partitions if there is a conflicting lock on the partitioned table.BUFFER_USAGE_LIMITSpecifies the Buffer Access Strategy ring buffer size for
ANALYZE. This size is used to calculate the number of shared buffers which will be reused as part of this strategy.0disables use of aBuffer Access Strategy. When this option is not specified,ANALYZEuses the value from vacuum_buffer_usage_limit. Higher settings can allowANALYZEto run more quickly, but having too large a setting may cause too many other useful pages to be evicted from shared buffers. The minimum value is128 kBand the maximum value is16 GB.booleanSpecifies whether the selected option should be turned on or off. You can write
TRUE,ON, or1to enable the option, andFALSE,OFF, or0to disable it. Thebooleanvalue can also be omitted, in which caseTRUEis assumed.sizeSpecifies an amount of memory in kilobytes. Sizes may also be specified as a string containing the numerical size followed by any one of the following memory units:
B(bytes),kB(kilobytes),MB(megabytes),GB(gigabytes), orTB(terabytes).table_nameThe name (possibly schema-qualified) of a specific table to analyze. If omitted, all regular tables, partitioned tables, and materialized views in the current database are analyzed (but not foreign tables). If
ONLYis specified before the table name, only that table is analyzed. IfONLYis not specified, the table and all its inheritance child tables or partitions (if any) are analyzed. Optionally,*can be specified after the table name to explicitly indicate that inheritance child tables (or partitions) are to be analyzed.column_nameThe name of a specific column to analyze. Defaults to all columns.
Outputs
When VERBOSE is specified, ANALYZE emits progress messages to indicate which table is currently being processed. Various statistics about the tables are printed as well.
Notes
To analyze a table, one must ordinarily have the MAINTAIN privilege on the table. However, database owners are allowed to analyze all tables in their databases, except shared catalogs. ANALYZE will skip over any tables that the calling user does not have permission to analyze.
Foreign tables are analyzed only when explicitly selected. Not all foreign data wrappers support ANALYZE. If the table's wrapper does not support ANALYZE, the command prints a warning and does nothing.
In the default PostgreSQL configuration, the autovacuum daemon (see Section 24.1.6) takes care of automatic analyzing of tables when they are first loaded with data, and as they change throughout regular operation. When autovacuum is disabled, it is a good idea to run ANALYZE periodically, or just after making major changes in the contents of a table. Accurate statistics will help the planner to choose the most appropriate query plan, and thereby improve the speed of query processing. A common strategy for read-mostly databases is to run VACUUM and ANALYZE once a day during a low-usage time of day. (This will not be sufficient if there is heavy update activity.)
While ANALYZE is running, the search_path is temporarily changed to pg_catalog, pg_temp.
ANALYZE requires only a read lock on the target table, so it can run in parallel with other non-DDL activity on the table.
The statistics collected by ANALYZE usually include a list of some of the most common values in each column and a histogram showing the approximate data distribution in each column. One or both of these can be omitted if ANALYZE deems them uninteresting (for example, in a unique-key column, there are no common values) or if the column data type does not support the appropriate operators. There is more information about the statistics in Chapter 24.
For large tables, ANALYZE takes a random sample of the table contents, rather than examining every row. This allows even very large tables to be analyzed in a small amount of time. Note, however, that the statistics are only approximate, and will change slightly each time ANALYZE is run, even if the actual table contents did not change. This might result in small changes in the planner's estimated costs shown by EXPLAIN. In rare situations, this non-determinism will cause the planner's choices of query plans to change after ANALYZE is run. To avoid this, raise the amount of statistics collected by ANALYZE, as described below.
The extent of analysis can be controlled by adjusting the default_statistics_target configuration variable, or on a column-by-column basis by setting the per-column statistics target with ALTER TABLE ... ALTER COLUMN ... SET STATISTICS. The target value sets the maximum number of entries in the most-common-value list and the maximum number of bins in the histogram. The default target value is 100, but this can be adjusted up or down to trade off accuracy of planner estimates against the time taken for ANALYZE and the amount of space occupied in pg_statistic. In particular, setting the statistics target to zero disables collection of statistics for that column. It might be useful to do that for columns that are never used as part of the WHERE, GROUP BY, or ORDER BY clauses of queries, since the planner will have no use for statistics on such columns.
The largest statistics target among the columns being analyzed determines the number of table rows sampled to prepare the statistics. Increasing the target causes a proportional increase in the time and space needed to do ANALYZE.
One of the values estimated by ANALYZE is the number of distinct values that appear in each column. Because only a subset of the rows are examined, this estimate can sometimes be quite inaccurate, even with the largest possible statistics target. If this inaccuracy leads to bad query plans, a more accurate value can be determined manually and then installed with ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...).
If the table being analyzed has inheritance children, ANALYZE gathers two sets of statistics: one on the rows of the parent table only, and a second including rows of both the parent table and all of its children. This second set of statistics is needed when planning queries that process the inheritance tree as a whole. The autovacuum daemon, however, will only consider inserts or updates on the parent table itself when deciding whether to trigger an automatic analyze for that table. If that table is rarely inserted into or updated, the inheritance statistics will not be up to date unless you run ANALYZE manually. By default, ANALYZE will also recursively collect and update the statistics for each inheritance child table. The ONLY keyword may be used to disable this.
For partitioned tables, ANALYZE gathers statistics by sampling rows from all partitions. By default, ANALYZE will also recursively collect and update the statistics for each partition. The ONLY keyword may be used to disable this.
The autovacuum daemon does not process partitioned tables, nor does it process inheritance parents if only the children are ever modified. It is usually necessary to periodically run a manual ANALYZE to keep the statistics of the table hierarchy up to date.
If any child tables or partitions are foreign tables whose foreign data wrappers do not support ANALYZE, those tables are ignored while gathering inheritance statistics.
If the table being analyzed is completely empty, ANALYZE will not record new statistics for that table. Any existing statistics will be retained.
Each backend running ANALYZE will report its progress in the pg_stat_progress_analyze view. See Section 27.4.1 for details.
Compatibility
There is no ANALYZE statement in the SQL standard.
The following syntax was used before PostgreSQL version 11 and is still supported:
ANALYZE [ VERBOSE ] [ table_and_columns [, ...] ]
