<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>pg_repack &#8211; SRA OSS Tech Blog</title>
	<atom:link href="https://www.sraoss.co.jp/tech-blog/tag/pg_repack/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://www.sraoss.co.jp/tech-blog/</link>
	<description>OSS専門の技術ブログ。PostgreSQL、Zabbixを中心に10種類以上のOSSの解説、アップデート情報、運用ヒントを提供。</description>
	<lastBuildDate>Mon, 09 Nov 2026 03:21:56 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.3</generator>

<image>
	<url>https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/07/blog-icon-150x150.png</url>
	<title>pg_repack &#8211; SRA OSS Tech Blog</title>
	<link>https://www.sraoss.co.jp/tech-blog/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>pg_repack (オンラインテーブル再編成ツール)</title>
		<link>https://www.sraoss.co.jp/tech-blog/pgsql/pg_repack/</link>
		
		<dc:creator><![CDATA[PostgreSQL技術グループ]]></dc:creator>
		<pubDate>Mon, 30 May 2016 01:00:12 +0000</pubDate>
				<category><![CDATA[PostgreSQL]]></category>
		<category><![CDATA[pg_reorg]]></category>
		<category><![CDATA[pg_repack]]></category>
		<category><![CDATA[VACUUM]]></category>
		<category><![CDATA[サードパーティーソフトウェア]]></category>
		<guid isPermaLink="false">https://www.sraoss.co.jp/tech-blog/?p=848</guid>

					<description><![CDATA[pg_repack は PostgreSQL のテーブルをオンラインで再編成できるツールです。本記事では pg_repackについて紹介します。 良く知られている通り、PostgreSQL は追記型アーキテクチャを採用し ...]]></description>
										<content:encoded><![CDATA[<p>pg_repack は PostgreSQL のテーブルをオンラインで再編成できるツールです。本記事では pg_repackについて紹介します。</p>
<p>良く知られている通り、PostgreSQL は追記型アーキテクチャを採用しています。UPDATE や DELETE をしても旧データを格納した行はしばらく物理ファイル上に残り、これを VACUUM コマンドや自動 VACUUM で整理して、その領域を再利用可能にする仕組みとなっています。何らかの理由でこれらの手動・自動の VACUUM 処理が実行されなかった場合には、データ格納に使われない不要領域が増加し、性能劣化の原因となります。そのような場合には、CLUSTER コマンドや VACUUM FULL コマンドを使って、テーブルの再編成をするのですが、これらのコマンドは強いロックを取得するため、サービス中の適用が難しいという課題がありました。</p>
<p>pg_repack は CLUSTER または VACUUM FULL と同様に不要領域の削除や行の並び替えることができますが、処理中に強いロックをごく短時間しか取得しないため、サービス中にも実施が可能となります。</p>
<p><span id="more-848"></span></p>
<h2>機能と仕組み</h2>
<p>pg_repack は、参照や更新処理を長時間のブロックをせずに CLUSTER コマンドや VACUUM FULL コマンド相当の処理を実行することができます。また、合わせてインデックスの再作成も行います。</p>
<p>pg_repack は 図1 のように、操作対象テーブルの一時的な作業テーブルを作成します。操作対象テーブルへトリガを設定し、更新ログ表へ再編成中の更新処理を記録しておき、再編成完了後、その差分情報を作業テーブルに反映し、対象テーブルと切り替えます。再編成が作業テーブルで行われるため、オンラインでの再編成が可能となっています。</p>
<p><a href="/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow.png" target="_blank" rel="noopener noreferrer"><img decoding="async" class=" wp-image-852" src="https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow.png" alt="オンライン再編成の仕組み" width="90%" srcset="https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow.png 720w, https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow-300x142.png 300w, https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow-304x144.png 304w, https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/11/pg_reorg_flow-282x133.png 282w" sizes="(max-width: 720px) 100vw, 720px" /></a></p>
<h2>動作環境</h2>
<p>pg_repack は以下の環境に対応しています。</p>
<ul>
<li>PostgreSQL バージョン：9.1 から 16 (pg_repack 1.5.0 時点)</li>
<li>OSバージョン：基本的には x86_64 アーキテクチャの Linux 環境なら動作するはずです。本記事の検証環境には、CentOS 7.4 (x86_64) を使いました。Windows 向けには Microsoft Visual C++ を利用してビルドできます。ソースコードの msvc フォルダ内にプロジェクトファイルが用意されています。</li>
</ul>
<p>Windowsバイナリの公式配布はありませんが、<a href="https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte/?utm_source=sraoss-techblog&amp;utm_medium=referral&amp;utm_campaign=under-article-pgsql">SRA OSS の PostgreSQLサポートサービス</a>では pg_repack の Windowsバイナリ提供を行っています。</p>
<h2>インストール</h2>
<p>pg_repack のソースコードは <a href="https://github.com/reorg/pg_repack" target="_blank" rel="noopener noreferrer">プロジェクトページ</a> からダウンロードします。ダウンロード後、PostgreSQL のコマンドにパスが通ったユーザにて、ビルド、インストールします。</p>
<pre>$ cd pg_repack
$ make
$ sudo make install
</pre>
<p>なお、RHEL系のLinuxを使用していて PostgreSQL本体を<a href="https://yum.postgresql.org/repopackages.php">PGDGリポジトリ</a>のパッケージからインストールしている場合には、pg_repack もパッケージからインストールするのが簡単です。</p>
<p>インストールを行った後、pg_repack エクステンションを対象のデータベースに登録します。 下記例ではデータベース testdb を作成して、そこに拡張モジュールを登録しています。</p>
<pre>$ createdb testdb
$ psql testdb -U postgres

testdb=# CREATE EXTENSION pg_repack;
CREATE EXTENSION
testdb=# \dx
                                  List of installed extensions
   Name    | Version |   Schema   |                         Description
-----------+---------+------------+--------------------------------------------------------------
 pg_repack | 1.4.3   | public     | Reorganize tables in PostgreSQL databases with minimal locks
(1 rows)
</pre>
<h2>基本的な使い方</h2>
<p>pg_repack の基本的な使い方を見ていきます。コマンドは PostgreSQL のスーパーユーザと同名でサーバプロセス実行ユーザでもある OS 上の postgres ユーザで行うものとします。</p>
<p>testdb というデータベースの t1 テーブルをテーブル再編成するにはコマンドラインから以下のように実行します。-n は &#8211;no-order の省略形でデータ並び替えをしないという意味で、このコマンドは「VACUUM FULL t1」に相当します。</p>
<pre>$ pg_repack -n -t t1 -d testdb
INFO: ---- reorganize one table with 7 steps. ----
INFO: target table name    : t1
INFO: ---- STEP1. setup ----
INFO: This needs EXCLUSIVE LOCK against the target table.
INFO: ---- STEP2. copy tuples into temp table----
INFO: ---- STEP3. create indexes ----
INFO: ---- STEP4. apply logs  ----
INFO: ---- STEP5. swap tables ----
INFO: This needs EXCLUSIVE LOCK against the target table.
INFO: ---- STEP6. drop old table----
INFO: ---- STEP7. analyze ----
</pre>
<p>-n を付けないとデータ並び替えも行います。以下コマンドは「CLUSTER t1 USING col_id」に相当します。 -o は &#8211;order-by の省略形で、並び替えの基準となるカラムを指定しています。-o を省略すると以前に CLUSTER コマンドを実行したときに指定されたカラム（cluster key と呼ばれます）で並び替えが行われます。</p>
<pre> $ pg_repack -o col_id -t t1 -d testdb
（以下、コマンド出力を省略します）
</pre>
<p>また、データベース名だけを指定すると、そのデータベース内で pg_repack 実行可能なテーブル全てについて pg_repack を実行します。この場合も -n オプションの有無を選べます。-n 無し、すなわちデータ並び替えをする場合には、cluster key のカラムが定まってるテーブルだけが処理対象となります。</p>
<pre>$ pg_repack -n testdb
</pre>
<p>コマンドオプションの詳細は <a href="https://github.com/reorg/pg_repack/blob/master/doc/pg_repack_jp.rst" target="_blank" rel="noopener noreferrer">pg_repack の付属ドキュメント</a> に記載されています。</p>
<h2>動作確認</h2>
<p>実際に動作と効果を確認してみます。本記事の検証環境は CentOS 7.4、PostgreSQL 9.6.10、pg_repack は 1.4 系列 2018 年 10 月時点のコードです。</p>
<p>テーブル t1 を作成し、10,000 件のレコードを初期登録します。この時点でサイズは 632kB です。</p>
<pre>testdb=# CREATE TABLE t1 (id int primary key, val text);
CREATE TABLE
testdb=#
testdb=# SELECT pg_size_pretty(pg_total_relation_size('t1'));
 pg_size_pretty
----------------
 16 kB
(1 row)

testdb=# INSERT INTO t1 VALUES(generate_series(1,10000),'AAA');
INSERT 0 10000
testdb=# SELECT pg_size_pretty(pg_total_relation_size('t1'));
 pg_size_pretty
----------------
 632 kB
(1 row)
</pre>
<p>次に不要領域を作るため、テーブルの全行を UPDATE することを数回繰り返します。</p>
<pre>testdb=# UPDATE t1 SET VAL = 'BBB';
UPDATE 10000
(何度か繰り返す)

testdb=# SELECT pg_size_pretty(pg_total_relation_size('t1'));
 pg_size_pretty
----------------
 4568 kB
(1 row)
</pre>
<p>更新を繰り返し、レコード数が変わらず、テーブルサイズが 632kB から 4568kB まで膨らみました。VACUUM をしても、テーブルの物理サイズは小さくなりません。</p>
<pre>testdb=# VACUUM t1;
VACUUM
testdb=# SELECT pg_size_pretty(pg_total_relation_size('t1'));
 pg_size_pretty
----------------
 4568 kB
(1 row)
</pre>
<p>pg_repack によるテーブル再編成を行います。</p>
<pre>$ pg_repack -n -t t1 -d testdb
</pre>
<p>再編成後、テーブルの物理サイズが小さくなっていることが確認できます。</p>
<pre>$ psql testdb -U postgres

testdb=# SELECT pg_size_pretty(pg_total_relation_size('t1'));
 pg_size_pretty
----------------
 632 kB
(1 row)
</pre>
<p>他にも、以下のように実行することも可能です</p>
<ul>
<li style="list-style-type: none;">
<ul>
<li>-t オプションを複数同時に使用することで、複数のテーブルを指定することができます。</li>
</ul>
</li>
</ul>
<pre>    $ pg_repack -n -t t1 -t t2 -d testdb
</pre>
<ul>
<li style="list-style-type: none;">
<ul>
<li>データベースtestdb全体を4並列実行にてテーブル再編成をかけます。</li>
</ul>
</li>
</ul>
<pre>    $ pg_repack -n -j 4 testdb
</pre>
<ul>
<li style="list-style-type: none;">
<ul>
<li>データベースtestdbテーブル t1 のインデックスのみを再編成します。</li>
</ul>
</li>
</ul>
<pre>    $ pg_repack -d testdb -t t1 --only-indexes
</pre>
<ul>
<li style="list-style-type: none;">
<ul>
<li>テーブル再編成と共にテーブルとインデックスをテーブルスペース tbs1 に移動します。</li>
</ul>
</li>
</ul>
<pre>    $ pg_repack -d testdb --tablespace tbs1 --moveidx
</pre>
<h2>注意事項</h2>
<p>pg_repack を利用する際には以下の点に注意が必要です。</p>
<ul>
<li>ディスク容量一時的な作業テーブルを作るので、対象テーブルとインデックスの 2 倍以上のディスク空き領域が必要です。PostgreSQL 9.0 以降の VACUUM FULL では、対象テーブル・インデックスと同サイズ程度の空き容量を要しましたが、それよりも更にもう一つ分が必要となることに注意してください。</li>
<li>pg_repack の実行中には、VACUUM と ANALYZE 以外の DDL を実行してはいけません。特に TRUNCATEやCREATE INDEX、ALTER TABLE を実行するとデータの整合性が崩れたり、消えてしまうことがあります。</li>
<li>実行対象テーブル対象のテーブルには、たとえ並べ替えをしない場合でも、主キー、または NOT NULL 属性とユニークインデックスを持つカラムが少なくとも一つ必須です。また、一時テーブル、または GiST インデックスがクラスタインデックスとなっているテーブルは操作の対象外です。</li>
<li>pg_repack は、データベース上のスーパーユーザ（通例 postgres ユーザ）のみが実行可能です。</li>
<li>短いタイムアウトでリトライを繰り返すようにして、排他ロックを短時間だけ取得することで、ロック待ちを回避しています。 -T （&#8211;wait-timeout）で指定するタイムアウト時間（デフォルト60秒）を超えてロック取得ができない場合には他プロセスを終了させる動作が生じます。ロック取得できなかった場合に pg_repack の方を中断させるには -D (&#8211;no-kill-backend) を指定してください。</li>
<li>pg_repack の処理過程には、ある時点で実行中のトランザクションが全て終了するのを待つ、というステップがあります。そのため、ロングトランザクション実行が並行していると、それが別のテーブルを対象にした処理であったとしても、pg_repack が長く待ってしまう可能性があります。</li>
</ul>
<h2>pg_reorg について</h2>
<p>さて、今回紹介した pg_repack ですが、これは pg_reorg というソフトウェアの開発プロジェクトから分岐したものです。現在、pg_reorg の開発は停止しており、実質 pg_repack が後継のソフトウェアとなります。</p>
<p>pg_reorg で提供されていた機能は pg_repackで網羅していることに加え、pg_repack でのみ提供している新機能もあるため、現状 pg_reorg を選択する利点はほとんどありません。しかし PostgreSQL9.0系にこれらを導入する場合は、pg_repack は動作環境としてこれを含んでいないため、pg_reorg を選択することになります。</p>
<p>pg_reorg は、バイナリパッケージは古いバージョンのみであるため、ソースコードからインストールするのが良いでしょう。pg_reorg のソースコードは <a href="https://github.com/ossc-db/pg_reorg" target="_blank" rel="noopener noreferrer">プロジェクトページ</a> からダウンロードします。ビルド手順は pg_repack と同様です。</p>
<h2>おわりに</h2>
<p>本稿では PostgreSQL のテーブルをオンラインで編集できるツール pg_repack、pg_reorg の紹介をしました。</p>
<p>何らかの事情で VACUUM が適切に行われない事態となっていたのを長期に見逃して、既にテーブル物理ファイルの肥大化が発生してしまったけれども、サービス停止できないので、VACUUM FULL コマンドは実行できないという場合の対処手段として pg_repack、pg_reorg は極めて有用といえます。</p>
<div>
<a href="https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte/?utm_source=sraoss-techblog&utm_medium=referral&utm_campaign=under-article-pgsql" rel="noopener" style="color:initial;" target="_blank" class="no-ext"></p>
<div style="background-color:#DAEFF6; padding:20px; border-radius:8px; text-align:center;">
SRA OSSでは、PostgreSQL/Pgpool-II のサポートを提供しております。<br />
詳しくは<strong style="color:#2581c4;">弊社ホームページ</strong>をご覧ください。
</div>
<p></a>
</div>

]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
