28.4. Отслеживание выполнения

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

28.4.1. Отслеживание выполнения ANALYZE

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

Таблица 28.34. Представление pg_stat_progress_analyze

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

datid oid

OID базы данных, к которой подключён этот обслуживающий процесс.

datname name

Имя базы данных, к которой подключён этот обслуживающий процесс.

relid oid

OID анализируемой таблицы.

phase text

Текущая фаза обработки. См. Таблицу 28.35.

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 (извлечение строк выборки через наследование).


Таблица 28.35. Фазы 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 для родительской таблицы, которое сопровождается сбором наследуемой статистики, а затем о ходе обработки каждой её секции.

28.4.2. Отслеживание выполнения CREATE INDEX

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

Таблица 28.36. Представление pg_stat_progress_create_index

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

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

Текущая фаза создания индекса. См. Таблицу 28.37.

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

При создании индекса в секционированной таблице этот столбец содержит общее число секций, в которых создаётся индекс. Во время выполнения REINDEX значение этого поля — 0.

partitions_done bigint

При создании индекса в секционированной таблице этот столбец содержит число секций, в которых индекс уже построен. Во время выполнения REINDEX значение этого поля — 0.


Таблица 28.37. Фазы 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.

28.4.3. Отслеживание выполнения VACUUM

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

Таблица 28.38. Представление pg_stat_progress_vacuum

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

datid oid

OID базы данных, к которой подключён этот обслуживающий процесс.

datname name

Имя базы данных, к которой подключён этот обслуживающий процесс.

relid oid

OID очищаемой таблицы.

phase text

Текущая фаза очистки. См. Таблицу 28.39.

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.

num_dead_tuples bigint

Число «мёртвых» кортежей, собранных со времени последнего цикла очистки индекса.


Таблица 28.39. Фазы 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 завершит свою работу.

28.4.4. Отслеживание выполнения CLUSTER

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

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

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

datid oid

OID базы данных, к которой подключён этот обслуживающий процесс.

datname name

Имя базы данных, к которой подключён этот обслуживающий процесс.

relid oid

OID обрабатываемой таблицы.

command text

Выполняемая команда: CLUSTER или VACUUM FULL.

phase text

Текущая фаза обработки. См. Таблицу 28.41.

cluster_index_relid oid

Если таблица сканируется по индексу, это поле содержит OID данного индекса, а иначе — 0.

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.


Таблица 28.41. Фазы CLUSTER и VACUUM FULL

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

28.4.5. Отслеживание выполнение базового копирования

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

Таблица 28.42. Представление pg_stat_progress_basebackup

Тип столбца

Описание

pid integer

Идентификатор процесса-передатчика WAL.

phase text

Текущая фаза обработки. См. Таблицу 28.43.

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 (передача файлов WAL).

tablespaces_total bigint

Общее число табличных пространств, которые будут переданы.

tablespaces_streamed bigint

Число переданных табличных пространств. Этот счётчик увеличивается только в фазе streaming database files (передача файлов данных).


Таблица 28.43. Фазы базового копирования

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

28.4.6. Отслеживание выполнения COPY

Во время выполнения COPY представление pg_stat_progress_copy будет содержать по одной строке для каждого обслуживающего процесса, выполняющего эту команду. Таблицы ниже показывают, какая информация будет отслеживаться, и поясняют, как её интерпретировать.

Таблица 28.44. Представление pg_stat_progress_copy

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

datid oid

OID базы данных, к которой подключён этот обслуживающий процесс.

datname name

Имя базы данных, к которой подключён этот обслуживающий процесс.

relid oid

OID таблицы, в которой выполняется команда COPY. При копировании из запроса SELECT это поле содержит 0.

command text

Выполняемая команда: COPY FROM или COPY TO.

type text

Метод ввода/вывода, посредством которого считываются или записываются данные: FILE, PROGRAM, PIPE (для COPY FROM STDIN и COPY TO STDOUT) или CALLBACK (используется, например, во время начальной синхронизации таблицы при логической репликации).

bytes_processed bigint

Число байт, уже обработанных командой COPY.

bytes_total bigint

Размер исходного файла для команды COPY FROM в байтах. Если определить размер нельзя, это поле содержит 0.

tuples_processed bigint

Число кортежей, уже обработанных командой COPY.

tuples_excluded bigint

Количество необработанных кортежей, которые были исключены предложением WHERE команды COPY.