PostgreSQLの内部構造を読む:データベースクラスタ、データベース、テーブル
Reading the internals of Postgres: Database cluster, databases, and tables (buraksen.dev)
要約
この記事は、PostgreSQLの内部構造、特にデータベースクラスタ、データベース、テーブルの論理的および物理的構造について詳しく解説しています。各オブジェクトがどのようにOidによって識別され、システムカタログに保存されるか、またデータがファイルシステム上でどのように配置されるかを具体例と共に説明しています。読者がPostgreSQLの動作原理をより深く理解するための手助けとなるでしょう。
全文翻訳
Postgresの内部を読む:データベースクラスタ、データベース、テーブル
2026年6月28日 13分読了
このページについて▾
Postgresの内部構造を調べているのですが、その過程で、読んだ内容を記録して自分に責任を持たせ、理解を深めるためにノートにまとめるのが良いと考えました。この素晴らしい参考資料とPostgresに関する彼の業績に感謝します、Hironobu Suzukiさん。こちらがソースリンクです https://www.interdb.jp/pg/index.html。
データベースクラスタの論理構造#
PostgreSQLの文脈では、データベースクラスタはデータベースサーバーの集まりではありません(SQL標準ではカタログクラスタという用語を使用します)。これは、単一のPostgreSQLインスタンスによって管理されるデータベースのグループを意味します。辞書的な意味ではおそらく正しい定義ですが、通常、データベースクラスタという言葉を聞くと、単一のシステムとして機能する複数のノード/インスタンスを想定するでしょう。
データベースとは、テーブル、インデックス、ビューなどのデータベースオブジェクトの集まりです。PostgreSQLでは、データベースもデータベースオブジェクトであり、Oid(符号なし整数オブジェクト識別子)によって表されます。
SELECT oid, datname FROM pg_database ORDER BY oid;
| oid | datname |
|---|---|
| 1 | template1 |
| 4 | template0 |
| 5 | postgres |
(3行)
組み込みオブジェクト(このクエリではデータベース)は、ハードコードされた低い値を持っています。他のユーザー作成のテーブル/オブジェクトは、16384からOIDが割り当てられ始めます(OID 1〜16383は予約済みまたは初期オブジェクトで使用されます)。
これらのオブジェクトとその関連情報は、PostgreSQL内の通常のテーブルであるシステムカタログに格納されます。例をいくつか挙げます:
| テーブル | 説明 |
|---|---|
| pg_class | テーブルやテーブルに類似した他のオブジェクト(ビュー、インデックス、TOASTテーブルなど) |
| pg_database | 利用可能なデータベースに関する情報を格納する |
| pg_index | インデックス情報 |
| ... | ... |
カタログに関する雑学:
pg_databaseはクラスタ内のすべてのデータベースで共有されます(クラスタごとに1つのテーブル)が、ほとんどのシステムカタログはデータベースごとに作成されます。pg_classはインデックスを格納し、pg_indexカタログも存在します。その理由は、pg_classが汎用的なリレーショナル情報用であり、pg_indexやその他の関連カタログは独自のカスタムスキーマを持っているからです。これにより、関心の分離が促進され、将来的にpg_class2のようなテーブル(極端な例ですが、有名なmerchants2テーブルを思い出させます https://jimmyhmiller.com/ugliest-beautiful-codebase)が作成されるのを防ぐことができます。
前述のように、これらは通常のテーブルであり、クエリを実行できます(自己責任で!)。タイプ、関数、演算子などの多くの組み込みオブジェクトはこれらのテーブルに格納されており、ユーザー定義のものも同様に追加されます。
新しい行がカタログテーブルに追加されると、これらのOIDは自動的に作成されます。例えば、拡張機能(例: pgvector)を登録する際、pg_extension テーブルに自動生成されたOIDを持つpgvectorが追加されます。この動作は、以前はユーザー定義テーブルでも同様でした。時系列の履歴は以下の通りです:
PG <= 8.0: すべてのテーブル行はOID付きで作成されました。8.1 <= PG < 12: 自動OID生成はオプトイン機能でした。有効にするには、ユーザーはCREATE TABLE foo (...) WITH OIDS;でテーブルを作成するか、GUCdefault_with_oidsを有効にする必要がありました。PG >= 12: この機能は完全に削除されました。
データベースクラスタの物理構造#
Postgresクラスタは、すべてデータディレクトリに格納されます。そのパスは PGDATA 環境変数によって設定されます。一般的なデフォルトの場所は /var/lib/pgsql/data や /var/lib/postgresql/<version>/main です。
initdb はこのディレクトリの設定と作成を担当し、Postgresインストーラーによって自動化されます。brew install postgresql@18 を呼び出すと、postgres@18.rb は、Postgres自体がインストールされた後、post-installメソッドで以下の行を実行します:
system bin/"initdb", "--locale=en_US.UTF-8", "-E", "UTF-8", postgresql_datadir unless pg_version_exists?
他のPostgresインストール方法(WindowsのEDB、apt/debなど)でも同様のロジックが実装されています。
$PGDATA の中には多くのサブディレクトリがあります:
$PGDATA/
├── base/ # データベースごとのサブディレクトリ
│ └── {OID}/ # ファイルとしてのテーブルとインデックス(relfilenode)
├── global/ # クラスタ全体のカタログ(例: pg_class)
├── pg_wal/ # WALセグメントファイル
├── pg_xact/ # トランザクションコミットステータス(clog)
├── pg_tblspc/ # 外部テーブルスペースへのシンボリックリンク
├── PG_VERSION # メジャーバージョン番号
├── postgresql.conf # メインサーバー設定
└── ... # 15以上
完全なリストは https://www.postgresql.org/docs/current/storage-file-layout.html にあります。サブディレクトリの変更は非常にまれなようです。こちらのテーブル は、PG9とPG10におけるいくつかの命名変更と追加を示しています。Postgresのソースコードも確認したところ、current_logfiles サブディレクトリがPG10リリースで追加されたことがわかりました。これは 19dc233 で追加され、PG10以降に含まれています:
git tag --contains 19dc233c32f | grep -E '^REL' | sort -V | head
REL_10_0
REL_10_1
REL_10_2
...
データベースサブディレクトリレイアウト#
前述のように、各データベースは base/{OID} という名前のサブディレクトリを base ディレクトリ内に持ちます。
テーブルとインデックスは、サイズが1GB未満の場合、データベースサブディレクトリ内の単一ファイルに格納されます。OIDと同様に、物理ファイルは relfilenode によって識別され、この情報はテーブルおよび/またはインデックスの pg_class 行に格納されます。
これらのレイアウトを少し探ってみましょう。私はMacを使用しています。brew install postgresql@18 でPostgreSQL 18をインストールし、サービスとして実行しました。次に、ターミナルで psql -d postgres で接続します。
SHOW data_directory;
| data_directory |
|---|
| /opt/homebrew/var/postgresql@18 |
(1行)
前述のように、データディレクトリのパスは /opt/homebrew/var/postgresql@{VERSION} です。
次に shop データベースを作成して調べてみましょう。
CREATE DATABASE shop;
SELECT oid, datname FROM pg_database WHERE datname = 'shop';
CREATE DATABASE
| oid | datname |
|---|---|
| 16384 | shop |
(1行)
そのOIDを持つ新しいディレクトリがディスク上に作成されました:
ls /opt/homebrew/var/postgresql@18/base/
1
16384
4
5
驚くべきことに、shop ディレクトリは空ではありません。その理由は、CREATE DATABASE コマンドが既存のデータベースをコピーしてデータベースを作成するためであり、template1 がそのデフォルトのソースデータベースだからです。テンプレートに関する追加の詳細は公式ドキュメントにあります。
ls /opt/homebrew/var/postgresql@18/base/16384 | head
112
113
1247
1247_fsm
1247_vm
1249
1249_fsm
1249_vm
1255
1255_fsm
基本的なテーブルを作成します:
\c shop
CREATE TABLE orders (
id bigserial PRIMARY KEY,
customer_id bigint NOT NULL,
total_cents bigint NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
このテーブルには、それ自体と主キー用のインデックスのOIDが割り当てられます。pg_class をクエリしてそれらを確認しましょう:
SELECT oid, relname, relfilenode, relkind
FROM pg_class
WHERE relname IN ('orders', 'orders_pkey');
| oid | relname | relfilenode | relkind |
|---|---|---|---|
| 16386 | orders | 16386 | r |
| 16395 | orders_pkey | 16395 | i |
(2行)
ご覧の通り、relfilenode(物理場所の識別子)とOIDは同一です。パスを計算するための組み込み関数 pg_relation_filepath を使用できます:
SELECT pg_relation_filepath('orders'),
pg_relation_filepath('orders_pkey');
| pg_relation_filepath | pg_relation_filepath |
|---|---|
| base/16384/16386 | base/16384/16395 |
(1行)
テーブルとインデックスのファイルは base/{database_oid}/{table|index_relfilenode} に格納されます。いくつかの行を挿入し、VACUUM をトリガーします:
INSERT INTO orders (customer_id, total_cents)
SELECT (random() * 1000)::bigint, (random() * 100000)::bigint
FROM generate_series(1, 1000);
VACUUM orders;
INSERT 0 1000
VACUUM
VACUUM は主にストレージを回収するために使用されます。その詳細はドキュメントで確認でき、将来の投稿で詳しく説明します。結果のファイルは以下の通りです:
ls -l /opt/homebrew/var/postgresql@18/base/16384/{16386*,16395}
-rw-------@ 1 burak admin 65536 Jun 15 10:43 .../base/16384/16386
-rw-------@ 1 burak admin 24576 Jun 15 10:43 .../base/16384/16386_fsm
-rw-------@ 1 burak admin 8192 Jun 15 10:43 .../base/16384/16386_vm
-rw-------@ 1 burak admin 40960 Jun 15 10:43 .../base/16384/16395
私たちのテーブルでは、16386 がメインのリレーションデータであり、16386_fsm と 16386_vm はそのフォークです。これらは補助ファイルと呼ばれ、テーブルのページ内の空き領域(FSM)と各ページの可視性ステータス(VM)を追跡するために使用されます。さて、OID == relfilenode が必ずしも成り立たないことを示すために、VACUUM FULL をトリガーします。これは(簡略化すると)以下のことを行います:
- テーブルに対する排他ロックを取得する
- 新しいファイル(新しい
relfilenode)に行をコピーする - 新しい
relfilenodeへのポインタをスワップしてコミットする
VACUUM FULL orders;
SELECT oid, relname, relfilenode
FROM pg_class
WHERE relname IN ('orders', 'orders_pkey');
SELECT pg_relation_filepath('orders');
VACUUM
| oid | relname | relfilenode |
|---|---|---|
| 16386 | orders | 16397 |
| 16395 | orders_pkey | 16400 |
(2行)
| pg_relation_filepath |
|---|
| base/16384/16397 |
(1行)
VACUUM によるリライトは relfilenode を更新し、最新の状態ではOIDと一致しなくなりました。
テーブルスペース#
Postgresはテーブルスペースもサポートしています。テーブルスペースを使用すると、ユーザーはデータベースファイルを格納/使用するための他のディレクトリを指定できます。これにより、以下のことが可能になります:
- Postgresが最初に設定されたパーティション/ボリュームを拡張する。
- アクセス頻度の高いインデックスを高速ディスクに配置し、コールドテーブルを低速なディスクに配置する。
base/ および global/ ディレクトリについて説明しました。pg_default は通常のデータベースオブジェクトのデフォルトのテーブルスペースであり、そのパスは $PGDATA/base です。一方、pg_global はクラスタ全体のオブジェクトのテーブルスペースです。
mkdir -p /Users/burak/pg-tblspc-extra ディレクトリを作成し、それをテーブルスペースとして追加してみましょう。
CREATE TABLESPACE extra_space LOCATION '/Users/burak/pg-tblspc-extra';
SELECT oid, spcname FROM pg_tablespace WHERE spcname = 'extra_space';
CREATE TABLESPACE
| oid | spcname |
|---|---|
| 16401 | extra_space |
(1行)
予想通り、私たちのテーブルスペースもOIDを持ち、それは 16401 です。次に、このテーブルスペースの実際のパスではなく、Postgresはファイルパス間にシンボリックリンクを作成します。
ls -la /opt/homebrew/var/postgresql@18/pg_tblspc/
lrwx------@ 1 burak admin 28 Jun 20 15:56 16401 -> /Users/burak/pg-tblspc-extra
テーブルスペースを作成する際、Postgresは symlink("/Users/burak/pg-tblspc-extra","$PGDATA/pg_tblspc/16401") を実行します。Postgresは、探しているファイルが base/、global/、または pg_tblspc/ にシンボリックリンクされているかどうかをどのように知るのでしょうか?内部的には、以下のマッピングがあります:
ここで spcOid はテーブルスペースのOIDです。PG_xx_yyy、つまり PG_{major version}_{catalog version} に気づいたかもしれません。私のローカルセットアップでは、それは以下のようになります:
ls -la /Users/burak/pg-tblspc-extra/
drwx------@ 2 burak staff 64 Jun 20 15:56 PG_18_202506291
このテーブルスペースにインデックスを持つテーブルを作成し、それらのパスを確認します:
\c shop
CREATE TABLE archived_orders (LIKE orders INCLUDING ALL)
TABLESPACE extra_space;
SELECT oid, relname, reltablespace, relfilenode
FROM pg_class
WHERE relname IN ('archived_orders', 'archived_orders_pkey');
CREATE TABLE
| oid | relname | reltablespace | relfilenode |
|---|---|---|---|
| 16402 | archived_orders | 16401 | 16402 |
| 16411 | archived_orders_pkey | 0 | 16411 |
(2行)
私たちのテーブルスペースのOIDは 16401 であり、テーブルのカタログ行はそれを反映していますが、インデックスの reltablespace は0です。これはデータベースのデフォルトテーブルスペースを使用することを意味します。デフォルトでは、インデックスはデータベースのデフォルトテーブルスペースを使用し、USING INDEX TABLESPACE で上書きする必要があります。
\db+
List of tablespaces
| Name | Owner | Location | Access privileges | Options | Size | Description |
|---|---|---|---|---|---|---|
| extra_space | burak | /Users/burak/pg-tblspc-extra | 96 bytes | |||
| pg_default | burak | 30 MB | ||||
| pg_global | burak | 548 kB |
(3行)
ヒープテーブルの構造#
以前は、データの階層とデータがディスク上のどこに実際に配置されるかについて説明しました。このセクションでは、それらがどのように格納されるかを探ります。ヒープテーブルとは、タプル(行の物理表現)の順序付けられていないコレクションであり、ランダムな順序で格納されます。
ページはファイル内で0からNまで番号付けされ、各ページは8192バイトです。この8192という値は、Postgresをソースコードから再コンパイルする(--with-blocksize=BLOCKSIZE)ことでのみ設定可能です。ページには以下のデータが含まれます:
- ヘッダー: Postgresがアクセス時に参照するページに関する一般情報(空き領域ポインタ、チェックサム、フラグなど)が含まれます。
- ラインポインタ: タプルを指します。タプルへのインデックスのように機能し、タプルへのすべてのアクセスはラインポインタを経由します。これらは1からNまで番号付けされ、順次増加します。
- タプル: データが実際に格納される場所です。タプルも1からNまで番号付けされますが、ページの末尾から格納されます。タプルにもヘッダー、ヌルビットマップ、ユーザーデータが含まれます。
Postgresクラスタで、それらがどのように機能し、実際の値が何であるかを見てみましょう。これを行うために、pageinspect という組み込みPostgres拡張機能を使用します。これは、ページの内容を低レベルで検査するための関数を提供します。データベース、テーブル、および拡張機能を作成しましょう。
CREATE DATABASE notes_lab;
CREATE EXTENSION pageinspect;
CREATE TABLE notes (
id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
note text NOT NULL
);
INSERT INTO notes (note)
VALUES ('small row'), ('second row'), ('third row');
まず、前節で確認したように、テーブルデータの場所を調べます:
SELECT oid, relname, relfilenode, relkind
FROM pg_class
WHERE relname IN ('notes', 'notes_pkey')
ORDER BY relname;
| oid | relname | relfilenode | relkind |
|---|---|---|---|
| 16461 | notes | 16461 | r |
| 16468 | notes_pkey | 16468 | i |
(2行)
r は通常のテーブル、i はインデックスを表す relkind に注意してください(ドキュメント)。ヒープテーブルの場所とサイズを確認しましょう:
SELECT pg_relation_filepath('notes') AS heap_path,
pg_relation_size('notes') AS heap_bytes;
| heap_path | heap_bytes |
|---|---|
| base/16413/16461 | 8192 |
(1行)
場所は予想通り base/{database_oid}/{relfilenode_oid} であり、現時点では8KBの1ページで構成されています。
テーブルに3行を追加し、任意の SELECT クエリで ctid を使用して行の物理的な場所を取得することもできます。ctid は、任意の行の (page|block_number, offset_number) を表すシステム列です。
SELECT ctid, id, note
FROM notes
ORDER BY id;
| ctid | id | note |
|---|---|---|
| (0,1) | 1 | small row |
| (0,2) | 2 | second row |
| (0,3) | 3 | third row |
(3行)
現在3行と1つの8KBページしかなく、ctid はこれを効果的に表しています。最初の行 (0,1) は、ブロック 0 とラインポインタ 1 を意味します。
SELECT *
FROM page_header(get_raw_page('notes', 0));
| lsn | checksum | flags | lower | upper | special | pagesize | version | prune_xid |
|---|---|---|---|---|---|---|---|---|
| 0/20BBC40 | 0 | 0 | 36 | 8072 | 8192 | 8192 | 4 | 0 |
(1行)
lower = 36: 24バイトのPageHeaderData+ 3 × 4バイトのラインポインタ。upper = 8072: タプルストレージの最初のバイト。- 空き領域は
upper - lower = 8036バイトです。 special = 8192: これは単純なヒープページなので、特別な領域はありません。
SELECT lp, lp_off, lp_flags, lp_len, t_ctid
FROM heap_page_items(get_raw_page('notes', 0));
| lp | lp_off | lp_flags | lp_len | t_ctid |
|---|---|---|---|---|
| 1 | 8152 | 1 | 38 | (0,1) |
| 2 | 8112 | 1 | 39 | (0,2) |
| 3 | 8072 | 1 | 38 | (0,3) |
(3行)
これらの列は、ItemIdData 4バイトラインポインタによって定義されています(パーマリンク):
...
typedef struct ItemIdData
{
unsigned lp_off:15, /* offset to tuple (from start of page) */
lp_flags:2, /* state of line pointer, see below */
lp_len:15; /* byte length of tuple */
} ItemIdData;
...
lp_off はデータ行が実際にページ内のどこにあるかを示します。lp_flags=1 は LP_NORMAL であり、このラインポインタが有効なデータを示していることを意味します。0 (LP_UNUSED) である可能性もあり、これは VACUUM の結果としてスロットが解放されたことを示します。lp_len は何で構成されているのでしょうか?最初の行では 38 であり、これは以下のように分解されます:
TOAST(The Oversized-Attribute Storage Technique)#
Postgresはタプルが複数のページにまたがることを許可せず、前述のようにページサイズはコンパイル時の変数で8KBです。これは、大きな値を同じ方法で格納できないことを意味し、PostgresはTOASTを使用してこれらの値を複数の行に分割します。可変長データ型のみがTOASTをサポートします。整数などの他の型は、指定されたサイズを超えることができないためです。Postgresはまずデータを圧縮し、2KBのしきい値を超えるとTOASTテーブルを作成して実際のデータをそこに格納します。メインテーブルのフィールドには、そのデータへのポインタのみが含まれます。
データを非圧縮で検査するために、SET STORAGE EXTERNAL を設定します。これにより、Postgresはデータを圧縮しません。
CREATE TABLE toast_demo (
id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
data text NOT NULL
);
ALTER TABLE toast_demo ALTER COLUMN data SET STORAGE EXTERNAL;
INSERT INTO toast_demo (data) VALUES ('abc');
INSERT INTO toast_demo (data)
SELECT repeat('The quick brown fox jumps over the lazy dog. ', 222)
FROM generate_series(1, 2);
INSERT INTO toast_demo (data)
VALUES ('The quick brown fox jumps over the lazy dog. ');
INSERT INTO toast_demo (data)
SELECT repeat('The quick brown fox jumps over the lazy dog. ', 111);
サイズが異なる5行を挿入します。
これで、テーブルとその対応するヒープテーブルを図示できます。これらの変数とリレーションが何を意味するかをステップバイステップで見ていきましょう。
SELECT id, ctid, length(data) AS logical_bytes
FROM toast_demo
ORDER BY id;
| id | ctid | logical_bytes |
|---|---|---|
| 1 | (0,1) | 3 |
| 2 | (0,2) | 9990 |
| 3 | (0,3) | 9990 |
| 4 | (0,4) | 45 |
| 5 | (0,5) | 4995 |
(5行)
行2、3、5は2KBのTOASTしきい値を超えており、TOASTテーブルに格納されています。これを検査するには、生成されたTOASTテーブルを見つける必要があります。これはメインテーブルの pg_class 行で見つけることができます。
SELECT oid, relname, reltoastrelid
FROM pg_class
WHERE relname = 'toast_demo';
| oid | relname | reltoastrelid |
|---|---|---|
| 16483 | toast_demo | 16488 |
(1行)
toast_demo テーブルは reltoastrelid フィールドにTOASTテーブルへのポインタを持っており、TOASTテーブルのOIDが 16488 であることがわかります。これも取得しましょう:
SELECT oid, relname, relfilenode, pg_relation_filepath(oid) AS toast_path
FROM pg_class
WHERE oid = 16488;
| oid | relname | relfilenode | toast_path |
|---|---|---|---|
| 16488 | pg_toast_16483 | 16488 | base/16413/16488 |
(1行)
上記のように、TOASTテーブルの情報は他のテーブルと同様に pg_class でアクセスできます。なぜなら、それは単なるテーブルだからです。
\d+ pg_toast.pg_toast_16483
TOAST table "pg_toast.pg_toast_16483"
| Column | Type | Storage |
|---|---|---|
| chunk_id | oid | plain |
| chunk_seq | integer | plain |
| chunk_data | bytea | plain |
Owning table: "public.toast_demo"
Indexes:
"pg_toast_16483_index" PRIMARY KEY, btree (chunk_id, chunk_seq)
Access method: heap
これはPostgreSQLが所有/定義したスキーマであり、20年前にTom Laneによって導入されました(git blameで20年前を見るのは初めてで、このシリーズでたくさん見るでしょう):
/* this is pretty painful... need a tuple descriptor */
tupdesc = CreateTemplateTupleDesc(3);
TupleDescInitEntry(tupdesc, (AttrNumber) 1,
"chunk_id",
OIDOID, -1, 0);
TupleDescInitEntry(tupdesc, (AttrNumber) 2,
"chunk_seq",
INT4OID, -1, 0);
TupleDescInitEntry(tupdesc, (AttrNumber) 3,
"chunk_data",
BYTEAOID, -1, 0);
この時点で、メインテーブルとPostgresによって自動的に作成されたTOASTテーブルを指すTOASTテーブルがあることがわかっています。これらの5行のラインポインタを調べて、これらのアイテムのサイズを理解しましょう:
SELECT lp, lp_off, lp_flags, lp_len, t_ctid
FROM heap_page_items(get_raw_page('toast_demo', 0));
| lp | lp_off | lp_flags | lp_len | t_ctid |
|---|---|---|---|---|
| 1 | 8160 | 1 | 32 | (0,1) |
| 2 | 8112 | 1 | 46 | (0,2) |
| 3 | 8064 | 1 | 46 | (0,3) |
| 4 | 7984 | 1 | 74 | (0,4) |
| 5 | 7936 | 1 | 46 | (0,5) |
(5行)
行2、3、5は2KBのしきい値を超えており、偶然にも(?)同じアイテムサイズで、比較的低いです。ここで何が起こるかというと、行1と4はテーブルに直接格納され、それらのラインポインタはそのサイズを反映しています。他の行は正確に46バイトであり、これは以下のように計算できます:
- 24バイト:タプルヘッダー
- 4バイト:id整数
- 18バイト:外部TOASTポインタ
TOASTポインタは VARHDRSZ_EXTERNAL + sizeof(varatt_external) で構成されます。その構造体は以下の通りです:
typedef struct varatt_external
{
int32 va_rawsize; /* Original data size (includes header) */
uint32 va_extinfo; /* External saved size (without header) and
* compression method */
Oid va_valueid; /* Unique ID of value within TOAST table */
Oid va_toastrelid; /* RelID of TOAST table containing it */
} varatt_external;
SELECT id,
length(data) AS va_extinfo,
length(data) + 4 AS va_rawsize,
pg_column_toast_chunk_id(data) AS va_valueid
FROM toast_demo
WHERE pg_column_toast_chunk_id(data) IS NOT NULL
ORDER BY id;
| id | va_extinfo | va_rawsize | va_valueid |
|---|---|---|---|
| 2 | 9990 | 9994 | 16492 |
| 3 | 9990 | 9994 | 16493 |
| 5 | 4995 | 4999 | 16494 |
(3行)
構造体のフィールドで説明されているように、メインテーブルのポインタからデータサイズ、元のサイズ、およびTOASTテーブル内の行のOIDを確認できます。
va_rawsize = 9994: 元のvarlena値、4バイトヘッダーを含む。va_extinfo = 9990: ここに外部保存されたバイト数、圧縮なし。va_valueid:pg_toast.pg_toast_16483.chunk_idにマッピングされ、そのテーブルのどこを見ればよいかを示します。
次に、これらの3行のTOASTテーブルを確認しましょう。以下のクエリは、TOASTのチャンク数、シーケンス、およびサイズの概要を取得するためのものです:
SELECT chunk_id,
count(*) AS chunks,
min(chunk_seq) AS first_seq,
max(chunk_seq) AS last_seq,
sum(length(chunk_data)) AS external_bytes
FROM pg_toast.pg_toast_16483
GROUP BY chunk_id
ORDER BY chunk_id;
| chunk_id | chunks | first_seq | last_seq | external_bytes |
|---|---|---|---|---|
| 16492 | 6 | 0 | 5 | 9990 |
| 16493 | 6 | 0 | 5 | 9990 |
| 16494 | 3 | 0 | 2 | 4995 |
(3行)
ご覧の通り、各 chunk_id には0から始まるシーケンシャルに番号付けされたチャンクがあります。各シーケンスの chunk_data の合計は、期待されるデータサイズになります。
SELECT chunk_id, chunk_seq, length(chunk_data) AS chunk_bytes
FROM pg_toast.pg_toast_16483
ORDER BY chunk_id, chunk_seq;
| chunk_id | chunk_seq | chunk_bytes |
|---|---|---|
| 16492 | 0 | 1996 |
| 16492 | 1 | 1996 |
| 16492 | 2 | 1996 |
| 16492 | 3 | 1996 |
| 16492 | 4 | 1996 |
| 16492 | 5 | 10 |
| 16493 | 0 | 1996 |
| 16493 | 1 | 1996 |
| 16493 | 2 | 1996 |
| 16493 | 3 | 1996 |
| 16493 | 4 | 1996 |
| 16493 | 5 | 10 |
| 16494 | 0 | 1996 |
| 16494 | 1 | 1996 |
| 16494 | 2 | 1003 |
(15行)
前述のように、TOASTテーブルにはインデックス `