↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3
历史版本PostgreSQL 8.4 已于 2014 年 7 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

F.19. oid2name #

oid2name 是一个帮助管理员检查 PostgreSQL 所用文件结构的实用程序。要使用它,你需要熟悉数据库文件结构,这在 第 53 章 中有说明。

注意

“oid2name” 这个名称是历史遗留,实际上颇具误导性,因为多数时候你真正关心的是表的 filenode 编号(也就是数据库目录中可见的文件名)。务必理解表 OID 与表 filenode 之间的区别。

F.19.1. 概述

oid2name 连接到目标数据库,并提取 OID、filenode 和/或表名信息。 你也可以让它显示数据库 OID 或表空间 OID。该程序受大量命令行开关控制,见表 F.13。

要显示特定的表,可使用 -o、-f 和/或 -t 选择要显示哪些表。 -o 接受一个 OID, -f 接受一个 filenode, 而 -t 接受一个表名(实际上它是一个 LIKE 模式,因此你可以使用诸如 foo% 之类的写法)。 这些开关可以使用任意多个,列表将包括由其中任一开关匹配的所有对象。 但请注意,这些开关只能显示由 -d 给出的数据库中的对象。

如果没有给出 -o、-f 或 -t 中的任何一个, 但给出了 -d,那么它将列出 -d 指定数据库中的所有表。在这种模式下, -S 和 -i 开关控制要列出哪些对象。

如果连 -d 也没有给出,它将显示数据库 OID 列表。 另外,你也可以给出 -s 来获取表空间列表。

表 F.13. oid2name 开关

开关 描述
-o oid 显示 OID 为 oid 的表的信息
-f filenode 显示文件节点为 filenode 的表的信息
-t tablename_pattern 显示与 tablename_pattern 匹配的表的信息
-s 显示表空间 OID
-S 包含系统对象(即位于 information_schema、pg_toast 和 pg_catalog 模式中的对象)
-i 在列表中包含索引和序列
-x 显示每个对象的更多信息:表空间名、模式名和 OID
-q 省略表头(对编写脚本有用)
-d database 要连接的数据库
-H host 数据库服务器的主机
-p port 数据库服务器的端口
-U username 用于连接的用户名

F.19.2. 示例

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

F.19.3. 限制

oid2name要求数据库服务器正在运行,且系统目录未损坏。 因此,它对于从数据库灾难性损坏中恢复的帮助非常有限。

F.19.4. 作者

B. Palmer

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。