PostgreSQL 教程

Appearance

oid2name ​

oid2name — 解析PostgreSQL数据目录中的 OID 和文件节点

概要 ​

oid2name[选项...]

说明 ​

oid2name是一个实用程序，可帮助管理员检查 PostgreSQL 使用的文件结构。要使用它，您需要熟悉数据库文件结构，该结构在第 73 章中进行了描述。

注意

名称“oid2name”是历史性的，实际上具有相当大的误导性，因为在大多数情况下，当您使用它时，您实际上关注的是表的 filenode 编号（这是在数据库目录中可见的文件名）。务必了解表 OID 和表 filenode 之间的区别！

oid2name连接到目标数据库并提取 OID、filenode 和/或表名称信息。您还可以让它显示数据库 OID 或表空间 OID。

选项 ​

oid2name接受以下命令行参数

-f filenode
--filenode=filenode

显示 filenode 为 filenode 的表的详细信息。

-i
--indexes

在列表中包含索引和序列。

-o oid
--oid=oid

显示 OID 为 oid 的表的详细信息。

-q
--quiet

省略标题（对脚本编写很有用）。

-s
--tablespaces

显示表空间 OID。

-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支持的环境变量（请参阅第 34.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

$ # 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

作者 ​

B. Palmer<[[email protected]](/cdn-cgi/l/email-protection#472537262b2a22350724352e2a222b26253469292233)>