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

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

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

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

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

Тип столбца

Описание

pid integer

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

datid oid

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

datname name

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

relid oid

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

phase text

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

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

delay_time double precision

Общее время ожидания, вызванного задержками на основе стоимости (см. Подраздел 18.10.2), в миллисекундах (если включён параметр track_cost_delay_timing, в противном случае 0).


Таблица 27.47. Фазы 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 обрабатывает секционированную таблицу без ключевого слова ONLY, все её секции также рекурсивно анализируются. В этом случае сначала сообщается о ходе выполнения ANALYZE для родительской таблицы, которое сопровождается сбором наследуемой статистики, а затем о ходе обработки каждой её секции.

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

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

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

Тип столбца

Описание

pid integer

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

datid oid

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

datname name

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

relid oid

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

command text

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

phase text

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

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.


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

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

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

Таблица 27.50. Представление 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.

tuples_skipped bigint

Количество кортежей, пропущенных из-за того, что они содержат неверные данные. Этот счётчик увеличивается только тогда, когда для параметра ON_ERROR указано значение, отличное от stop.


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

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

Таблица 27.51. Представление 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

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

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, когда выполняется REINDEX или если индекс не секционирован.


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

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

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

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

Тип столбца

Описание

pid integer

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

datid oid

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

datname name

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

relid oid

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

phase text

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

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_tuple_bytes 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.

delay_time double precision

Общее время ожидания, вызванное задержками на основе стоимости (см. Подразделе 18.10.2), в миллисекундах (если включён параметр track_cost_delay_timing, в противном случае 0). Также учитывается время ожидания связанных параллельных рабочих процессов. Параллельные рабочие процессы передают своё время ожидания не чаще, чем раз в секунду, поэтому выводимое значение может быть устаревшим.


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

FAQ