oid2name — 在 PostgreSQL 数据目录中解析 OID 和文件节点
oid2name [选项...]
oid2name 是一个实用程序，可帮助管理员检查 PostgreSQL 使用的文件结构。要使用它，您需要熟悉数据库文件结构，这在第 65 章中进行了描述。
名称 “oid2name” 是历史遗留的，实际上有点误导，因为大多数时候当您使用它时，您实际上会关心表的节点号（这些是在数据库目录中可见的文件名）。请确保您了解表 OID 和表节点之间的区别！
oid2name 连接到目标数据库并提取 OID、节点和/或表名称信息。您还可以让它显示数据库 OID 或表空间 OID。
oid2name 接受以下命令行参数
-f 节点--filenode=节点显示节点为 节点 的表的相关信息。
-i--indexes在列表中包含索引和序列。
-o oid--oid=oid显示 OID 为 oid 的表的相关信息。
-q--quiet省略标题（对于脚本编写很有用）。
-s--tablespaces显示表空间 OID。
-S--system-objects包含系统对象（那些在 information_schema、pg_toast 和 pg_catalog 模式中的对象）。
-t 表名模式--table=表名模式显示与 表名模式 匹配的表的信息。
-V--version打印 oid2name 版本并退出。
-x--extended显示有关每个显示对象的更多信息：表空间名称、模式名称和 OID。
-?--help显示有关 oid2name 命令行参数的帮助，并退出。
oid2name 还接受以下用于连接参数的命令行参数
-d 数据库--dbname=数据库要连接的数据库。
-h 主机--host=主机数据库服务器的主机。
-H 主机数据库服务器的主机。从 PostgreSQL 12 开始，不建议使用此参数。
-p 端口--port=端口数据库服务器的端口。
-U 用户名--username=用户名要连接的用户名称。
要显示特定表，请使用 -o、-f 和/或 -t 选择要显示的表。-o 接受 OID，-f 接受节点，-t 接受表名（实际上，它是一个 LIKE 模式，因此您可以使用诸如 foo% 之类的内容）。您可以根据需要使用这些选项中的任意多个，并且列表将包含与任何选项匹配的所有对象。但请注意，这些选项只能显示由 -d 给出的数据库中的对象。
如果您没有给出 -o、-f 或 -t 中的任何一个，但确实给出了 -d，它将列出由 -d 指定的数据库中的所有表。在此模式下，-S 和 -i 选项控制要列出的内容。
如果您也没有给出 -d，它将显示数据库 OID 的列表。或者，您可以给出 -s 以获取表空间列表。
PGHOSTPGPORTPGUSER默认连接参数。
此实用程序与大多数其他 PostgreSQL 实用程序一样，也使用 libpq 支持的环境变量（请参见第 32.15 节）。
环境变量 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
$ # What file is 155173?
$ 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
B. Palmer <[email protected]>
如果您在文档中看到任何不正确的内容、与您对特定功能的体验不符的内容或需要进一步澄清的内容，请使用此表单报告文档问题。