HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

PostgreSQLの内部構造を読む:データベースクラスタ、データベース、テーブル

Reading the internals of Postgres: Database cluster, databases, and tables (buraksen.dev)

74 pointsby buraksen1 コメント

要約

この記事は、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;
oiddatname
1template1
4template0
5postgres

(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; でテーブルを作成するか、GUC default_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
oiddatname
16384shop

(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');
oidrelnamerelfilenoderelkind
16386orders16386r
16395orders_pkey16395i

(2行)

ご覧の通り、relfilenode(物理場所の識別子)とOIDは同一です。パスを計算するための組み込み関数 pg_relation_filepath を使用できます:

SELECT pg_relation_filepath('orders'),
       pg_relation_filepath('orders_pkey');
pg_relation_filepathpg_relation_filepath
base/16384/16386base/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
oidrelnamerelfilenode
16386orders16397
16395orders_pkey16400

(2行)

pg_relation_filepath
base/16384/16397

(1行)

VACUUM によるリライトは relfilenode を更新し、最新の状態ではOIDと一致しなくなりました。

VACUUM FULL の図

テーブルスペース#

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
oidspcname
16401extra_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
oidrelnamereltablespacerelfilenode
16402archived_orders1640116402
16411archived_orders_pkey016411

(2行)

私たちのテーブルスペースのOIDは 16401 であり、テーブルのカタログ行はそれを反映していますが、インデックスの reltablespace は0です。これはデータベースのデフォルトテーブルスペースを使用することを意味します。デフォルトでは、インデックスはデータベースのデフォルトテーブルスペースを使用し、USING INDEX TABLESPACE で上書きする必要があります。

\db+
                                            List of tablespaces
NameOwnerLocationAccess privilegesOptionsSizeDescription
extra_spaceburak/Users/burak/pg-tblspc-extra96 bytes
pg_defaultburak30 MB
pg_globalburak548 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;
oidrelnamerelfilenoderelkind
16461notes16461r
16468notes_pkey16468i

(2行)

r は通常のテーブル、i はインデックスを表す relkind に注意してください(ドキュメント)。ヒープテーブルの場所とサイズを確認しましょう:

SELECT pg_relation_filepath('notes') AS heap_path,
       pg_relation_size('notes')     AS heap_bytes;
heap_pathheap_bytes
base/16413/164618192

(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;
ctididnote
(0,1)1small row
(0,2)2second row
(0,3)3third row

(3行)

現在3行と1つの8KBページしかなく、ctid はこれを効果的に表しています。最初の行 (0,1) は、ブロック 0 とラインポインタ 1 を意味します。

SELECT * 
FROM   page_header(get_raw_page('notes', 0));
lsnchecksumflagslowerupperspecialpagesizeversionprune_xid
0/20BBC40003680728192819240

(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));
lplp_offlp_flagslp_lent_ctid
18152138(0,1)
28112139(0,2)
38072138(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行を挿入します。

TOASTストレージの図

これで、テーブルとその対応するヒープテーブルを図示できます。これらの変数とリレーションが何を意味するかをステップバイステップで見ていきましょう。

SELECT id, ctid, length(data) AS logical_bytes
FROM   toast_demo
ORDER  BY id;
idctidlogical_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';
oidrelnamereltoastrelid
16483toast_demo16488

(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;
oidrelnamerelfilenodetoast_path
16488pg_toast_1648316488base/16413/16488

(1行)

上記のように、TOASTテーブルの情報は他のテーブルと同様に pg_class でアクセスできます。なぜなら、それは単なるテーブルだからです。

\d+ pg_toast.pg_toast_16483
TOAST table "pg_toast.pg_toast_16483"
ColumnTypeStorage
chunk_idoidplain
chunk_seqintegerplain
chunk_databyteaplain
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));
lplp_offlp_flagslp_lent_ctid
18160132(0,1)
28112146(0,2)
38064146(0,3)
47984174(0,4)
57936146(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;
idva_extinfova_rawsizeva_valueid
29990999416492
39990999416493
54995499916494

(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_idchunksfirst_seqlast_seqexternal_bytes
164926059990
164936059990
164943024995

(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_idchunk_seqchunk_bytes
1649201996
1649211996
1649221996
1649231996
1649241996
16492510
1649301996
1649311996
1649321996
1649331996
1649341996
16493510
1649401996
1649411996
1649421003

(15行)

前述のように、TOASTテーブルにはインデックス `