Отчет о ходе выполнения

примечание

Эта страница переведена при помощи нейросети GigaChat.

PostgreSQL имеет возможность сообщать о ходе выполнения определенных команд во время их выполнения. В настоящее время только команды ANALYZE, CLUSTER, CREATE INDEX, VACUUM, COPY и BASE_BACKUP (т.е. команда репликации, которую pg_basebackup выдает для создания базовой резервной копии) поддерживают отчетность о ходе работы. Это может быть расширено в будущем.

Отчет о ходе выполнения ANALYZE

Каждый раз, когда выполняется ANALYZE, представление pg_stat_progress_analyze будет содержать строку для каждого бэкенда, который в данный момент выполняет эту команду. Таблицы ниже описывают информацию, которая будет представлена, и предоставляют сведения о том, как ее интерпретировать.

Представление pg_stat_progress_analyze:

Тип столбца	Описание
pid integer	Идентификатор процесса бэкенда
datid oid	OID базы данных, к которой подключен этот бэкенд
datname name	Имя базы данных, к которой подключен этот бэкенд
relid oid	OID таблицы, которая анализируется
phase text	Текущая фаза обработки ANALYZE
sample_blks_total bigint	Общее количество блоков кучи, которые будут выборочно проверены
sample_blks_scanned bigint	Количество проверенных блоков кучи
ext_stats_total bigint	Количество расширенной статистики
ext_stats_computed bigint	Количество вычисленной расширенной статистики. Этот счетчик увеличивается только тогда, когда фаза равна computing extended statistics
child_tables_total bigint	Количество дочерних таблиц
child_tables_done bigint	Количество отсканированных дочерних таблиц. Этот счетчик увеличивается только тогда, когда фаза равна acquiring inherited sample rows
current_child_table_relid oid	OID дочерней таблицы, которая в данный момент сканируется. Это поле действительно только тогда, когда фаза находится в acquiring inherited sample rows

Фазы ANALYZE:

Фаза	Описание
initializing	Команда готовится начать сканирование кучи. Эта фаза должна быть очень краткой
acquiring sample rows	В настоящее время команда сканирует таблицу, указанную в relid, чтобы получить примерные строки
acquiring inherited sample rows	Сейчас команда сканирует дочерние таблицы для получения примерных строк. Столбцы child_tables_total, child_tables_done и current_child_table_relid содержат информацию о ходе выполнения этой фазы
computing statistics	Команда вычисляет статистику из выборочных строк, полученных во время сканирования таблицы
computing extended statistics	Команда вычисляет расширенную статистику из выборочных строк, полученных во время сканирования таблицы
finalizing analyze	Команда обновляет pg_class. Когда эта фаза будет завершена, ANALYZE закончится

Примечание

Обратите внимание, что при запуске ANALYZE на разделенной таблице анализируются также все ее разделы. В этом случае сначала сообщается о прогрессе ANALYZE для родительской таблицы, где собираются статистические данные по наследованию, а затем для каждого раздела.

Отчет о прогрессе CLUSTER

Когда выполняется команда CLUSTER или VACUUM FULL, представление pg_stat_progress_cluster будет содержать строку для каждого бэкенда, который в настоящее время выполняет одну из этих команд. Таблицы ниже описывают информацию, которая будет сообщаться, и предоставляют сведения о том, как интерпретировать эту информацию.

Таблица Представление pg_stat_progress_cluster

Тип колонки	Описание
pid integer	Идентификатор процесса бэкенда.
datid oid	OID базы данных, к которой подключен этот бэкенд.
datname name	Имя базы данных, к которой подключен этот бэкенд.
relid oid	OID таблицы, подлежащей кластеризации.
command text	Выполняемая команда. Либо CLUSTER, либо VACUUM FULL.
phase text	Текущая обрабатываемая фаза.
cluster_index_relid oid	Если таблица сканируется с использованием индекса, это OID используемого индекса; иначе — ноль.
heap_tuples_scanned bigint	Количество кортежей кучи, прошедших сканирование. Этот счетчик увеличивается только тогда, когда фаза равна seq scanning heap, index scanning heap или writing new heap.
heap_tuples_written bigint	Количество записанных кортежей кучи. Этот счетчик увеличивается только тогда, когда фаза равна seq scanning heap, index scanning heap или writing new heap.
heap_blks_total bigint	Общее количество блоков кучи в таблице. Это число указывается на начало seq scanning heap.
heap_blks_scanned bigint	Количество отсканированных блоков кучи. Этот счетчик увеличивается только тогда, когда фаза равна seq scanning heap.
index_rebuild_count bigint	Количество перестроенных индексов. Этот счетчик увеличивается только тогда, когда фаза равна rebuilding index.

