PostgreSQL oid2name
oid2name — 解析一个PostgreSQL数据目录中的 OID 和文件结点。
大纲
oid2name
[option
...]
描述
oid2name是一个帮助管理员检查被 PostgreSQL 使用的文件结构的工具程序。要使用它,你需要熟悉数据库文件结构(见第 68 章)。
注意
名称“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_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 支持的环境变量 (参见 第 33.14 节)。
环境变量PG_COLOR
指定是否在诊断消息中使用颜色。 可能的值是always
、auto
和 never
。
注解
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