oid2name

oid2name — 解析一个PostgreSQL数据目录中的 OID 和文件结点。

大纲

oid2name [option...]

描述

oid2name是一个帮助管理员检查被 PostgreSQL 使用的文件结构的工具程序。要使用它,你需要熟悉数据库文件结构(见第 70 章)。

注意

名称oid2name是有历史原因的,它确实有些误导性,因为在你使用它的大部分时间里,你实际关心的是表的文件结点编号(在数据目录中是可见的文件名)。请确定你理解表 OID 和表文件结点之间的区别!

oid2name连接到一个目标数据库并且抽取 OID、文件节点或者表名信息。你也可以让它显示数据库 OID 或表空间 OID。

选项

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_toastpg_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指定是否在诊断消息中使用颜色。 可能的值是alwaysautonever

注解

oid2name要求一个运行着的数据库服务器并且其系统目录没有损坏。因此它对于数据库损坏的情况用处有限。

例子

$ # 在这个数据库服务器中到底有什么?
$ 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,让我们看看数据库 alvherre 里面
$ cd $PGDATA/base/17228

$ # 得到默认表空间中前十个数据库对象,按尺寸排序
$ 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

$ # 我好奇文件 155173 是 ...
$ oid2name -d alvherre -f 155173
From database "alvherre":
  Filenode  Table Name
----------------------
    155173    accounts

$ # 你可以请求多于一个对象
$ oid2name -d alvherre -f 155173 -f 1155291
From database "alvherre":
  Filenode     Table Name
-------------------------
    155173       accounts
   1155291  accounts_pkey

$ # 你可以混合选项,并且用 -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

$ # 为每个数据库对象显示磁盘空间
$ 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
...

$ # 相同,但是按尺寸排序
$ 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
...

$ # 如果你想看看表空间里有什么,使用 pg_tblspc 目录
$ cd $PGDATA/pg_tblspc
$ oid2name -s
All tablespaces:
     Oid  Tablespace Name
-------------------------
    1663       pg_default
    1664        pg_global
  155151         fastdisk
  155152          bigdisk

$ # 哪些数据库在表空间 "fastdisk" 中有对象?
$ ls -d 155151/*
155151/17228/  155151/PG_VERSION

$ # 噢,什么是数据库 17228 ?
$ oid2name
All databases:
    Oid  Database Name  Tablespace
----------------------------------
  17228       alvherre  pg_default
  17255     regression  pg_default
  17227      template0  pg_default
      1      template1  pg_default

$ # 让我们看这个数据库在该表空间中有哪些对象。
$ cd 155151/17228
$ ls -l
total 0
-rw-------  1 postgres postgres 0 sep 13 23:20 155156

$ # OK,这是个很小的表,但是哪一个是它?
$ oid2name -d alvherre -f 155156
From database "alvherre":
  Filenode  Table Name
----------------------
    155156         foo

作者

B. Palmer