oid2name#
Примечание
Эта страница переведена при помощи нейросети GigaChat.
oid2name производит преобразование OID и узлов файлов в каталоге данных PostgreSQL.
Краткий обзор#
oid2name [option…]
Описание#
oid2name – это утилита, которая помогает администраторам исследовать файловую структуру, используемую PostgreSQL. Чтобы использовать ее, необходимо быть знакомым с файловой структурой базы данных, которая описана в разделе «Физическое хранилище базы данных» документа «Архитектура компонентов в составе продукта».
Примечание
Название «oid2name» историческое и на самом деле довольно обманчиво, ведь чаще всего, обращаясь к нему, когда интересует номер узла файла таблицы (представляющий собой имя файла, видимое в каталогах баз данных). Убедитесь, что четко различаете идентификатор объекта таблицы и узел файла таблицы!
oid2name подключается к целевой базе данных и извлекает информацию об идентификаторе объекта, узле файла и/или имени таблицы. Также можно отобразить идентификаторы объектов базы данных или идентификаторы объектов табличного пространства.
Параметры#
oid2name принимает следующие аргументы командной строки:
-f filenode
--filenode=filenode
Показать информацию о таблице с указанным filenode.
-i
--indexes
Включить индексы и последовательности в список.
-o oid
--oid=oid
Показать информацию для таблицы с OID oid.
-q
--quiet
Опустить заголовки (полезно для скриптинга).
-s
--tablespaces
Показать пространство имен OIDs.
-S
--system-objects
Включить системные объекты (те, которые находятся в information_schema, pg_toast и pg_catalog схемах).
-t tablename_pattern
--table=tablename_pattern
Показать информацию для таблицы (таблиц), соответствующих tablename_pattern.
-V
--version
Напечатать версию oid2name и выйти.
-x
--extended
Отображать более подробную информацию о каждом показанном объекте: имя табличного пространства, имя схемы и идентификатор объекта (OID).
-?
--help
Показывать справку о параметрах командной строки команды oid2name, а затем завершать работу.
oid2name также принимает параметры командной строки для параметров подключения:
-d database
--dbname=database
База данных для подключения.
-h host
--host=host
Хост сервера базы данных.
-H host
Хост сервера базы данных. Использование этого параметра считается устаревшим начиная с версии PostgreSQL 12.
-p port
--port=port
Порт сервера базы данных.
-U username
--username=username
Имя пользователя для подключения.
Чтобы отобразить конкретные таблицы, выберите, какие таблицы показывать, используя -o, -f и/или -t. -o принимает OID, -f принимает узел файла, а -t принимает имя таблицы (фактически, это шаблон LIKE, поэтому можно использовать такие вещи, как foo%). Можно использовать столько опций, сколько хотите, список будет включать объекты, соответствующие любой из опций. Но обратите внимание, что эти параметры могут отображать только объекты в базе данных, заданные параметром -d.
Если не предоставлен ни один из параметров -o, -f или -t, но указан параметр -d, будут выведены все таблицы в базе данных с именем, заданным в -d. В этом режиме опции -S и -i управляют тем, что будет перечислено.
Если не задан -d, то выводится список OID базы данных. В качестве альтернативы можно указать -s, чтобы получить список табличных пространств.
Переменные окружения#
PGHOST
PGPORT
PGUSER
Параметры подключения по умолчанию.
Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные окружения, поддерживаемые libpq.
Переменная окружения PG_COLOR указывает, следует ли использовать цвет в диагностических сообщениях. Возможные значения: always, auto и never.
Примечания#
oid2name требует работающего сервера баз данных с неповрежденными системными каталогами. Поэтому он имеет ограниченное применение для восстановления после катастрофического повреждения базы данных.
Примеры#
$ # what's in this database server, anyway?
$ oid2name
All databases:
Oid Database Name Tablespace
----------------------------------
17228 alvherre pg_default
17255 regression pg_default
17227 template0 pg_default
1 template1 pg_default
$ oid2name -s
All tablespaces:
Oid Tablespace Name
-------------------------
1663 pg_default
1664 pg_global
155151 fastdisk
155152 bigdisk
$ # OK, let's look into database alvherre
$ cd $PGDATA/base/17228
$ # get top 10 db objects in the default tablespace, ordered by size
$ ls -lS * | head -10
-rw------- 1 alvherre alvherre 136536064 sep 14 09:51 155173
-rw------- 1 alvherre alvherre 17965056 sep 14 09:51 1155291
-rw------- 1 alvherre alvherre 1204224 sep 14 09:51 16717
-rw------- 1 alvherre alvherre 581632 sep 6 17:51 1255
-rw------- 1 alvherre alvherre 237568 sep 14 09:50 16674
-rw------- 1 alvherre alvherre 212992 sep 14 09:51 1249
-rw------- 1 alvherre alvherre 204800 sep 14 09:51 16684
-rw------- 1 alvherre alvherre 196608 sep 14 09:50 16700
-rw------- 1 alvherre alvherre 163840 sep 14 09:50 16699
-rw------- 1 alvherre alvherre 122880 sep 6 17:51 16751
$ # I wonder what file 155173 is ...
$ oid2name -d alvherre -f 155173
From database "alvherre":
Filenode Table Name
----------------------
155173 accounts
$ # you can ask for more than one object
$ oid2name -d alvherre -f 155173 -f 1155291
From database "alvherre":
Filenode Table Name
-------------------------
155173 accounts
1155291 accounts_pkey
$ # you can mix the options, and get more details with -x
$ oid2name -d alvherre -t accounts -f 1155291 -x
From database "alvherre":
Filenode Table Name Oid Schema Tablespace
------------------------------------------------------
155173 accounts 155173 public pg_default
1155291 accounts_pkey 1155291 public pg_default
$ # show disk space for every db object
$ du [0-9]* |
> while read SIZE FILENODE
> do
> echo "$SIZE `oid2name -q -d alvherre -i -f $FILENODE`"
> done
16 1155287 branches_pkey
16 1155289 tellers_pkey
17561 1155291 accounts_pkey
...
$ # same, but sort by size
$ du [0-9]* | sort -rn | while read SIZE FN
> do
> echo "$SIZE `oid2name -q -d alvherre -f $FN`"
> done
133466 155173 accounts
17561 1155291 accounts_pkey
1177 16717 pg_proc_proname_args_nsp_index
...
$ # If you want to see what's in tablespaces, use the pg_tblspc directory
$ cd $PGDATA/pg_tblspc
$ oid2name -s
All tablespaces:
Oid Tablespace Name
-------------------------
1663 pg_default
1664 pg_global
155151 fastdisk
155152 bigdisk
$ # what databases have objects in tablespace "fastdisk"?
$ ls -d 155151/*
155151/17228/ 155151/PG_VERSION
$ # Oh, what was database 17228 again?
$ oid2name
All databases:
Oid Database Name Tablespace
----------------------------------
17228 alvherre pg_default
17255 regression pg_default
17227 template0 pg_default
1 template1 pg_default
$ # Let's see what objects does this database have in the tablespace.
$ cd 155151/17228
$ ls -l
total 0
-rw------- 1 postgres postgres 0 sep 13 23:20 155156
$ # OK, this is a pretty small table ... but which one is it?
$ oid2name -d alvherre -f 155156
From database "alvherre":
Filenode Table Name
----------------------
155156 foo