** Фазы CLUSTER и VACUUM FULL**

Фаза	Описание
initializing	Команда готовится начать сканирование кучи. Этот этап ожидается очень коротким.
seq scanning heap	В данный момент команда выполняет последовательное сканирование таблицы.
index scanning heap	CLUSTER в настоящее время сканирует таблицу с использованием индексного сканирования.
sorting tuples	CLUSTER в настоящий момент сортирует кортежи.
writing new heap	CLUSTER сейчас записывает новую кучу.
swapping relation files	Команда в данный момент заменяет только что созданные файлы на свои места.
rebuilding index	Команда в текущий момент перестраивает индекс.
performing final cleanup	Команда производит окончательную очистку. Когда этот этап будет завершен, завершится CLUSTER или VACUUM FULL.

Отчет о ходе выполнения CREATE INDEX

Когда CREATE INDEX или REINDEX выполняется, представление pg_stat_progress_create_index будет содержать одну строку для каждого бэкенда, который в данный момент создает индексы. В приведенных ниже таблицах описывается информация, которая будет представлена, и приводятся сведения о том, как ее интерпретировать.

Представление pg_stat_progress_create_index:

Тип столбца	Описание
pid integer	Идентификатор процесса бэкенда
datid oid	OID базы данных, к которой подключен этот бэкенд
datname name	Имя базы данных, к которой подключен этот бэкенд
relid oid	OID таблицы, для которой создается индекс
index_relid oid	OID индекса, который создается или повторно индексируется. Во время неконкурентного CREATE INDEX это равно 0
command text	Команда, которая выполняется: CREATE INDEX, CREATE INDEX CONCURRENTLY, REINDEX, или REINDEX CONCURRENTLY
phase text	Текущая фаза обработки при создании CREATE INDEX
lockers_total bigint	Общее количество замков, которые нужно ждать, если применимо
lockers_done bigint	Количество замков, за которыми уже следили
current_locker_pid bigint	Идентификатор процесса блокировки, который в данный момент ожидает обработки
blocks_total bigint	Общее количество блоков, которые должны быть обработаны в текущей фазе
blocks_done bigint	Количество блоков, уже обработанных в текущей фазе
tuples_total bigint	Общее количество кортежей, которые должны быть обработаны в текущей фазе
tuples_done bigint	Количество кортежей, уже обработанных на текущем этапе
partitions_total bigint	При создании индекса для разделенной таблицы этот столбец устанавливается на общее количество разделов, на которых должен быть создан индекс. Это поле является 0 во время REINDEX
partitions_done bigint	При создании индекса на разделенной таблице этот столбец устанавливается на количество разделов, для которых был создан индекс. Это поле установлено во время 0

Фазы CREATE INDEX:

Фаза	Описание
initializing	CREATE INDEX или REINDEX готовится создать индекс. Эта фаза должна быть очень краткой
waiting for writers before build	CREATE INDEX CONCURRENTLY или REINDEX CONCURRENTLY ожидает завершения транзакций с блокировками записи, которые потенциально могут видеть таблицу. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы lockers_total, lockers_done и current_locker_pid содержат информацию о ходе выполнения этой фазы
building index	Индекс создается методом доступа, специфичным для метода. На этом этапе методы доступа, поддерживающие отчетность о ходе работы, заполняют свои собственные данные о ходе работы, а подэтап указывается в этом столбце. Обычно blocks_total и blocks_done будут содержать данные о ходе работы, а также потенциально tuples_total и tuples_done
waiting for writers before validation	CREATE INDEX CONCURRENTLY или REINDEX CONCURRENTLY ожидает завершения транзакций с блокировками записи, которые потенциально могут записывать данные в таблицу. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы lockers_total, lockers_done и current_locker_pid содержат информацию о ходе выполнения этой фазы
index validation: scanning index	CREATE INDEX CONCURRENTLY сканирует индекс в поисках кортежей, которые необходимо проверить. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбец blocks_total (установленный на общий размер индекса) и blocks_done содержат информацию о ходе выполнения этой фазы
index validation: sorting tuples	CREATE INDEX CONCURRENTLY сортирует вывод фазы сканирования индекса
index validation: scanning table	CREATE INDEX CONCURRENTLY сканирует таблицу для проверки кортежей индекса, собранных на двух предыдущих фазах. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы blocks_total (установленные на общий размер таблицы) и blocks_done содержат информацию о ходе выполнения этой фазы
waiting for old snapshots	CREATE INDEX CONCURRENTLY или REINDEX CONCURRENTLY ожидает завершения транзакций, которые потенциально могут видеть таблицу, чтобы освободить свои снимки. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы lockers_total, lockers_done и current_locker_pid содержат информацию о ходе выполнения этой фазы
waiting for readers before marking dead	REINDEX CONCURRENTLY ожидает завершения транзакций с блокировками чтения на таблице перед тем, как пометить старый индекс как мертвый. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы lockers_total, lockers_done и current_locker_pid содержат информацию о ходе выполнения этой фазы
waiting for readers before dropping	REINDEX CONCURRENTLY ожидает завершения транзакций с блокировками чтения из таблицы перед удалением старого индекса. Эта фаза пропускается при отсутствии режима одновременного доступа. Столбцы lockers_total, lockers_done и current_locker_pid содержат информацию о ходе выполнения этой фазы

Отчет о ходе выполнения VACUUM

Всякий раз, когда VACUUM выполняется, представление pg_stat_progress_vacuum будет содержать одну строку для каждого бэкенда (включая рабочие процессы автоочистки), который в данный момент выполняет очистку. В приведенных ниже таблицах описывается информация, которая будет сообщаться, и приводятся сведения о том, как ее интерпретировать. Ход выполнения команд VACUUM FULL сообщается через pg_stat_progress_cluster, потому что оба VACUUM FULL и CLUSTER переписывают таблицу, тогда как обычная команда VACUUM только изменяет ее на месте.

Представление pg_stat_progress_vacuum:

Тип столбца	Описание
pid integer	Идентификатор процесса бэкенда
datid oid	OID базы данных, к которой подключен этот бэкенд
datname name	Имя базы данных, к которой подключен этот бэкенд
relid oid	OID таблицы, которая подвергается вакуумированию
phase text	Текущая фаза обработки VACUUM
heap_blks_total bigint	Общее количество блоков кучи в таблице. Это число сообщается с начала сканирования; блоки, добавленные позже, не будут (и нет необходимости) посещаться этим VACUUM
heap_blks_scanned bigint	Количество блоков кучи, которые были проверены. Поскольку используется карта видимости, чтобы оптимизировать сканирование, некоторые блоки будут пропущены без проверки; пропущенные блоки включены в эту общую сумму, так что это число в конечном итоге станет равным heap_blks_total при завершении вакуума. Этот счетчик увеличивается только тогда, когда фаза равна scanning heap
heap_blks_vacuumed bigint	Количество блоков кучи, которые были очищены. Если таблица не содержит индексов, этот счетчик увеличивается только тогда, когда фаза равна vacuuming heap. Блоки, содержащие мертвые кортежи, пропускаются, поэтому счетчик может иногда увеличиваться большими скачками
index_vacuum_count bigint	Количество завершенных циклов вакуумирования индекса
max_dead_tuples bigint	Количество мертвых кортежей, которые можно хранить перед выполнением цикла вакуумирования индекса, основанного на maintenance_work_mem
dead_tuple_bytes bigint	Объем данных «мертвых» кортежей, собранных со времени последнего цикла очистки индекса
num_dead_item_ids bigint	Количество идентификаторов мертвых кортежей, собранных с момента последнего цикла вакуумирования индекса
indexes_total bigint	Общее число индексов, которые будут очищены или убраны. Это число сообщается в начале фазы vacuuming indexes или cleaning up indexes
indexes_processed bigint	Число обработанных индексов. Этот счетчик увеличивается только во время фазы vacuuming indexes или cleaning up indexes

Фазы VACUUM

