PostgreSQL 13.1 中文入门教程 PostgreSQL oid2name

2024-02-25 开发教程 PostgreSQL 13.1 中文入门教程 匿名 2

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_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 支持的环境变量 (参见 第 33.14 节)。

环境变量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