oid2name

PostgreSQL 14.5文書
		G.1. クライアントアプリケーション
前へ	上へ	oid2name	次へ

oid2name — OIDとPostgreSQLデータディレクトリ内のファイルノードを解決する

概要

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: テーブル空間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は破損のないシステムカタログで実行中のデータベースサーバが必要です。したがって、破滅的にデータベースが破損したような状況からの復旧には限定的にしか役に立ちません。

例


$ # とにかく、このデータベースサーバの中には何があるのだろう
$ 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


$ # さて、データベースalvherreの中を見てみよう
$ cd $PGDATA/base/17228


$ # デフォルトテーブル空間のデータベースオブジェクトを大きさの順に上位10個取得
$ 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


$ # 2つ以上のオブジェクトについて問い合わせることもできる
$ 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


$ # 分かった、これはかなり小さなテーブルだ、、、でも何のテーブルだろう
$ oid2name -d alvherre -f 155156
From database "alvherre":
  Filenode  Table Name
----------------------
    155156         foo

作者

B. Palmer <bpalmer@crimelabs.net>