Фаза	Описание
initializing	VACUUM готовится начать сканирование кучи. Эта фаза ожидается очень краткой
scanning heap	VACUUM в настоящее время сканирует кучу. Он будет обрезать и дефрагментировать каждую страницу при необходимости и, возможно, выполнять замораживающую активность. Столбец heap_blks_scanned может использоваться для мониторинга хода сканирования
vacuuming indexes	VACUUM в данный момент вакуумирует индексы. Если у таблицы есть какие-либо индексы, это произойдет хотя бы один раз за вакуум после того, как куча будет полностью просканирована. Это может происходить несколько раз во время вакуума, если maintenance_work_mem (или, в случае авто-вакуумирования, autovacuum_work_mem, если установлено) недостаточно для хранения количества мертвых кортежей, которые были найдены
vacuuming heap	VACUUM в настоящее время очищает кучу. Очистка кучи отличается от сканирования кучи и происходит после каждого случая очистки индексов. Если heap_blks_scanned меньше heap_blks_total, система вернется к сканированию кучи после завершения этой фазы; в противном случае она начнет очищать индексы после завершения этой фазы
cleaning up indexes	VACUUM в данный момент занимается очисткой индексов. Это происходит после того, как куча была полностью просканирована и завершена вся очистка индексов и кучи
truncating heap	VACUUM в настоящий момент усекает кучу таким образом, чтобы возвращать пустые страницы в конце отношения операционной системе. Это происходит после очистки индексов
performing final cleanup	VACUUM выполняет окончательную очистку. В течение этого этапа VACUUM будет очищать карту свободного пространства, обновлять статистику в pg_class и сообщать статистику в систему кумулятивной статистики. Когда эта фаза завершится, VACUUM закончится

Отчет о ходе выполнения базового резервного копирования

Всякий раз, когда приложение, такое как pg_basebackup, создает базовое резервное копирование, представление pg_stat_progress_basebackup будет содержать строку для каждого процесса отправителя WAL, который в данный момент выполняет команду репликации BASE_BACKUP и передает потоковое резервное копирование. В приведенных ниже таблицах описывается информация, которая будет сообщаться, а также приводятся сведения о том, как ее интерпретировать.

Представление pg_stat_progress_basebackup:

Тип столбца	Описание
pid integer	Идентификатор процесса отправителя WAL
phase text	Текущая фаза обработки
backup_total bigint	Общее количество данных, которые будут переданы потоком. Это оценивается и сообщается в начале фазы streaming database files. Обратите внимание, что это всего лишь приблизительное значение, поскольку база данных может измениться во время фазы streaming database files и журнал WAL может быть включен в резервную копию позже. Это всегда то же самое значение, что и backup_streamed после того, как объем переданных данных превышает оцениваемый общий размер. Если оценка отключена в pg_basebackup (т.е., указан параметр --no-estimate-size), это NULL
backup_streamed bigint	Количество переданных данных. Этот счетчик увеличивается только тогда, когда фаза равна streaming database files или transferring wal files
tablespaces_total bigint	Общее количество табличных пространств, которые будут передаваться потоком
tablespaces_streamed bigint	Количество табличных пространств, переданных потоком. Этот счетчик увеличивается только тогда, когда фаза находится в streaming database files

Фазы базового резервного копирования

Фаза	Описание
initializing	Процесс отправителя WAL готовится начать резервное копирование. Эта фаза должна быть очень краткой
waiting for checkpoint to finish	В данный момент процесс отправителя WAL выполняет pg_backup_start для подготовки к созданию базовой резервной копии и ожидает завершения контрольной точки начала резервного копирования
estimating backup size	Процесс отправителя WAL в настоящее время оценивает общее количество файлов базы данных, которые будут переданы в виде базовой резервной копии
streaming database files	Процесс отправителя WAL в настоящее время передает файлы базы данных в качестве базовой резервной копии
waiting for wal archiving to finish	Процесс отправителя WAL в данный момент выполняет pg_backup_stop для завершения резервного копирования и ожидает успешного архивирования всех файлов WAL, необходимых для базовой резервной копии. Если указано либо --wal-method=none, либо --wal-method=stream в pg_basebackup, резервное копирование завершится после завершения этой фазы
transferring wal files	Процесс отправителя WAL в настоящий момент передает все журналы WAL, созданные во время резервного копирования. Эта фаза происходит после фазы waiting for wal archiving to finish, если указан --wal-method=fetch в pg_basebackup. Резервное копирование будет завершено при завершении данной фазы