Структура каталога данных

В каталоге, указанном в Data directory, находится подкаталог для текущего кластера. Для ADPG v16.x.x это adpg16. Его содержимое приведено в таблице ниже.

Для каждой базы данных существует свой подкаталог в каталоге base, названный в соответствии с OID базы данных. OID можно получить из системного каталога pg_database:

Для просмотра содержимого каталога base выполните следующую команду:

Результат:

В подкаталоге базы данных хранятся все её файлы, включая системные каталоги.

Стандартные отношения, такие как таблицы или индексы, хранятся в отдельном файле. Эти файлы именуются по значению filenode таблицы или индекса, которое содержится в столбце relfilenode системного каталога pg_class. В качестве примера можно вывести имя отношения и значение filenode для первых пяти записей из pg_class:

Поскольку перечисленные отношения принадлежат базе данных postgres, соответствующие файлы с именами 16390, 16391, 16396, 16398, 16399 находятся в каталоге /pg_data1/adpg16/base/5.

Для временных отношений имя файла создается как t<backend>_<filenode>, где <backend> — номер backend-процесса, создавшего файл, а <filenode> — значение filenode. Например, t8_16433.

В дополнение к основному файлу каждая таблица или индекс имеет карту свободного пространства (free space map), которая хранит информацию о свободном пространстве в отношении. Карта свободного пространства имеет такое же имя файла, как и соответствующее отношение с добавлением суффикса _fsm. Например, 16432_fsm.

Таблицы также имеют карты видимости (visibility maps) для отслеживания страниц, которые не содержат "мертвых" кортежей. Карта видимости имеет такое же имя файла, как и соответствующая таблица с добавлением суффикса _vm. Например, 16432_vm.

Нежурналируемые таблицы и индексы имеют дополнительный файл, известный как слой инициализации (initialization fork), который именуется с суффиксом _init.

Обратите внимание, что хотя filenode таблицы часто совпадает с её OID, это не всегда так. Некоторые операции, такие как TRUNCATE, REINDEX, CLUSTER и некоторые формы ALTER TABLE, могут изменять filenode, сохраняя OID.

Если таблица или индекс превышает 1 ГБ, отношение делится на сегменты с максимальным размером 1 ГБ. Имя файла первого сегмента совпадает с filenode. Последующие сегменты называются filenode.1, filenode.2 и т.д. Такое расположение позволяет избежать проблем на платформах с ограничениями на размер файла.

Для таблицы, столбцы которой могут содержать данные большого объема, создается TOAST-таблица, предназначенная для отдельного хранения больших значений. Основная таблица связывается со своей TOAST-таблицей через поле reltoastrelid системного каталога pg_class. За дополнительной информацией обратитесь к статье TOAST.

Временные файлы, необходимые для ресурсозатратных операций, создаются в base/pgsql_tmp. Имя временного файла имеет формат pgsql_tmp<PID>.<Number>, где <PID> — PID backend-процесса, <Number> служит для различия отдельных временных файлов текущего backend-процесса. Например, pgsql_tmp29522.1.

Каждое определенное пользователем табличное пространство имеет символическую ссылку в подкаталоге pg_tblspc, расположенном в каталоге данных кластера (значение по умолчанию — /pg_data1/adpg16), которая указывает на физический каталог табличного пространства — значение LOCATION, указанное в команде CREATE TABLESPACE. Эта символическая ссылка названа в соответствии с OID табличного пространства. Внутри физического каталога табличного пространства создается подкаталог с именем, которое зависит от версии ADPG/PostgreSQL, например, PG_16_202307071. В этом подкаталоге создается подкаталог для каждой базы данных, которая имеет элементы в табличном пространстве. Подкаталоги баз данных названы в соответствии с их OID. Таблицы и индексы, хранящиеся в этих каталогах, используют схему именования, описанную выше и основанную на filenode.

К табличному пространству pg_default невозможно получить доступ из pg_tblspc, но pg_default соответствует подкаталогу base, расположенному в каталоге данных кластера. Аналогично табличное пространство pg_global недоступно через pg_tblspc, но соответствует подкаталогу global.

Временные файлы создаются в подкаталоге pgsql_tmp каталога табличного пространства.

Функция pg_relation_filepath(relation regclass) возвращает путь к файлу относительно каталога данных кластера для любого отношения. Обратите внимание, что эта функция выдает имя первого сегмента, связанного с текущим отношением. Может потребоваться добавить номер сегмента и/или суффиксы _fsm, _vm, _init, чтобы получить все файлы, связанные с отношением.

Пример:

Также можно отобразить имя отношения и путь к файлу для каждого отношения из системного каталога pg_class: