Linuxサーバー上でPostgreSQLを運用していると、レコードが数千万行を超えたあたりからこうした問題に直面することがあります。そのときの解決策の一つが、PostgreSQL 10以降で正式実装された宣言的パーティショニングです。
この記事では、RHEL 9系/Rocky Linux 9を想定環境として、PostgreSQLのRANGE・LIST・HASHの3方式でパーティションを設定する実践的な手順を解説します。パーティション作成から主キー・インデックスの設定、パーティションの追加と削除、古いパーティションのDETACHアーカイブ、EXPLAINによるプルーニング確認、よくあるトラブルの対処まで順を追って説明します。
この記事のポイント
・RANGEは日付ログ、LISTはカテゴリ分類、HASHは均等負荷分散と使い分ける
・親テーブルをPARTITION BYで作成し、子テーブルをPARTITION OFで追加する
・パーティションキーは主キーに含める必要があり、設計段階で決めておくことが重要
・EXPLAINでパーティションプルーニングが効いているかを確認してから本番運用に入る
・DETACH PARTITIONで古いパーティションをクエリ対象から切り離してアーカイブできる
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
PostgreSQLの宣言的パーティショニングとは
PostgreSQLのパーティショニングとは、論理的に1つのテーブルを複数の物理テーブル(パーティション)に分割する機能です。PostgreSQL 10でネイティブの宣言的パーティショニングが実装され、従来のトリガー・ルール方式よりはるかに簡潔に設定できるようになりました。パーティショニングを使う主な目的は3つです。
・クエリの高速化: WHERE句でパーティションキーを指定すると、対象パーティションのみスキャンされる(パーティションプルーニング)
・バルク削除の高速化: 古い月次パーティションをDROP TABLEするだけで大量行を即座に削除できる
・ディスク管理の分散: パーティションごとにテーブルスペースを指定し、異なるディスクに配置できる
一方で、パーティショニングが効果を発揮するには「WHERE句でパーティションキーを使うクエリが多い」というアクセスパターンが前提です。結合(JOIN)が多いOLTPや、ランダムアクセスが主体のテーブルでは、プルーニングが機能せずオーバーヘッドになることもあります。「テーブルサイズが大きい」だけで安易に導入するのではなく、クエリパターンを先に確認してから設計するのが重要です。
宣言的パーティショニングが使えるのはPostgreSQL 10以降です。バージョンが上がるにつれて機能が拡充されており、11でのインデックス自動継承、12でのパーティションプルーニング改善およびpg_partition_tree()の追加、14でのDETACH CONCURRENTLY対応と段階的に強化されています。本番環境のバージョンを事前に確認してから手順を進めてください。
パーティション方式の選び方
PostgreSQLのパーティション方式は3種類あります。| 方式 | 分割基準 | 典型的なユースケース | プルーニング |
|---|---|---|---|
| RANGE | 連続する値の範囲 | 日付・タイムスタンプ(月別・年別ログ) | 有効(=、<、>、BETWEENで効く) |
| LIST | 値のリスト(列挙) | 地域コード・ステータス・カテゴリ | 有効(=、INで効く) |
| HASH | ハッシュ値による均等分割 | 均等負荷分散・ランダムIDの分散格納 | 限定的(=のみ) |
RANGEとLISTは、WHERE句でパーティションキーを指定した範囲・等値検索でプルーニングが効きます。HASHは等値検索(=)のみプルーニングが効き、範囲検索(BETWEEN、<、>)では全パーティションをスキャンします。時系列クエリが主体のテーブルにHASHを使うと恩恵が得られないため、データの性質とクエリパターンに合った方式を選んでください。
PostgreSQL 11以降では、パーティション自体をさらに別方式で分割する「サブパーティション(複合パーティション)」も利用できます。例えばRANGEで月別に分割したテーブルを、さらにLISTで地域別に細分化するといった構成です。ただし管理の複雑さが増すため、まずは単一方式でシンプルに設計し、必要になってから検討するのが現実的です。
RANGEパーティションを設定する手順
RANGEパーティションは、日付ログやトランザクションデータなど「時系列で増えるデータ」に最も広く使われます。ここでは注文ログテーブルを月別に分割する例を示します。1. パーティション親テーブルを作成する
# 宣言的パーティショニング(RANGE)の親テーブル CREATE TABLE orders ( id BIGSERIAL, order_date DATE NOT NULL, customer_id INTEGER NOT NULL, amount NUMERIC(12,2) ) PARTITION BY RANGE (order_date);
2. 月別パーティションを追加する
# 2026年1月分のパーティション CREATE TABLE orders_2026_01 PARTITION OF orders FOR VALUES FROM ('2026-01-01') TO ('2026-02-01'); # 2026年2月分のパーティション CREATE TABLE orders_2026_02 PARTITION OF orders FOR VALUES FROM ('2026-02-01') TO ('2026-03-01'); # 2026年3月分のパーティション CREATE TABLE orders_2026_03 PARTITION OF orders FOR VALUES FROM ('2026-03-01') TO ('2026-04-01');
3. データを投入して確認する
# データの投入(親テーブルに挿入すると自動的に振り分けられる) INSERT INTO orders (order_date, customer_id, amount) VALUES ('2026-01-15', 100, 5000.00); # どのパーティションに入ったか確認 SELECT tableoid::regclass AS partition_name, * FROM orders WHERE order_date = '2026-01-15';
partition_name | id | order_date | customer_id | amount -----------------+----+------------+-------------+--------- orders_2026_01 | 1 | 2026-01-15 | 100 | 5000.00
GROUP BY tableoidを使います。# 全パーティションの行数を一度に確認する SELECT tableoid::regclass AS partition_name, COUNT(*) AS row_count FROM orders GROUP BY tableoid ORDER BY partition_name;
4. デフォルトパーティションを設定する(推奨)
定義済みパーティションの範囲外のデータが挿入されるとエラーになります。デフォルトパーティションを設けておくと、想定外の値を受け取ってもエラーを防げます。# デフォルトパーティション(範囲外データの受け皿) CREATE TABLE orders_default PARTITION OF orders DEFAULT;
LISTパーティションを設定する手順
LISTパーティションは、地域コードやステータス値など「取りうる値が決まっている」カラムに向いています。1. 親テーブルとLISTパーティションを作成する
# 地域別の顧客テーブル(LIST分割) CREATE TABLE customers ( id BIGSERIAL, region VARCHAR(20) NOT NULL, name VARCHAR(100) ) PARTITION BY LIST (region); # 東日本パーティション CREATE TABLE customers_east PARTITION OF customers FOR VALUES IN ('tokyo', 'kanagawa', 'chiba', 'saitama'); # 西日本パーティション CREATE TABLE customers_west PARTITION OF customers FOR VALUES IN ('osaka', 'kyoto', 'hyogo', 'nara'); # その他のデフォルトパーティション CREATE TABLE customers_other PARTITION OF customers DEFAULT;
新しい値(例:「hokkaido」)を追加する場合は、対象の値が既存パーティションに含まれていなければ新しいパーティションを作成するだけで対応できます。ただしデフォルトパーティションがある場合は、新しいパーティションをATTACHする前にデフォルトをDETACHする必要があります。将来追加される可能性のある値は、設計段階であらかじめ洗い出しておくと管理コストを抑えられます。
HASHパーティションを設定する手順
HASHパーティションは、特定の値の偏りがないランダムなIDやUUIDで均等にデータを分散させたい場合に適しています。大量INSERTの負荷を複数テーブルに分散する用途でも利用されます。1. HASHパーティションの作成
# ユーザーイベントログ(HASH分割・4分割) CREATE TABLE user_events ( id BIGSERIAL, user_id BIGINT NOT NULL, event_time TIMESTAMPTZ DEFAULT NOW(), event_type VARCHAR(50) ) PARTITION BY HASH (user_id); # MODULUS(総分割数)と REMAINDER(余り)で各パーティションの担当範囲を指定 CREATE TABLE user_events_0 PARTITION OF user_events FOR VALUES WITH (MODULUS 4, REMAINDER 0); CREATE TABLE user_events_1 PARTITION OF user_events FOR VALUES WITH (MODULUS 4, REMAINDER 1); CREATE TABLE user_events_2 PARTITION OF user_events FOR VALUES WITH (MODULUS 4, REMAINDER 2); CREATE TABLE user_events_3 PARTITION OF user_events FOR VALUES WITH (MODULUS 4, REMAINDER 3);
HASHパーティションでプルーニングが効くのは等値検索(WHERE user_id = 定数)のみです。範囲検索(BETWEEN、<、>)では全パーティションをスキャンするため、時系列クエリが主体のテーブルにはRANGEパーティションの方が適しています。
パーティションにインデックスを設定する
パーティションテーブルのインデックス設計には2つのアプローチがあります。1. 親テーブルへのインデックス作成(PostgreSQL 11以降推奨)
PostgreSQL 11以降では、親テーブルにインデックスを作成するとすべての既存パーティション・新規追加パーティションへ自動的に継承されます。# 親テーブルへのインデックス作成 → 全パーティションへ自動継承 CREATE INDEX idx_orders_customer_id ON orders (customer_id); CREATE INDEX idx_orders_order_date ON orders (order_date);
2. 特定パーティションのみにインデックスを追加する場合
# 1月パーティションのみに追加インデックスを作成する場合 CREATE INDEX idx_orders_2026_01_amount ON orders_2026_01 (amount);
# NG: パーティションキー(order_date)が主キーに含まれていない ALTER TABLE orders ADD PRIMARY KEY (id); # OK: パーティションキーを主キーに含める ALTER TABLE orders ADD PRIMARY KEY (id, order_date);
パーティションの確認・追加・削除
1. パーティション一覧の確認
# pg_inherits でパーティション一覧を確認する SELECT parent.relname AS parent_table, child.relname AS partition_name FROM pg_inherits JOIN pg_class parent ON pg_inherits.inhparent = parent.oid JOIN pg_class child ON pg_inherits.inhrelid = child.oid WHERE parent.relname = 'orders';
parent_table | partition_name --------------+------------------ orders | orders_2026_01 orders | orders_2026_02 orders | orders_2026_03 orders | orders_default
pg_partition_tree() 関数を使うと、pg_inheritsの結合クエリを書かずに親テーブル名だけでパーティション構成を確認できます。# PostgreSQL 12以降: pg_partition_tree() でシンプルに確認する SELECT relid, parentrelid, isleaf, level FROM pg_partition_tree('orders');
relid | parentrelid | isleaf | level ------------------+-------------+--------+------- orders | | f | 0 orders_2026_01 | orders | t | 1 orders_2026_02 | orders | t | 1 orders_2026_03 | orders | t | 1 orders_default | orders | t | 1
isleaf が t の行が実際にデータを格納するパーティションです。サブパーティション構成の場合は level が2以上になります。パーティションの範囲定義や行数・データサイズをまとめて確認したい場合は、pg_stat_user_tablesとpg_classを組み合わせた以下のクエリが便利です。
# パーティションごとのおおよその行数(ANALYZE後の統計値) SELECT relname AS partition_name, n_live_tup AS approx_rows FROM pg_stat_user_tables WHERE relname LIKE 'orders%' ORDER BY relname; # パーティションのデータサイズも確認する場合 SELECT child.relname AS partition_name, pg_size_pretty(pg_relation_size(child.oid)) AS data_size, s.n_live_tup AS approx_rows FROM pg_inherits JOIN pg_class parent ON pg_inherits.inhparent = parent.oid JOIN pg_class child ON pg_inherits.inhrelid = child.oid LEFT JOIN pg_stat_user_tables s ON s.relname = child.relname WHERE parent.relname = 'orders' ORDER BY child.relname;
n_live_tupはVACUUM・ANALYZE実行後の統計値です。正確な行数が必要な場合はSELECT COUNT(*) FROM orders_2026_01のようにパーティションを直接クエリしてください。2. 翌月のパーティションを事前追加する
RANGEパーティションでは、対応するパーティションが存在しない状態でINSERTするとエラーになります。cron等で毎月末に翌月分を追加する運用が推奨されます。# 4月分のパーティションを事前に追加する例 CREATE TABLE orders_2026_04 PARTITION OF orders FOR VALUES FROM ('2026-04-01') TO ('2026-05-01');
毎月末に自動でパーティションを追加する場合は、pg_cronを使ったスケジュール実行が便利です。pg_cronはPostgreSQL拡張で、データベース内からcron形式のスケジュールでSQLを実行できます。自動化する際はパーティション名に年月を含めることで管理しやすくなります。デフォルトパーティションのデータ確認もスクリプト化して組み合わせると、翌月分の追加漏れを防げます。
3. 古いパーティションをDETACHしてアーカイブする
DETACHすると、そのパーティションが親テーブルから切り離されて通常の独立テーブルになります。データを保持したままクエリ対象から外せるため、アーカイブ用途に最適です。# 2026年1月パーティションを親テーブルから切り離す ALTER TABLE orders DETACH PARTITION orders_2026_01; # 切り離し後はpg_dumpで単独バックアップ可能 # 完全に削除する場合は通常のDROPを使う DROP TABLE orders_2026_01;
DETACH PARTITION ... CONCURRENTLY が使えるため、テーブルロックなしで切り離しが行えます。長時間書き込みが発生する本番環境では積極的に使ってください。# PostgreSQL 14以降: ロックなしでパーティションを切り離す ALTER TABLE orders DETACH PARTITION orders_2026_01 CONCURRENTLY;
パーティションプルーニングをEXPLAINで確認する方法
パーティションプルーニングが正しく動作しているかは、EXPLAINの出力で確認します。対象パーティションのみがスキャン対象に現れていれば正常です。# パーティションプルーニングが効いているか確認 EXPLAIN SELECT * FROM orders WHERE order_date = '2026-01-15';
QUERY PLAN ----------------------------------------------------- Append (cost=0.00..X.XX rows=X width=XX) -> Seq Scan on orders_2026_01 (cost=...) Filter: (order_date = '2026-01-15'::date)
orders_2026_01 のみがスキャン対象になっていれば正常です。全パーティションが列挙されている場合は、以下を確認してください。・WHERE句のカラム型とパーティションキーの型が一致しているか(例: DATE型カラムにVARCHARで比較するとキャストが発生しプルーニングが効かない)
・パーティションキーのカラムに関数を適用していないか(例:
WHERE DATE_TRUNC('month', order_date) = '2026-01-01' のようにキーを加工すると、どのパーティションに対応するか判断できずプルーニングが効かなくなる。条件式はパーティションキーを直接比較する形に書き直す)・
enable_partition_pruningがOFFになっていないか(SHOW enable_partition_pruning;で確認)・HASHパーティションを範囲検索(BETWEEN、<、>)していないか(HASHは等値のみプルーニングが効く)
範囲検索でプルーニングが効いているケースも確認しておくと本番運用の信頼性が上がります。
# 範囲検索でのプルーニング確認(2026年1月~2月の2パーティションのみスキャン) EXPLAIN SELECT * FROM orders WHERE order_date >= '2026-01-01' AND order_date < '2026-03-01'; # 出力例(環境により異なります) # Append (cost=0.00..X.XX rows=X width=XX) # -> Seq Scan on orders_2026_01 ... # -> Seq Scan on orders_2026_02 ... # ※ orders_2026_03やorders_defaultはスキャン対象に含まれない
よくあるトラブルと対処法
「no partition of relation found for row」が出てINSERTが失敗する
対応するパーティションが定義されていない値を挿入しようとしたときに発生します。デフォルトパーティションを作成するか、エラーが発生した値の範囲に合うパーティションを追加してください。# デフォルトパーティションを後から追加する場合 CREATE TABLE orders_default PARTITION OF orders DEFAULT;
EXPLAINでパーティションプルーニングが効いていない
全パーティションがスキャン対象になっている場合、まずWHERE句のカラム型とパーティションキーの型が一致しているか確認します。またenable_partition_pruning が off になっていないかも確認してください。HASHパーティションの場合、範囲検索(BETWEEN、<、>)ではプルーニングが効かない仕様です。等値検索(=)に書き換えられないか見直してください。# パーティションプルーニングの設定を確認する SHOW enable_partition_pruning; # セッション内で有効化する(デフォルトはon) SET enable_partition_pruning = on;
「ERROR: insufficient columns in PRIMARY KEY constraint」が出る
パーティション化テーブルの主キーには、パーティションキーを必ず含める必要があります。# NG: パーティションキーが主キーに含まれていない ALTER TABLE orders ADD PRIMARY KEY (id); # OK: パーティションキー(order_date)を主キーに含める ALTER TABLE orders ADD PRIMARY KEY (id, order_date);
デフォルトパーティションがあるときに新しいパーティションをATTACHできない
新しいパーティションの範囲と重複するデータがデフォルトパーティションに存在するとATTACHが失敗します。事前に対象範囲のデータがデフォルトパーティションに入っていないことを確認してから操作してください。# デフォルトパーティションに追加予定の範囲のデータが入っていないか確認 SELECT COUNT(*) FROM orders_default WHERE order_date >= '2026-04-01' AND order_date < '2026-05-01'; # 0件であれば新しいパーティションを追加できる CREATE TABLE orders_2026_04 PARTITION OF orders FOR VALUES FROM ('2026-04-01') TO ('2026-05-01');
パーティションキーに関数を適用するとプルーニングが効かない
WHERE句でパーティションキーのカラムにDATE_TRUNCやEXTRACTなどの関数を適用すると、PostgreSQLはどのパーティションが対象範囲に含まれるか判断できなくなり、プルーニングが無効になります。# NG: パーティションキーに関数を適用している(プルーニングが効かず全スキャン) EXPLAIN SELECT * FROM orders WHERE DATE_TRUNC('month', order_date) = '2026-01-01'; # OK: パーティションキーを直接比較する形に書き直す EXPLAIN SELECT * FROM orders WHERE order_date >= '2026-01-01' AND order_date < '2026-02-01';
DATE_TRUNCやEXTRACTをパーティションキー側に適用するのではなく、>= / < による範囲指定で書き直すとプルーニングが有効になります。PostgreSQLのDB管理スキルを体系的に習得したい方は、Linuxサーバー実務を網羅したLinuxセミナーも参考になります。
本記事のまとめ
PostgreSQLの宣言的パーティショニングをRANGE・LIST・HASHの3方式で解説しました。主なポイントをまとめます。| 操作 | SQLの書き方 | ポイント |
|---|---|---|
| RANGE親テーブル作成 | CREATE TABLE t (...) PARTITION BY RANGE (列) |
親テーブルにはデータが入らない |
| パーティション追加 | CREATE TABLE t_p PARTITION OF t FOR VALUES FROM (...) TO (...) |
TO値は含まない(未満) |
| デフォルトパーティション | CREATE TABLE t_def PARTITION OF t DEFAULT |
範囲外INSERTのエラー防止に必須 |
| インデックス自動継承 | CREATE INDEX ON 親テーブル (列) |
PostgreSQL 11以降で全パーティションへ自動継承 |
| パーティション確認 | SELECT ... FROM pg_inherits ... |
pg_classと結合して一覧取得 |
| パーティション確認(PG12+) | SELECT relid, isleaf FROM pg_partition_tree('t') |
PostgreSQL 12以降で使えるシンプルな代替手段 |
| 行数・サイズ確認 | SELECT relname, n_live_tup FROM pg_stat_user_tables WHERE ... |
ANALYZE後の統計値。正確な値はCOUNT(*) |
| プルーニング確認 | EXPLAIN SELECT ... WHERE partition_key = val |
対象パーティションのみ表示されればOK |
| アーカイブ切り離し | ALTER TABLE t DETACH PARTITION t_p |
PG14以降はCONCURRENTLYでロック回避 |
RANGEパーティションは毎月末に翌月分を事前作成するか、pg_cron等で自動化すると管理コストを抑えられます。デフォルトパーティションも必ず設けて、想定外のINSERTエラーを防いでください。設計後はEXPLAINでプルーニングが意図通りに効いているかを確認する習慣をつけておくと、本番運用での想定外の全スキャンを防げます。パーティションキーに関数を適用するとプルーニングが効かなくなるため、WHERE句はパーティションキーを直接比較する形で書くことを徹底してください。パーティションキーは主キーに必ず含めること、HASHパーティションは等値検索のみプルーニングが効く点を押さえておけば、3方式を使い分けて大規模テーブルの運用に対応できます。
>> Linux Master Pro Seminarの詳細はこちら
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます