farrokhi/pg_repack
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Support reorganizing tables with non-default operator class.

Browse Source
This commit is contained in:
Takahiro Itagaki 2009-12-28 08:25:00 +00:00
parent 27e6839132
commit 038c07523a
10 changed files with 1083 additions and 957 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
Makefile
View File

@ -3,27 +3,26 @@
# #
# Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION # Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION
# #
.PHONY: all install clean ifdef USE_PGXS
PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)
else
subdir = pg_statsinfo
top_builddir = ../..
include $(top_builddir)/src/Makefile.global
endif
all: SUBDIRS = bin lib
make -C bin
make -C lib
install: all install installdirs uninstall distprep clean distclean maintainer-clean debug:
make -C bin install @for dir in $(SUBDIRS); do \
make -C lib install $(MAKE) -C $$dir $@ || exit; \
done
clean: # We'd like check operations to run all the subtests before failing.
make -C bin clean check installcheck:
make -C lib clean @CHECKERR=0; for dir in $(SUBDIRS); do \
$(MAKE) -C $$dir $@ || CHECKERR=$$?; \
debug: done; \
make -C bin DEBUG_REORG=enable exit $$CHECKERR
make -C lib DEBUG_REORG=enable
uninstall:
make -C bin uninstall
make -C lib uninstall
installcheck:
make -C bin installcheck

34
bin/expected/reorg.out
View File

@ -5,21 +5,21 @@ SET client_min_messages = warning;
CREATE TABLE tbl_cluster ( CREATE TABLE tbl_cluster (
col1 int, col1 int,
col2 timestamp, col2 timestamp,
":-)" text, ","")" text,
PRIMARY KEY (":-)", col1) PRIMARY KEY (","")", col1)
) WITH (fillfactor = 70); ) WITH (fillfactor = 70);
CREATE INDEX cidx_cluster ON tbl_cluster (col2, length(":-)")); CREATE INDEX ","") cluster" ON tbl_cluster (col2, length(","")"), ","")" text_pattern_ops);
ALTER TABLE tbl_cluster CLUSTER ON cidx_cluster; ALTER TABLE tbl_cluster CLUSTER ON ","") cluster";
CREATE TABLE tbl_only_pkey ( CREATE TABLE tbl_only_pkey (
col1 int PRIMARY KEY, col1 int PRIMARY KEY,
":-)" text ","")" text
); );
CREATE TABLE tbl_only_ckey ( CREATE TABLE tbl_only_ckey (
col1 int, col1 int,
col2 timestamp, col2 timestamp,
":-)" text ","")" text
) WITH (fillfactor = 70); ) WITH (fillfactor = 70);
CREATE INDEX cidx_only_ckey ON tbl_only_ckey (col2, ":-)"); CREATE INDEX cidx_only_ckey ON tbl_only_ckey (col2, ","")");
ALTER TABLE tbl_only_ckey CLUSTER ON cidx_only_ckey; ALTER TABLE tbl_only_ckey CLUSTER ON cidx_only_ckey;
CREATE TABLE tbl_gistkey ( CREATE TABLE tbl_gistkey (
id integer PRIMARY KEY, id integer PRIMARY KEY,
@ -83,10 +83,10 @@ SELECT * FROM tbl_with_dropped_column;
--------+-----------------------------+----------- --------+-----------------------------+-----------
col1 | integer | not null col1 | integer | not null
col2 | timestamp without time zone | col2 | timestamp without time zone |
:-) | text | not null ,") | text | not null
Indexes: Indexes:
"tbl_cluster_pkey" PRIMARY KEY, btree (":-)", col1) "tbl_cluster_pkey" PRIMARY KEY, btree (","")", col1)
"cidx_cluster" btree (col2, length(":-)")) CLUSTER ",") cluster" btree (col2, length(","")"), ","")" text_pattern_ops) CLUSTER
\d tbl_gistkey \d tbl_gistkey
Table "public.tbl_gistkey" Table "public.tbl_gistkey"
@ -104,16 +104,16 @@ Indexes:
--------+-----------------------------+----------- --------+-----------------------------+-----------
col1 | integer | col1 | integer |
col2 | timestamp without time zone | col2 | timestamp without time zone |
:-) | text | ,") | text |
Indexes: Indexes:
"cidx_only_ckey" btree (col2, ":-)") CLUSTER "cidx_only_ckey" btree (col2, ","")") CLUSTER
\d tbl_only_pkey \d tbl_only_pkey
Table "public.tbl_only_pkey" Table "public.tbl_only_pkey"
Column | Type | Modifiers Column | Type | Modifiers
--------+---------+----------- --------+---------+-----------
col1 | integer | not null col1 | integer | not null
:-) | text | ,") | text |
Indexes: Indexes:
"tbl_only_pkey_pkey" PRIMARY KEY, btree (col1) "tbl_only_pkey_pkey" PRIMARY KEY, btree (col1)
@ -130,8 +130,8 @@ Indexes:
"idx_c1c2" btree (c1, c2) "idx_c1c2" btree (c1, c2)
"idx_c2c1" btree (c2, c1) "idx_c2c1" btree (c2, c1)
SELECT col1, to_char(col2, 'YYYY-MM-DD HH24:MI:SS'), ":-)" FROM tbl_cluster; SELECT col1, to_char(col2, 'YYYY-MM-DD HH24:MI:SS'), ","")" FROM tbl_cluster;
col1 | to_char | :-) col1 | to_char | ,")
------+---------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------+---------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
2 | 2008-01-01 00:00:00 | king 2 | 2008-01-01 00:00:00 | king
5 | 2008-01-01 00:30:00 | 1.4142135623730950488016887242096980785696718753769480731766797379907324784621070388503875343276415727350138462309122970249248360558507372126441214970999358314132226659275055927557999505011527820605714701095599716059702745345968620147285174186408891986095523292304843087143214508397626036279952514079896872533965463318088296406206152583523950547457502877599617298355752203375318570113543746034084988471603868999706990048150305440277903164542478230684929369186215805784631115966687130130156185689872372352885092648612494977154218334204285686060146824720771435854874155657069677653720226485447015858801620758474922657226002085584466521458398893944370926591800311388246468157082630100594858704003186480342194897278290641045072636881313739855256117322040245091227700226941127573627280495738108967504018369868368450725799364729060762996941380475654823728997180326802474420629269124859052181004459842150591120249441341728531478105803603371077309182869314710171111683916581726889419758716582152128229518488471.732050807568877293527446341505872366942805253810380628055806979451933016908800037081146186757248575675626141415406703029969945094998952478811655512094373648528093231902305582067974820101084674923265015312343266903322886650672254668921837971227047131660367861588019049986537379859389467650347506576050756618348129606100947602187190325083145829523959832997789824508288714463832917347224163984587855397667958063818353666110843173780894378316102088305524901670023520711144288695990956365797087168498072899493296484283020786408603988738697537582317317831395992983007838702877053913369563312103707264019249106768231199288375641141422016742752102372994270831059898459475987664288897796147837958390228854852903576033852808064381972344661059689722872865264153822664698420021195484155278441181286534507035191650016689294415480846071277143999762926834629577438361895110127148638746976545982451788550975379013880664961911962222957110555242923723192197738262561631468842032853716682938649611917049738836395495938 5 | 2008-01-01 00:30:00 | 1.4142135623730950488016887242096980785696718753769480731766797379907324784621070388503875343276415727350138462309122970249248360558507372126441214970999358314132226659275055927557999505011527820605714701095599716059702745345968620147285174186408891986095523292304843087143214508397626036279952514079896872533965463318088296406206152583523950547457502877599617298355752203375318570113543746034084988471603868999706990048150305440277903164542478230684929369186215805784631115966687130130156185689872372352885092648612494977154218334204285686060146824720771435854874155657069677653720226485447015858801620758474922657226002085584466521458398893944370926591800311388246468157082630100594858704003186480342194897278290641045072636881313739855256117322040245091227700226941127573627280495738108967504018369868368450725799364729060762996941380475654823728997180326802474420629269124859052181004459842150591120249441341728531478105803603371077309182869314710171111683916581726889419758716582152128229518488471.732050807568877293527446341505872366942805253810380628055806979451933016908800037081146186757248575675626141415406703029969945094998952478811655512094373648528093231902305582067974820101084674923265015312343266903322886650672254668921837971227047131660367861588019049986537379859389467650347506576050756618348129606100947602187190325083145829523959832997789824508288714463832917347224163984587855397667958063818353666110843173780894378316102088305524901670023520711144288695990956365797087168498072899493296484283020786408603988738697537582317317831395992983007838702877053913369563312103707264019249106768231199288375641141422016742752102372994270831059898459475987664288897796147837958390228854852903576033852808064381972344661059689722872865264153822664698420021195484155278441181286534507035191650016689294415480846071277143999762926834629577438361895110127148638746976545982451788550975379013880664961911962222957110555242923723192197738262561631468842032853716682938649611917049738836395495938
@ -141,14 +141,14 @@ SELECT col1, to_char(col2, 'YYYY-MM-DD HH24:MI:SS'), ":-)" FROM tbl_cluster;
(5 rows) (5 rows)
SELECT * FROM tbl_only_ckey ORDER BY 1; SELECT * FROM tbl_only_ckey ORDER BY 1;
col1 | col2 | :-) col1 | col2 | ,")
------+--------------------------+----- ------+--------------------------+-----
1 | Tue Jan 01 00:00:00 2008 | abc 1 | Tue Jan 01 00:00:00 2008 | abc
2 | Fri Feb 01 00:00:00 2008 | def 2 | Fri Feb 01 00:00:00 2008 | def
(2 rows) (2 rows)
SELECT * FROM tbl_only_pkey ORDER BY 1; SELECT * FROM tbl_only_pkey ORDER BY 1;
col1 | :-) col1 | ,")
------+----- ------+-----
1 | abc 1 | abc
2 | def 2 | def

16
bin/sql/reorg.sql
View File

@ -5,25 +5,25 @@ SET client_min_messages = warning;
CREATE TABLE tbl_cluster ( CREATE TABLE tbl_cluster (
col1 int, col1 int,
col2 timestamp, col2 timestamp,
":-)" text, ","")" text,
PRIMARY KEY (":-)", col1) PRIMARY KEY (","")", col1)
) WITH (fillfactor = 70); ) WITH (fillfactor = 70);
CREATE INDEX cidx_cluster ON tbl_cluster (col2, length(":-)")); CREATE INDEX ","") cluster" ON tbl_cluster (col2, length(","")"), ","")" text_pattern_ops);
ALTER TABLE tbl_cluster CLUSTER ON cidx_cluster; ALTER TABLE tbl_cluster CLUSTER ON ","") cluster";
CREATE TABLE tbl_only_pkey ( CREATE TABLE tbl_only_pkey (
col1 int PRIMARY KEY, col1 int PRIMARY KEY,
":-)" text ","")" text
); );
CREATE TABLE tbl_only_ckey ( CREATE TABLE tbl_only_ckey (
col1 int, col1 int,
col2 timestamp, col2 timestamp,
":-)" text ","")" text
) WITH (fillfactor = 70); ) WITH (fillfactor = 70);
CREATE INDEX cidx_only_ckey ON tbl_only_ckey (col2, ":-)"); CREATE INDEX cidx_only_ckey ON tbl_only_ckey (col2, ","")");
ALTER TABLE tbl_only_ckey CLUSTER ON cidx_only_ckey; ALTER TABLE tbl_only_ckey CLUSTER ON cidx_only_ckey;
CREATE TABLE tbl_gistkey ( CREATE TABLE tbl_gistkey (
@ -95,7 +95,7 @@ SELECT * FROM tbl_with_dropped_column;
\d tbl_only_pkey \d tbl_only_pkey
\d tbl_with_dropped_column \d tbl_with_dropped_column
SELECT col1, to_char(col2, 'YYYY-MM-DD HH24:MI:SS'), ":-)" FROM tbl_cluster; SELECT col1, to_char(col2, 'YYYY-MM-DD HH24:MI:SS'), ","")" FROM tbl_cluster;
SELECT * FROM tbl_only_ckey ORDER BY 1; SELECT * FROM tbl_only_ckey ORDER BY 1;
SELECT * FROM tbl_only_pkey ORDER BY 1; SELECT * FROM tbl_only_pkey ORDER BY 1;
SELECT * FROM tbl_gistkey ORDER BY 1; SELECT * FROM tbl_gistkey ORDER BY 1;

23
doc/index-ja.html
View File

@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html <!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
@ -106,18 +106,19 @@ CREATE INDEX idx_rnd ON tbl (rndkey);</pre></code></td>
</table> </table>
</center> </center>
<hr />
<div align="right">
Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION
</div> </div>
<!-- PLEASE LEAVE "Powered By GForge" on your site --> <hr />
<br /> <p class="footer">Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
<center>
<a href="http://gforge.org/"><img src="http://gforge.org/images/pow-gforge.png"
alt="Powered By GForge Collaborative Development Environment" border="0" /></a>
</center>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-10244036-4");
pageTracker._trackPageview();
} catch(err) {}</script>
</body> </body>
</html> </html>

22
doc/index.html
View File

@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html <!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
@ -108,16 +108,16 @@ CREATE INDEX idx_rnd ON tbl (rndkey);</pre></code></td>
</center> </center>
<hr /> <hr />
<div align="right"> <p class="footer">Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION
</div>
<!-- PLEASE LEAVE "Powered By GForge" on your site -->
<br />
<center>
<a href="http://gforge.org/"><img src="http://gforge.org/images/pow-gforge.png"
alt="Powered By GForge Collaborative Development Environment" border="0" /></a>
</center>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-10244036-4");
pageTracker._trackPageview();
} catch(err) {}</script>
</body> </body>
</html> </html>

212
doc/pg_reorg-ja.html
View File

@ -8,45 +8,55 @@
</head> </head>
<body> <body>
<h1><a name="pg_reorg"></a>pg_reorg</h1> <h1 id="pg_reorg">pg_reorg</h1>
<div><a name="name"></a> <div class="index">
<h2>名前</h2> <ol>
pg_reorg -- PostgreSQLデータベース内のテーブルに対して、参照/更新処理をブロックせずに再編成を行います。 <li><a href="#name">名前</a></li>
<li><a href="#synopsis">概要</a></li>
<li><a href="#description">説明</a></li>
<li><a href="#examples">使用例</a></li>
<li><a href="#options">オプション</a></li>
<li><a href="#environment">環境変数</a></li>
<li><a href="#restrictions">使用上の注意と制約</a></li>
<li><a href="#details">詳細</a></li>
<li><a href="#install">インストール方法</a></li>
<li><a href="#requirement">動作環境</a></li>
<li><a href="#seealso">関連項目</a></li>
</ol>
</div> </div>
<div> <h2 id="name">名前</h2>
<a name="synopsis"></a> pg_reorg -- PostgreSQLデータベース内のテーブルに対して、参照/更新処理をブロックせずに再編成を行います。
<h2>概要</h2>
<h2 id="synopsis">概要</h2>
<p> <p>
<tt>pg_reorg</tt> [<tt><i>connection-options</i></tt>...] [<tt><i>message-options</i></tt>...] [<tt><i>order-options</i></tt>...] [<tt><i>target-options</i></tt>...] pg_reorg [connection-options...] [message-options...] [order-options...] [target-options...]
</p> </p>
<p>指定できるオプションには4つのカテゴリがあります。 <p>指定できるオプションには4つのカテゴリがあります。
詳細は<a href="#options">オプション</a>を参照してください。</p> 詳細は<a href="#options">オプション</a>を参照してください。</p>
<dl> <dl>
<dt><tt>connection-options</tt> : 接続パラメータ</dt> <dt>connection-options : 接続パラメータ</dt>
<dd><tt>-h</tt> [<tt>--host</tt>] <tt><i>host</i></tt></dd> <dd>-h [--host] host</dd>
<dd><tt>-p</tt> [<tt>--port</tt>] <tt><i>port</i></tt></dd> <dd>-p [--port] port</dd>
<dd><tt>-U</tt> [<tt>--username</tt>] <tt><i>username</i></tt></dd> <dd>-U [--username] username</dd>
<dd><tt>-W</tt> [<tt>--password</tt>]</dd> <dd>-W [--password]</dd>
<dt><tt>message-options</tt> : 出力メッセージ</dt> <dt>message-options : 出力メッセージ</dt>
<dd><tt>-q</tt> [<tt>--quiet</tt>]</dd> <dd>-q [--quiet]</dd>
<dd><tt>-v</tt> [<tt>--verbose</tt>]</dd> <dd>-v [--verbose]</dd>
<dt><tt>order-options</tt> : 並び替えの基準</dt> <dt>order-options : 並び替えの基準</dt>
<dd><tt>-o</tt> [<tt>--order-by</tt>] <tt><i>columns [,...]</i></tt></dd> <dd>-o [--order-by] columns [,...]</dd>
<dd><tt>-n</tt> [<tt>--no-order</tt>]</dd> <dd>-n [--no-order]</dd>
<dt><tt>target-options</tt> : 処理対象</dt> <dt>target-options : 処理対象</dt>
<dd><tt>-a</tt> [<tt>--all</tt>]</dd> <dd>-a [--all]</dd>
<dd><tt>-d</tt> [<tt>--dbname</tt>] <tt><i>dbname</i></tt></dd> <dd>-d [--dbname] dbname</dd>
<dd><tt>-t</tt> [<tt>--table</tt>] <tt><i>table</i></tt></dd> <dd>-t [--table] table</dd>
<dd><tt>-Z</tt> [<tt>--no-analyze</tt>]</dd> <dd>-Z [--no-analyze]</dd>
</dl> </dl>
</div>
<div><a name="description"></a> <h2 id="description">説明</h2>
<h2>説明</h2>
<p>pg_reorg は、PostgreSQLデータベース内のテーブルを再編成(行の並び替え)するユーティリティです。 <p>pg_reorg は、PostgreSQLデータベース内のテーブルを再編成(行の並び替え)するユーティリティです。
<a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html"><tt>clusterdb</tt></a> と異なり、参照/更新処理をブロックしません。 <a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html">clusterdb</a> と異なり、参照/更新処理をブロックしません。
再編成の方式として、以下のいずれか1つを選択できます。</p> 再編成の方式として、以下のいずれか1つを選択できます。</p>
<ul> <ul>
<li>オンライン CLUSTER (cluster index順に行を並び替える)</li> <li>オンライン CLUSTER (cluster index順に行を並び替える)</li>
@ -58,58 +68,51 @@ pg_reorg -- PostgreSQLデータベース内のテーブルに対して、参照/
<li>このユーティリティは、スーパーユーザのみが実行することができます。</li> <li>このユーティリティは、スーパーユーザのみが実行することができます。</li>
<li>対象のテーブルはPRIMARY KEYを持っている必要があります。</li> <li>対象のテーブルはPRIMARY KEYを持っている必要があります。</li>
</ul> </ul>
</div>
<div><a name="examples"></a> <h2 id="examples">例</h2>
<h2>例</h2> <p>testというデータベースをオンライン CLUSTER するには、下記のコマンドを実行します。</p>
<p><tt>test</tt>というデータベースをオンライン CLUSTER するには、下記のコマンドを実行します。</p>
<PRE><SAMP>$ </SAMP><KBD>pg_reorg test</KBD></PRE> <PRE><SAMP>$ </SAMP><KBD>pg_reorg test</KBD></PRE>
<p><tt>test</tt>という名前のデータベースの<tt>foo</tt>という1つのテーブルに対してオンライン VACUUM FULL を行うには、下記のコマンドを実行します。</p> <p>testという名前のデータベースのfooという1つのテーブルに対してオンライン VACUUM FULL を行うには、下記のコマンドを実行します。</p>
<PRE><SAMP>$ </SAMP><KBD>pg_reorg --no-order --table foo -d test</KBD></PRE><p> <PRE><SAMP>$ </SAMP><KBD>pg_reorg --no-order --table foo -d test</KBD></PRE><p>
</p> </p>
</div>
<div><a name="options"></a> <h2 id="options">オプション</h2>
<h2>オプション</h2>
<p>pg_reorg では、下記の4種類のコマンドライン引数を指定できます。</p> <p>pg_reorg では、下記の4種類のコマンドライン引数を指定できます。</p>
<div>
<dl> <dl>
<h3>connection-options</h3> <h3>connection-options</h3>
<p>PostgreSQLに接続するためのパラメータです。</p> <p>PostgreSQLに接続するためのパラメータです。</p>
<div>
<dl> <dl>
<dt><tt>-h <tt><i>host</i></tt><br /> <dt>-h host<br />
<tt>--host <tt><i>host</i></tt></dt> --host host</dt>
<dd>サーバが稼働しているマシンのホスト名を指定します。ホスト名がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。</dd> <dd>サーバが稼働しているマシンのホスト名を指定します。ホスト名がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。</dd>
<dt><tt>-p <tt><i>port</i></tt><br /> <dt>-p port<br />
<tt>--port <tt><i>port</i></tt></dt> --port port</dt>
<dd>サーバが接続を監視するTCPポートもしくはUnixドメインソケットファイルの拡張子を指定します。</dd> <dd>サーバが接続を監視するTCPポートもしくはUnixドメインソケットファイルの拡張子を指定します。</dd>
<dt><tt>-U <tt><i>username</i></tt><br /> <dt>-U username<br />
<tt>--username <tt><i>username</i></tt></dt> --username username</dt>
<dd>接続するユーザ名を指定します。</dd> <dd>接続するユーザ名を指定します。</dd>
<dt><tt>-W</tt><br /><tt>--password</tt></dt> <dt>-W<br />--password</dt>
<dd>データベースに接続する前に、pg_reorg は強制的にパスワード入力を促します。</dd> <dd>データベースに接続する前に、pg_reorg は強制的にパスワード入力を促します。</dd>
<dd>サーバがパスワード認証を要求する場合 pg_reorg は自動的にパスワード入力を促しますので、これが重要になることはありません。 <dd>サーバがパスワード認証を要求する場合 pg_reorg は自動的にパスワード入力を促しますので、これが重要になることはありません。
しかし、pg_reorg は、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。 しかし、pg_reorg は、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。
こうした余計な接続試行を防ぐために<tt>-W</tt>の入力が有意となる場合もあります。</dd> こうした余計な接続試行を防ぐために-Wの入力が有意となる場合もあります。</dd>
</dl> </dl>
</div>
<h3>message-options</h3> <h3>message-options</h3>
<p> <p>
pg_reorg を実行した際に任意のメッセージを出力するためのパラメータです。 pg_reorg を実行した際に任意のメッセージを出力するためのパラメータです。
<tt>--quiet</tt>と他の2つのオプションを同時に指定した場合は、<tt>--quiet</tt>のオプションは無視されます。 --quietと他の2つのオプションを同時に指定した場合は、--quietのオプションは無視されます。
</p> </p>
<dl> <dl>
<dt><tt>-q</tt><br /><tt>--quiet</tt></dt> <dt>-q<br />--quiet</dt>
<dd>進行メッセージを表示しません。</dd> <dd>進行メッセージを表示しません。</dd>
<dt><tt>-v</tt><br /><tt>--verbose</tt></dt> <dt>-v<br />--verbose</dt>
<dd>処理中に詳細な情報を表示します。</dd> <dd>処理中に詳細な情報を表示します。</dd>
</dl> </dl>
@ -120,67 +123,63 @@ pg_reorg を実行した際に任意のメッセージを出力するための
</p> </p>
<dl> <dl>
<dt><tt>-n</tt><br /><tt>--no-order</tt></dt> <dt>-n<br />--no-order</dt>
<dd>オンライン VACUUM FULL の処理を行います。</dd> <dd>オンライン VACUUM FULL の処理を行います。</dd>
<dt><tt>-o</tt> <tt><i>columns [,...]</i></tt><br /> <dt>-o columns [,...]<br />
<tt>--order-by</tt> <tt><i>columns [,...]</i></tt></dt> --order-by columns [,...]</dt>
<dd>指定したカラムをキーにオンライン CLUSTER を行います。</dd> <dd>指定したカラムをキーにオンライン CLUSTER を行います。</dd>
</dl> </dl>
<h3>target-options</h3> <h3>target-options</h3>
<p> <p>
pg_reorg を実行する対象を指定するパラメータです。 pg_reorg を実行する対象を指定するパラメータです。
<tt>--all</tt>と<tt>--dbname</tt>または<tt>--table</tt>を同時に指定することはできません。 --allと--dbnameまたは--tableを同時に指定することはできません。
</p> </p>
<dl> <dl>
<dt><tt>-a</tt><br /><tt>--all</tt></dt> <dt>-a<br />--all</dt>
<dd>対象となる全てのデータベースに対してオンライン CLUSTER、または、オンラインVACUUM FULLを行います。</dd> <dd>対象となる全てのデータベースに対してオンライン CLUSTER、または、オンラインVACUUM FULLを行います。</dd>
<dt> <dt>
<tt>-d <tt><i>dbname</i></tt><br /> -d dbname<br />
<tt>--dbname <tt><i>dbname</i></tt> --dbname dbname
</dt> </dt>
<dd>オンライン CLUSTER、または、オンライン VACUUM FULL を行うデータベース名を指定します。 <dd>オンライン CLUSTER、または、オンライン VACUUM FULL を行うデータベース名を指定します。
データベース名が指定されておらず、<tt>-a</tt>（または<tt>--all</tt>）も指定されていない場合、 データベース名が指定されておらず、-a（または--all）も指定されていない場合、
データベース名は<tt>PGDATABASE</tt>環境変数から読み取られます。この変数も設定されていない場合は、接続時に指定したユーザ名が使用されます。 データベース名はPGDATABASE環境変数から読み取られます。この変数も設定されていない場合は、接続時に指定したユーザ名が使用されます。
</dd> </dd>
<dt> <dt>
<tt>-t</tt> <tt><i>table</i></tt><br /> -t table<br />
<tt>--table</tt> <tt><i>table</i></tt> --table table
</dt> </dt>
<dd>オンライン CLUSTER 、または、オンライン VACUUM FULL を行うテーブルを指定します。 <dd>オンライン CLUSTER 、または、オンライン VACUUM FULL を行うテーブルを指定します。
このオプションが指定されていない場合は、対象となったデータベースに存在する全ての対象テーブルに対して処理を行います。 このオプションが指定されていない場合は、対象となったデータベースに存在する全ての対象テーブルに対して処理を行います。
</dd> </dd>
<dt><tt>-Z</tt><br /><tt>--no-analyze</tt></dt> <dt>-Z<br />--no-analyze</dt>
<dd>再編成後に ANALYZE を行いません。 <dd>再編成後に ANALYZE を行いません。
このオプションが指定されていない場合は、再編成後に ANALYZE します。</dd> このオプションが指定されていない場合は、再編成後に ANALYZE します。</dd>
</dl> </dl>
</div>
<div><a name="environment"></a> <h2 id="environment">環境変数</h2>
<h2>環境変数</h2> <div>
<dl> <dl>
<dt> <dt>
<tt>PGDATABASE</tt><br /> PGDATABASE<br />
<tt>PGHOST</tt><br /> PGHOST<br />
<tt>PGPORT</tt><br /> PGPORT<br />
<tt>PGUSER</tt> PGUSER
</dt> </dt>
<dd>デフォルトの接続パラメータです。</dd> <dd>デフォルトの接続パラメータです。</dd>
</dl> </dl>
</div>
<p>また、このユーティリティは、他のほとんどの PostgreSQL ユーティリティと同様、
libpq でサポートされる環境変数を使用します。詳細については、<a href="http://www.postgresql.jp/document/current/html/libpq-envars.html">環境変数の項目</a>を参照してください。
</p>
</div>
<div><a name="diagnostics"></a> <p>
<h2>トラブルシューティング</h2> また、このユーティリティは、他のほとんどの PostgreSQL ユーティリティと同様、libpq でサポートされる環境変数を使用します。詳細については、<a href="http://www.postgresql.jp/document/current/html/libpq-envars.html">環境変数の項目</a>を参照してください。
</p>
<h2 id="diagnostics">トラブルシューティング</h2>
<p>pg_reorg の実行に失敗した場合にエラーが表示されます。 <p>pg_reorg の実行に失敗した場合にエラーが表示されます。
想像されるエラー原因と対処を示します。</p> 想像されるエラー原因と対処を示します。</p>
<p>致命的なエラーで終了した場合、手動によるクリーンアップを行う必要があります。 <p>致命的なエラーで終了した場合、手動によるクリーンアップを行う必要があります。
@ -188,11 +187,11 @@ pg_reorg を実行する対象を指定するパラメータです。
<dl> <dl>
<dt>pg_reorg : reorg database "template1" ... skipped</dt> <dt>pg_reorg : reorg database "template1" ... skipped</dt>
<dd><tt>--all</tt>オプションを指定した際に、pg_reorg がインストールされていないデータベースに対して表示されます。</dd> <dd>--allオプションを指定した際に、pg_reorg がインストールされていないデータベースに対して表示されます。</dd>
<dd>pg_reorg スキーマのインストールを行ってください。</dd> <dd>pg_reorg スキーマのインストールを行ってください。</dd>
<dt>ERROR: pg_reorg is not installed</dt> <dt>ERROR: pg_reorg is not installed</dt>
<dd><tt>--dbname</tt>で指定したデータベースにpg_reorg がインストールされていません。</dd> <dd>--dbnameで指定したデータベースにpg_reorg がインストールされていません。</dd>
<dd>pg_reorg のインストールを行ってください。</dd> <dd>pg_reorg のインストールを行ってください。</dd>
<dt>ERROR: relation "table" has no primary key</dt> <dt>ERROR: relation "table" has no primary key</dt>
@ -204,7 +203,7 @@ pg_reorg を実行する対象を指定するパラメータです。
<dd>対象のテーブルに CLUSTER KEYの作成を行ってください。(ALTER TABLE CLUSTER)</dd> <dd>対象のテーブルに CLUSTER KEYの作成を行ってください。(ALTER TABLE CLUSTER)</dd>
<dt>pg_reorg : query failed: ERROR: column "col" does not exist</dt> <dt>pg_reorg : query failed: ERROR: column "col" does not exist</dt>
<dd><tt>--order-by</tt> で指定したカラムが対象のテーブルに存在していません。</dd> <dd>--order-by で指定したカラムが対象のテーブルに存在していません。</dd>
<dd>対象のテーブルに存在するカラムを指定してください。</dd> <dd>対象のテーブルに存在するカラムを指定してください。</dd>
<dt>ERROR: permission denied for schema reorg</dt> <dt>ERROR: permission denied for schema reorg</dt>
@ -219,10 +218,8 @@ pg_reorg を実行する対象を指定するパラメータです。
<dd>操作を行おうとした対象にpg_reorg が処理のために作成するトリガより後に実行されるトリガが存在しています。</dd> <dd>操作を行おうとした対象にpg_reorg が処理のために作成するトリガより後に実行されるトリガが存在しています。</dd>
<dd>トリガの改名か削除を行ってください。</dd> <dd>トリガの改名か削除を行ってください。</dd>
</dl> </dl>
</div>
<div><a name="restrictions"></a> <h2 id="restrictions">使用上の注意と制約</h2>
<h2>制約</h2>
<p>pg_reorg を使用する際には、以下の制約があります。以下の制約に関する操作を行った場合の動作は保証されません。注意してください。</p> <p>pg_reorg を使用する際には、以下の制約があります。以下の制約に関する操作を行った場合の動作は保証されません。注意してください。</p>
<h3>一時テーブルへの操作</h3> <h3>一時テーブルへの操作</h3>
@ -231,63 +228,66 @@ pg_reorg を実行する対象を指定するパラメータです。
<h3>GiSTインデックスの使用</h3> <h3>GiSTインデックスの使用</h3>
<p>インデックス種別がGiSTとなっているインデックスがクラスタインデックスとなっている <p>インデックス種別がGiSTとなっているインデックスがクラスタインデックスとなっている
テーブルはpg_reorg コマンドを使用して操作を行うことはできません。 テーブルはpg_reorg コマンドを使用して操作を行うことはできません。
これは、GiSTインデックスのソート順序は一意ではないため、<tt>ORDER BY</tt>による これは、GiSTインデックスのソート順序は一意ではないため、ORDER BYによる
ソートが行えないためです。</p> ソートが行えないためです。</p>
<h3>DDLコマンドの発行</h3> <h3>DDLコマンドの発行</h3>
<p> <p>
pg_reorg の実行中には、<tt>VACUUM</tt> と <tt>ANALYZE</tt> <STRONG>以外</STRONG> のDDL操作は行わないでください。 pg_reorg の実行中には、VACUUM と ANALYZE <STRONG>以外</STRONG> のDDL操作は行わないでください。
多くの場合、pg_reorg は失敗しロールバックされます。 多くの場合、pg_reorg は失敗しロールバックされます。
しかし、以下の操作ではデータが破損するため、非常に危険です。 しかし、以下の操作ではデータが破損するため、非常に危険です。
</p> </p>
<dl> <dl>
<dt><tt>TRUNCATE</tt></dt> <dt>TRUNCATE</dt>
<dd>削除した行が pg_reorg 実行後には復元しています。操作結果が消失します。</dd> <dd>削除した行が pg_reorg 実行後には復元しています。操作結果が消失します。</dd>
<dt><tt>CREATE INDEX</tt></dt> <dt>CREATE INDEX</dt>
<dd>スワップされない索引が残る可能性があります。データの不整合が生じます。</dd> <dd>スワップされない索引が残る可能性があります。データの不整合が生じます。</dd>
<dt><tt>ALTER TABLE ... ADD COLUMN</tt></dt> <dt>ALTER TABLE ... ADD COLUMN</dt>
<dd>追加された値が全てNULLに置換されてしまう可能性があります。データが消失します。</dd> <dd>追加された値が全てNULLに置換されてしまう可能性があります。データが消失します。</dd>
<dt><tt>ALTER TABLE ... ALTER COLUMN TYPE</tt></dt> <dt>ALTER TABLE ... ALTER COLUMN TYPE</dt>
<dd>実行するとスキーマで定義された型と実際の格納状態に齟齬をきたします。データの不整合が生じます。</dd> <dd>実行するとスキーマで定義された型と実際の格納状態に齟齬をきたします。データの不整合が生じます。</dd>
<dt><tt>ALTER TABLE ... SET TABLESPACE</tt></dt> <dt>ALTER TABLE ... SET TABLESPACE</dt>
<dd>pg_reorg 実行後にrelfilenodeとの不整合が起こるため、対象のテーブルに対する参照/更新操作時にエラーが発生します。</dd> <dd>pg_reorg 実行後にrelfilenodeとの不整合が起こるため、対象のテーブルに対する参照/更新操作時にエラーが発生します。</dd>
</dl> </dl>
</div>
<div><a name="install"></a> <h2 id="details">詳細</h2>
<h2>インストール方法</h2> <p>pg_reorg は reorg スキーマに作業用テーブルを作成し、そこでデータの並び替えを行います。
最後にシステムカタログを直接書き換えることで、元のテーブルと名前を交換しています。</p>
<h2 id="install">インストール方法</h2>
<p>pg_reorg のインストールは、標準のcontribモジュールと同様です。</p> <p>pg_reorg のインストールは、標準のcontribモジュールと同様です。</p>
<h3>ビルド</h3> <h3>ビルド</h3>
<p>pg_reorg のフォルダを$PGHOME/contrib/に配置し、make, make installを行ってください。</p> <p>pg_reorg のフォルダを$PGHOME/contrib/に配置し、make, make installを行ってください。</p>
<h3>データベースへの登録</h3> <h3>データベースへの登録</h3>
<p>PostgreSQLを起動し、対象のデータベースに対して $PGHOME/share/contrib にある pg_reorg.sql を実行し、インストールを行ってください。</p> <p>PostgreSQLを起動し、対象のデータベースに対して $PGHOME/share/contrib にある pg_reorg.sql を実行し、インストールを行ってください。</p>
</div>
<div><a name="requirement"></a> <h2 id="requirement">動作環境</h2>
<h2>動作環境</h2>
<dl> <dl>
<dt>PostgreSQLバージョン</dt><dd>PostgreSQL 8.3</dd> <dt>PostgreSQLバージョン</dt><dd>PostgreSQL 8.3</dd>
<dt>OS</dt><dd>RHEL 5.2, Windows XP SP3</dd> <dt>OS</dt><dd>RHEL 5.2, Windows XP SP3</dd>
<dt>ディスク容量</dt><dd>処理対象のテーブル、インデックスサイズの2倍以上のディスク空き容量</dd> <dt>ディスク容量</dt><dd>処理対象のテーブル、インデックスサイズの2倍以上のディスク空き容量</dd>
</dl> </dl>
</div>
<div><a name="seealso"></a> <h2 id="seealso">関連項目</h2>
<h2>関連項目</h2> <a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html">clusterdb</a>,
<a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html"><i><tt>clusterdb</tt></i></a>, <a href="http://www.postgresql.jp/document/current/html/app-vacuumdb.html">vacuumdb</a>
<a href="http://www.postgresql.jp/document/current/html/app-vacuumdb.html"><i><tt>vacuumdb</tt></i></a>
</div>
<hr> <hr />
<p class="footer">Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
<p align="right"><font size="2">
Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION
</font></p>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-10244036-4");
pageTracker._trackPageview();
} catch(err) {}</script>
</body> </body>
</html> </html>

204
doc/pg_reorg.html
View File

@ -8,45 +8,55 @@
</head> </head>
<body> <body>
<h1><a name="pg_reorg"></a>pg_reorg</h1> <h1 id="pg_reorg">pg_reorg</h1>
<div><a name="name"></a> <div class="index">
<h2>Name</h2> <ol>
pg_reorg -- Reorganize tables in PostgreSQL databases without any locks. <li><a href="#name">Name</a></li>
<li><a href="#synopsis">Synopsis</a></li>
<li><a href="#description">Description</a></li>
<li><a href="#examples">Examples</a></li>
<li><a href="#options">Options</a></li>
<li><a href="#environment">Environment</a></li>
<li><a href="#restrictions">Restrictions</a></li>
<li><a href="#details">Details</a></li>
<li><a href="#install">Installations</a></li>
<li><a href="#requirement">Requirements</a></li>
<li><a href="#seealso">See Also</a></li>
</ol>
</div> </div>
<div><a name="synopsis"></a> <h2 id="name">Name</h2>
<h2>Synopsis</h2> pg_reorg -- Reorganize tables in PostgreSQL databases without any locks.
<h2 id="synopsis">Synopsis</h2>
<p> <p>
<tt>pg_reorg</tt> [<tt><i>connection-options</i></tt>...] [<tt><i>message-options</i></tt>...] [<tt><i>order-options</i></tt>...] [<tt><i>target-options</i></tt>...] pg_reorg [connection-options...] [message-options...] [order-options...] [target-options...]
</p> </p>
<p>There 4 option categories. <p>There 4 option categories.
See also <a href="#options">options</a> for details.</p> See also <a href="#options">options</a> for details.</p>
<dl> <dl>
<dt><tt>connection-options</tt></dt> <dt>connection-options</dt>
<dd><tt>-h</tt> [<tt>--host</tt>] <tt><i>host</i></tt></dd> <dd>-h [--host] host</dd>
<dd><tt>-p</tt> [<tt>--port</tt>] <tt><i>port</i></tt></dd> <dd>-p [--port] port</dd>
<dd><tt>-U</tt> [<tt>--username</tt>] <tt><i>username</i></tt></dd> <dd>-U [--username] username</dd>
<dd><tt>-W</tt> [<tt>--password</tt>]</dd> <dd>-W [--password]</dd>
<dt><tt>message-options</tt></dt> <dt>message-options</dt>
<dd><tt>-q</tt> [<tt>--quiet</tt>]</dd> <dd>-q [--quiet]</dd>
<dd><tt>-v</tt> [<tt>--verbose</tt>]</dd> <dd>-v [--verbose]</dd>
<dt><tt>order-options</tt></dt> <dt>order-options</dt>
<dd><tt>-o</tt> [<tt>--order-by</tt>] <tt><i>columns [,...]</i></tt></dd> <dd>-o [--order-by] columns [,...]</dd>
<dd><tt>-n</tt> [<tt>--no-order</tt>]</dd> <dd>-n [--no-order]</dd>
<dt><tt>target-options</tt></dt> <dt>target-options</dt>
<dd><tt>-a</tt> [<tt>--all</tt>]</dd> <dd>-a [--all]</dd>
<dd><tt>-d</tt> [<tt>--dbname</tt>] <tt><i>dbname</i></tt></dd> <dd>-d [--dbname] dbname</dd>
<dd><tt>-t</tt> [<tt>--table</tt>] <tt><i>table</i></tt></dd> <dd>-t [--table] table</dd>
<dd><tt>-Z</tt> [<tt>--no-analyze</tt>]</dd> <dd>-Z [--no-analyze]</dd>
</dl> </dl>
</div>
<div> <h2 id="description">Description</h2>
<a name="description"></a>
<h2>Description</h2>
<p>pg_reorg is an utility program to reorganize tables in PostgreSQL databases. <p>pg_reorg is an utility program to reorganize tables in PostgreSQL databases.
Unlike <a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html"><tt>clusterdb</tt></a>, it doesn't block any selections and updates during reorganization. Unlike <a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html">clusterdb</a>, it doesn't block any selections and updates during reorganization.
You can choose one of the following methods to reorganize.</p> You can choose one of the following methods to reorganize.</p>
<ul> <ul>
<li>Online CLUSTER (ordered by cluster index)</li> <li>Online CLUSTER (ordered by cluster index)</li>
@ -58,18 +68,15 @@ You can choose one of the following methods to reorganize.</p>
<li>Only superusers can use the utility.</li> <li>Only superusers can use the utility.</li>
<li>Target table must have PRIMARY KEY.</li> <li>Target table must have PRIMARY KEY.</li>
</ul> </ul>
</div>
<div><a name="examples"></a> <h2 id="examples">Examples</h2>
<h2>Examples</h2> <p>Execute the following command to do online CLUSTER to all tables in test database.</p>
<p>Execute the following command to do online CLUSTER to all tables in <tt>test</tt> database.</p>
<PRE><SAMP>$ </SAMP><KBD>pg_reorg test</KBD></PRE> <PRE><SAMP>$ </SAMP><KBD>pg_reorg test</KBD></PRE>
<p>Execute the following command to do online VACUUM FULL to <tt>foo</tt> table in <tt>test</tt> database.</p> <p>Execute the following command to do online VACUUM FULL to foo table in test database.</p>
<PRE><SAMP>$ </SAMP><KBD>pg_reorg --no-order --table foo -d test</KBD></PRE><p> <PRE><SAMP>$ </SAMP><KBD>pg_reorg --no-order --table foo -d test</KBD></PRE><p>
</p></div> </p>
<div><a name="options"></a> <h2 id="options">Options</h2>
<h2>Options</h2>
<p>pg_reorg has command line options in 4 categolies.</p> <p>pg_reorg has command line options in 4 categolies.</p>
<div> <div>
<dl> <dl>
@ -79,32 +86,31 @@ You can choose one of the following methods to reorganize.</p>
<div> <div>
<dl> <dl>
<dt><tt>-h <tt><i>host</i></tt><br /> <dt>-h host<br />
<tt>--host <tt><i>host</i></tt></dt> --host host</dt>
<dd>Specifies the host name of the machine on which the server is running. If the value begins with a slash, it is used as the directory for the Unix domain socket. </dd> <dd>Specifies the host name of the machine on which the server is running. If the value begins with a slash, it is used as the directory for the Unix domain socket. </dd>
<dt><tt>-p <tt><i>port</i></tt><br /> <dt>-p port<br />
<tt>--port <tt><i>port</i></tt></dt> --port port</dt>
<dd>Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections.</dd> <dd>Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections.</dd>
<dt><tt>-U <tt><i>username</i></tt><br /> <dt>-U username<br />
<tt>--username <tt><i>username</i></tt></dt> --username username</dt>
<dd>User name to connect as. </dd> <dd>User name to connect as. </dd>
<dt><tt>-W</tt><br /><tt>--password</tt></dt> <dt>-W<br />--password</dt>
<dd>Force pg_reorg to prompt for a password before connecting to a database.</dd> <dd>Force pg_reorg to prompt for a password before connecting to a database.</dd>
<dd>This option is never essential, since pg_reorg will automatically prompt for a password if the server demands password authentication. However, vacuumdb will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing <tt>-W</tt> to avoid the extra connection attempt. </dd> <dd>This option is never essential, since pg_reorg will automatically prompt for a password if the server demands password authentication. However, vacuumdb will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing -W to avoid the extra connection attempt. </dd>
</dl> </dl>
</div>
<h3>message-options</h3> <h3>message-options</h3>
<p>Specifies message output by pg_reorg. <p>Specifies message output by pg_reorg.
<tt>--quiet</tt> is ignored if some of the other options are specified.</p> --quiet is ignored if some of the other options are specified.</p>
<dl> <dl>
<dt><tt>-q</tt><br /><tt>--quiet</tt></dt> <dt>-q<br />--quiet</dt>
<dd>Do not display progress messages. </dd> <dd>Do not display progress messages. </dd>
<dt><tt>-v</tt><br /><tt>--verbose</tt></dt> <dt>-v<br />--verbose</dt>
<dd>Print detailed information during processing.</dd> <dd>Print detailed information during processing.</dd>
</dl> </dl>
@ -115,11 +121,11 @@ Only one option can be specified.
</p> </p>
<dl> <dl>
<dt><tt>-n</tt><br /><tt>--no-order</tt></dt> <dt>-n<br />--no-order</dt>
<dd>Do online VACUUM FULL.</dd> <dd>Do online VACUUM FULL.</dd>
<dt><tt>-o</tt> <tt><i>columns [,...]</i></tt><br /> <dt>-o columns [,...]<br />
<tt>--order-by</tt> <tt><i>columns [,...]</i></tt></dt> --order-by columns [,...]</dt>
<dd>Do online CLUSTER ordered by specified columns.</dd> <dd>Do online CLUSTER ordered by specified columns.</dd>
</dl> </dl>
@ -127,48 +133,43 @@ Only one option can be specified.
<h3>target-options</h3> <h3>target-options</h3>
<p> <p>
Options to specify target tables or databases. Options to specify target tables or databases.
You cannot use <tt>--all</tt> and <tt>--dbname</tt> or <tt>--table</tt> together. You cannot use --all and --dbname or --table together.
</p> </p>
<dl> <dl>
<dt><tt>-a</tt><br /><tt>--all</tt></dt> <dt>-a<br />--all</dt>
<dd>Reorganize all databases.</dd> <dd>Reorganize all databases.</dd>
<dt> <dt>
<tt>-d <tt><i>dbname</i></tt><br /> -d dbname<br />
<tt>--dbname <tt><i>dbname</i></tt> --dbname dbname
</dt> </dt>
<dd>Specifies the name of the database to be reorganized. If this is not specified and <tt>-a</tt> (or <tt>--all</tt>) is not used, the database name is read from the environment variable <tt>PGDATABASE</tt>. If that is not set, the user name specified for the connection is used. </dd> <dd>Specifies the name of the database to be reorganized. If this is not specified and -a (or --all) is not used, the database name is read from the environment variable PGDATABASE. If that is not set, the user name specified for the connection is used. </dd>
<dt> <dt>
<tt>-t</tt> <tt><i>table</i></tt><br /> -t table<br />
<tt>--table</tt> <tt><i>table</i></tt> --table table
</dt> </dt>
<dd>Reorganize <tt><i>table</i></tt> only. If you don't specify this option, all tables in specified databases are reorganized.</dd> <dd>Reorganize table only. If you don't specify this option, all tables in specified databases are reorganized.</dd>
<dt><tt>-Z</tt><br /><tt>--no-analyze</tt></dt> <dt>-Z<br />--no-analyze</dt>
<dd>Do ANALYZE after reorganization. If you don't specify this option, ANALYZE is performed automatically after reorg.</dd> <dd>Do ANALYZE after reorganization. If you don't specify this option, ANALYZE is performed automatically after reorg.</dd>
</dl> </dl>
</div>
<div><a name="environment"></a> <h2 id="environment">Environment</h2>
<h2>Environment</h2> <div>
<dl> <dl>
<dt> <dt>
<tt>PGDATABASE</tt><br /> PGDATABASE<br />
<tt>PGHOST</tt><br /> PGHOST<br />
<tt>PGPORT</tt><br /> PGPORT<br />
<tt>PGUSER</tt> PGUSER
</dt> </dt>
<dd>Default connection parameters</dd> <dd>Default connection parameters</dd>
</dl> </dl>
</div>
<p>This utility, like most other PostgreSQL utilities, also uses the environment variables supported by libpq (see <a href="http://developer.postgresql.org/pgdocs/postgres/libpq-envars.html">Environment Variables</a>).</p> <p>This utility, like most other PostgreSQL utilities, also uses the environment variables supported by libpq (see <a href="http://developer.postgresql.org/pgdocs/postgres/libpq-envars.html">Environment Variables</a>).</p>
</div>
<div><a name="diagnostics"></a> <h2 id="diagnostics">Diagnostics</h2>
<h2>Diagnostics</h2>
<p>Error messages are reported when pg_reorg fails. <p>Error messages are reported when pg_reorg fails.
The following list shows the cause of errors.</p> The following list shows the cause of errors.</p>
<p>You need to cleanup by hand after fatal erros. <p>You need to cleanup by hand after fatal erros.
@ -176,11 +177,11 @@ To cleanup, execute $PGHOME/share/contrib/uninstall_pg_reorg.sql to the database
<dl> <dl>
<dt>pg_reorg : reorg database "template1" ... skipped</dt> <dt>pg_reorg : reorg database "template1" ... skipped</dt>
<dd>pg_reorg is not installed in the database when <tt>--all</tt> option is specified.</dd> <dd>pg_reorg is not installed in the database when --all option is specified.</dd>
<dd>Do register pg_reorg to the database.</dd> <dd>Do register pg_reorg to the database.</dd>
<dt>ERROR: pg_reorg is not installed</dt> <dt>ERROR: pg_reorg is not installed</dt>
<dd>pg_reorg is not installed in the database specified by <tt>--dbname</tt>.</dd> <dd>pg_reorg is not installed in the database specified by --dbname.</dd>
<dd>Do register pg_reorg to the database.</dd> <dd>Do register pg_reorg to the database.</dd>
<dt>ERROR: relation "table" has no primary key</dt> <dt>ERROR: relation "table" has no primary key</dt>
@ -192,7 +193,7 @@ To cleanup, execute $PGHOME/share/contrib/uninstall_pg_reorg.sql to the database
<dd>Define CLUSTER KEY to the table. (ALTER TABLE CLUSTER)</dd> <dd>Define CLUSTER KEY to the table. (ALTER TABLE CLUSTER)</dd>
<dt>pg_reorg : query failed: ERROR: column "col" does not exist</dt> <dt>pg_reorg : query failed: ERROR: column "col" does not exist</dt>
<dd>The target table doesn't have columns specified by <tt>--order-by</tt> option.</dd> <dd>The target table doesn't have columns specified by --order-by option.</dd>
<dd>Specify existing columns.</dd> <dd>Specify existing columns.</dd>
<dt>ERROR: permission denied for schema reorg</dt> <dt>ERROR: permission denied for schema reorg</dt>
@ -207,10 +208,8 @@ To cleanup, execute $PGHOME/share/contrib/uninstall_pg_reorg.sql to the database
<dd>The target table already has a trigger which follows by "z_reorg_trigger" in alphabetical order.</dd> <dd>The target table already has a trigger which follows by "z_reorg_trigger" in alphabetical order.</dd>
<dd>Delete or rename the trigger.</dd> <dd>Delete or rename the trigger.</dd>
</dl> </dl>
</div>
<div><a name="restrictions"></a> <h2 id="restrictions">Restrictions</h2>
<h2>Restrictions</h2>
<p>pg_reorg has the following restrictions. <p>pg_reorg has the following restrictions.
Be careful to avoid data corruptions.</p> Be careful to avoid data corruptions.</p>
@ -221,56 +220,59 @@ Be careful to avoid data corruptions.</p>
<p>pg_reorg cannot reorganize tables using GiST indexes.</p> <p>pg_reorg cannot reorganize tables using GiST indexes.</p>
<h3>DDL commands</h3> <h3>DDL commands</h3>
<p>You cannot do DDL commands <strong>except</strong> <tt>VACUUM</tt> and <tt>ANALYZE</tt> during pg_reorg. <p>You cannot do DDL commands <strong>except</strong> VACUUM and ANALYZE during pg_reorg.
In many case pg_reorg would fail and rollback collectly, but there are some cases ending with data-corruption .</p> In many case pg_reorg would fail and rollback collectly, but there are some cases ending with data-corruption .</p>
<dl> <dl>
<dt><tt>TRUNCATE</tt></dt> <dt>TRUNCATE</dt>
<dd><tt>TRUNCATE</tt> is lost. Deleted rows still exist after pg_reorg.</dd> <dd>TRUNCATE is lost. Deleted rows still exist after pg_reorg.</dd>
<dt><tt>CREATE INDEX</tt></dt> <dt>CREATE INDEX</dt>
<dd>It causes index corruptions.</dd> <dd>It causes index corruptions.</dd>
<dt><tt>ALTER TABLE ... ADD COLUMN</tt></dt> <dt>ALTER TABLE ... ADD COLUMN</dt>
<dd>It causes lost of data. Newly added columns are initialized with NULLs.</dd> <dd>It causes lost of data. Newly added columns are initialized with NULLs.</dd>
<dt><tt>ALTER TABLE ... ALTER COLUMN TYPE</tt></dt> <dt>ALTER TABLE ... ALTER COLUMN TYPE</dt>
<dd>It causes data corruptions.</dd> <dd>It causes data corruptions.</dd>
<dt><tt>ALTER TABLE ... SET TABLESPACE</tt></dt> <dt>ALTER TABLE ... SET TABLESPACE</dt>
<dd>It causes data corruptions by wrong relfilenode.</dd> <dd>It causes data corruptions by wrong relfilenode.</dd>
</dl> </dl>
</div>
<div><a name="install"></a> <h2 id="details">Details</h2>
<h2>Installations</h2> <p>pg_reorg creates a work table in reorg schema and sorts rows in it.
Then, it updates system catalog directly to swap the work table and the original one.</p>
<h2 id="install">Installations</h2>
<p>pg_reorg can be installed like standard contrib modules.</p> <p>pg_reorg can be installed like standard contrib modules.</p>
<h3>Build from source</h3> <h3>Build from source</h3>
<p>Place pg_reorg to $PGHOME/contrib/ and input make, make install.</p> <p>Place pg_reorg to $PGHOME/contrib/ and input make, make install.</p>
<h3>Register to database</h3> <h3>Register to database</h3>
<p>Start PostgreSQL and execute pg_reorg.sql in $PGHOME/share/contrib.</p> <p>Start PostgreSQL and execute pg_reorg.sql in $PGHOME/share/contrib.</p>
</div>
<div><a name="requirement"></a> <h2 id="requirement">Requirements</h2>
<h2>Requirements</h2>
<dl> <dl>
<dt>PostgreSQL version</dt><dd>PostgreSQL 8.3</dd> <dt>PostgreSQL version</dt><dd>PostgreSQL 8.3</dd>
<dt>OS</dt><dd>RHEL 5.2, Windows XP SP3</dd> <dt>OS</dt><dd>RHEL 5.2, Windows XP SP3</dd>
<dt>Disks</dt><dd>Requires amount of disks twice larger than target table and indexes.</dd> <dt>Disks</dt><dd>Requires amount of disks twice larger than target table and indexes.</dd>
</dl> </dl>
</div>
<div><a name="seealso"></a> <h2 id="seealso">See Also</h2>
<h2>See Also</h2> <a href="http://developer.postgresql.org/pgdocs/postgres/app-clusterdb.html">clusterdb</a>,
<a href="http://developer.postgresql.org/pgdocs/postgres/app-clusterdb.html"><i><tt>clusterdb</tt></i></a>, <a href="http://developer.postgresql.org/pgdocs/postgres/app-vacuumdb.html">vacuumdb</a>
<a href="http://developer.postgresql.org/pgdocs/postgres/app-vacuumdb.html"><i><tt>vacuumdb</tt></i></a>
</div>
<hr> <hr />
<p class="footer">Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
<p align="right"><font size="2">
Copyright (c) 2008-2009, NIPPON TELEGRAPH AND TELEPHONE CORPORATION
</font></p>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-10244036-4");
pageTracker._trackPageview();
} catch(err) {}</script>
</body> </body>
</html> </html>

119
doc/style.css
View File

@ -1,12 +1,13 @@
BODY { body {
margin-top: 3; font-family:
margin-left: 3; Lucida Grande, Verdana, Arial, Helvetica,
margin-right: 3; 'メイリオ',
margin-bottom: 3; 'Meiryo',
} 'ヒラギノ角ゴ Pro W3',
'Hiragino Kaku Gothic Pro',
TT,OL,UL,P,BODY,TR,TD,TH,FORM { 'Osaka',
font-family: arial,helvetica,sans-serif; 'ＭＳ Ｐゴシック',
sans-serif;
color: #202020; color: #202020;
} }
@ -29,13 +30,7 @@ H4 { padding-left: 2em; font-size: small; font-family: Lucida Grande,verdana,ari
H5 { padding-left: 3em; font-size: x-small; font-family: Lucida Grande,verdana,arial,helvetica,sans-serif; } H5 { padding-left: 3em; font-size: x-small; font-family: Lucida Grande,verdana,arial,helvetica,sans-serif; }
H6 { padding-left: 4em; font-size: xx-small; font-family: Lucida Grande,verdana,arial,helvetica,sans-serif; } H6 { padding-left: 4em; font-size: xx-small; font-family: Lucida Grande,verdana,arial,helvetica,sans-serif; }
dt { pre {
font-size: 110%;
padding-top: 0.5em;
padding-bottom: 0.5em;
}
PRE {
font-family: courier,sans-serif; font-family: courier,sans-serif;
background-color: #FBFBFD; background-color: #FBFBFD;
border: 1px dashed #7E7ECB; border: 1px dashed #7E7ECB;
@ -44,63 +39,43 @@ PRE {
overflow: auto; overflow: auto;
} }
A:link { text-decoration:none; color:#0000EE } li {
A:visited { text-decoration:none color:#551A8B} line-height: 1.4em;
A:active { text-decoration:none; color:#00ff00 }
A:hover { text-decoration:underline; color:#008000 }
.titlebar { color: #000000; text-decoration: none; font-weight: bold; }
A.tablink {
color: #000000;
text-decoration: none;
font-weight: bold;
font-size: small;
}
A.tablink:visited {
color: #000000;
text-decoration: none;
font-weight: bold;
font-size: small;
}
A.tablink:hover {
text-decoration: none;
color: #000000;
font-weight: bold;
font-size: small;
}
A.tabsellink {
color: #ffffcc;
text-decoration: none;
font-weight: bold;
font-size: small;
}
A.tabsellink:visited {
color: #ffffcc;
text-decoration: none;
font-weight: bold;
font-size: small;
}
A.tabsellink:hover {
text-decoration: none;
color: #ffffcc;
font-weight: bold;
font-size: small;
} }
A.showsource { table {
color: #000000; background: #f9f9f9;
text-decoration: none; border: 1px solid #aaa;
font-size: small; border-collapse: collapse;
} }
A.showsource:visited {
color: #000000; th, td {
text-decoration: none; border: 1px solid #aaa;
font-size: small; padding: 0.2em;
} }
A.showsource:hover {
color: #000000; thead th {
text-decoration: none; background: #f2f2f2;
text-align: center;
}
tbody th {
background: #f2f2f2;
text-align: left;
}
div.index {
float:right;
border:thin solid black;
background-color: white;
padding-top: 0.2em;
padding-bottom: 0.2em;
padding-left: 1em;
padding-right: 1em;
margin-left: 0.5em;
}
p.footer {
text-align: right;
font-size: small; font-size: small;
} }

179
lib/reorg.c
View File

@ -8,12 +8,14 @@
#include <unistd.h> #include <unistd.h>
#include "access/genam.h"
#include "access/transam.h" #include "access/transam.h"
#include "access/xact.h" #include "access/xact.h"
#include "catalog/dependency.h" #include "catalog/dependency.h"
#include "catalog/indexing.h" #include "catalog/indexing.h"
#include "catalog/namespace.h" #include "catalog/namespace.h"
#include "catalog/pg_namespace.h" #include "catalog/pg_namespace.h"
#include "catalog/pg_opclass.h"
#include "catalog/pg_type.h" #include "catalog/pg_type.h"
#include "commands/tablecmds.h" #include "commands/tablecmds.h"
#include "commands/trigger.h" #include "commands/trigger.h"
@ -55,6 +57,9 @@ static void swap_heap_or_index_files(Oid r1, Oid r2);
#define copy_tuple(tuple, desc) \ #define copy_tuple(tuple, desc) \
PointerGetDatum(SPI_returntuple((tuple), (desc))) PointerGetDatum(SPI_returntuple((tuple), (desc)))
#define IsToken(c) \
(IS_HIGHBIT_SET((c)) || isalnum((unsigned char) (c)) || (c) == '_')
/* check access authority */ /* check access authority */
static void static void
must_be_superuser(const char *func) must_be_superuser(const char *func)
@ -313,11 +318,32 @@ skip_const(Oid index, char *sql, const char *arg1, const char *arg2)
static char * static char *
skip_ident(Oid index, char *sql) skip_ident(Oid index, char *sql)
{ {
sql = strchr(sql, ' '); while (*sql && isspace((unsigned char) *sql))
if (sql) sql++;
if (*sql == '"')
{ {
sql++;
for (;;)
{
char *end = strchr(sql, '"');
if (end == NULL)
return parse_error(index);
else if (end[1] != '"')
{
end[1] = '\0';
return end + 2;
}
else /* escaped quote ("") */
sql = end + 2;
}
}
else
{
while (*sql && IsToken(*sql))
sql++;
*sql = '\0'; *sql = '\0';
return sql + 2; return sql + 1;
} }
/* error */ /* error */
@ -325,12 +351,13 @@ skip_ident(Oid index, char *sql)
} }
static char * static char *
skip_columns(Oid index, char *sql) skip_until(Oid index, char *sql, char end)
{ {
char instr = 0; char instr = 0;
int nopen = 1; int nopen = 0;
for (; *sql && nopen > 0; sql++) sql++;
for (; *sql && (nopen > 0 || instr != 0 || *sql != end); sql++)
{ {
if (instr) if (instr)
{ {
@ -342,9 +369,7 @@ skip_columns(Oid index, char *sql)
instr = 0; instr = 0;
} }
else if (sql[0] == '\\') else if (sql[0] == '\\')
{ sql++; /* next char is always string */
sql++; // next char is always string
}
} }
else else
{ {
@ -364,10 +389,10 @@ skip_columns(Oid index, char *sql)
} }
} }
if (nopen == 0) if (nopen == 0 && instr == 0)
{ {
sql[-1] = '\0'; *sql = '\0';
return sql; return sql + 1;
} }
/* error */ /* error */
@ -398,8 +423,11 @@ parse_indexdef(IndexDef *stmt, Oid index, Oid table)
stmt->type = sql; stmt->type = sql;
sql = skip_ident(index, sql); sql = skip_ident(index, sql);
/* (columns) */ /* (columns) */
if ((sql = strchr(sql, '(')) == NULL)
parse_error(index);
sql++;
stmt->columns = sql; stmt->columns = sql;
sql = skip_columns(index, sql); sql = skip_until(index, sql, ')');
/* options */ /* options */
stmt->options = sql; stmt->options = sql;
} }
@ -413,6 +441,9 @@ parse_indexdef(IndexDef *stmt, Oid index, Oid table)
* @param index Oid of target index. * @param index Oid of target index.
* @param table Oid of table of the index. * @param table Oid of table of the index.
* @retval Create index DDL for temp table. * @retval Create index DDL for temp table.
*
* FIXME: this function is named get_index_keys, but actually returns
* an expression for ORDER BY clause. get_order_by() might be a better name.
*/ */
Datum Datum
reorg_get_index_keys(PG_FUNCTION_ARGS) reorg_get_index_keys(PG_FUNCTION_ARGS)
@ -420,10 +451,107 @@ reorg_get_index_keys(PG_FUNCTION_ARGS)
Oid index = PG_GETARG_OID(0); Oid index = PG_GETARG_OID(0);
Oid table = PG_GETARG_OID(1); Oid table = PG_GETARG_OID(1);
IndexDef stmt; IndexDef stmt;
char *token;
char *next;
StringInfoData str;
Relation indexRel = NULL;
int nattr;
parse_indexdef(&stmt, index, table); parse_indexdef(&stmt, index, table);
PG_RETURN_TEXT_P(cstring_to_text(stmt.columns)); /*
* FIXME: this is very unreliable implementation but I don't want to
* re-implement customized versions of pg_get_indexdef_string...
*
* TODO: Support ASC/DESC and NULL FIRST/LAST.
*/
initStringInfo(&str);
for (nattr = 0, next = stmt.columns; *next; nattr++)
{
char *opcname;
token = next;
next = skip_until(index, next, ',');
opcname = token + strlen(token);
if (opcname[-1] == '"')
{
opcname--;
for (;;)
{
char *beg = strrchr(opcname, '"');
if (beg == NULL)
parse_error(index);
else if (beg[-1] != '"')
break;
else /* escaped quote ("") */
opcname = beg - 1;
}
}
else
{
while (opcname > token && IsToken(opcname[-1]))
opcname--;
}
if (opcname > token && *opcname)
{
/* lookup default operator name from operator class */
Oid opclass;
Oid oprid;
int16 strategy = BTLessStrategyNumber;
#if PG_VERSION_NUM >= 80300
Oid opcintype;
Oid opfamily;
HeapTuple tp;
Form_pg_opclass opclassTup;
#endif
opclass = OpclassnameGetOpcid(BTREE_AM_OID, opcname);
#if PG_VERSION_NUM >= 80300
/* Retrieve operator information. */
tp = SearchSysCache(CLAOID, ObjectIdGetDatum(opclass), 0, 0, 0);
if (!HeapTupleIsValid(tp))
elog(ERROR, "cache lookup failed for opclass %u", opclass);
opclassTup = (Form_pg_opclass) GETSTRUCT(tp);
opfamily = opclassTup->opcfamily;
opcintype = opclassTup->opcintype;
ReleaseSysCache(tp);
if (!OidIsValid(opcintype))
{
if (indexRel == NULL)
indexRel = index_open(index, NoLock);
opcintype = RelationGetDescr(indexRel)->attrs[nattr]->atttypid;
}
oprid = get_opfamily_member(opfamily, opcintype, opcintype, strategy);
if (!OidIsValid(oprid))
elog(ERROR, "missing operator %d(%u,%u) in opfamily %u",
strategy, opcintype, opcintype, opfamily);
#else
oprid = get_opclass_member(opclass, 0, strategy);
if (!OidIsValid(oprid))
elog(ERROR, "missing operator %d for %s", strategy, opcname);
#endif
opcname[-1] = '\0';
appendStringInfo(&str, "%s USING %s", token, get_opname(oprid));
}
else
appendStringInfoString(&str, token);
if (*next)
appendStringInfoChar(&str, ',');
}
if (indexRel != NULL)
index_close(indexRel, NoLock);
PG_RETURN_TEXT_P(cstring_to_text(str.data));
} }
/** /**
@ -481,7 +609,19 @@ remove_dropped_columns_and_adjust_attnum(Oid oid, int16 natts1, int16 natts2)
natts2 - natts1, SPI_processed); natts2 - natts1, SPI_processed);
/* renumber attnum */ /* renumber attnum */
#if PG_VERSION_NUM >= 80300 #if PG_VERSION_NUM >= 80500
execute_with_format(SPI_OK_UPDATE,
"UPDATE pg_catalog.pg_attribute m"
" SET attnum = (SELECT count(*) FROM pg_attribute a"
" WHERE m.attrelid = a.attrelid"
" AND m.attnum >= a.attnum"
" AND a.attnum > 0 AND NOT a.attisdropped)"
" WHERE attrelid = %u AND attnum > 0 AND NOT attisdropped",
oid);
if (SPI_processed != natts2)
elog(ERROR, "cannot update %d columns (%u columns updated)",
natts2, SPI_processed);
#elif PG_VERSION_NUM >= 80300
execute_with_format(SPI_OK_UPDATE, execute_with_format(SPI_OK_UPDATE,
"UPDATE pg_catalog.pg_attribute" "UPDATE pg_catalog.pg_attribute"
" SET attnum = (SELECT count(*) FROM pg_attribute a" " SET attnum = (SELECT count(*) FROM pg_attribute a"
@ -676,12 +816,21 @@ reorg_swap(PG_FUNCTION_ARGS)
/* adjust key attnum if the target table has dropped columns */ /* adjust key attnum if the target table has dropped columns */
if (natts1 != natts2) if (natts1 != natts2)
{ {
#if PG_VERSION_NUM >= 80500
execute_with_format(SPI_OK_UPDATE,
"UPDATE pg_catalog.pg_index m SET indkey = n.indkey"
" FROM pg_catalog.pg_index n"
" WHERE m.indexrelid = %u"
" AND n.indexrelid = 'reorg.index_%u'::regclass",
idx1, idx1);
#else
execute_with_format(SPI_OK_UPDATE, execute_with_format(SPI_OK_UPDATE,
"UPDATE pg_catalog.pg_index SET indkey = n.indkey" "UPDATE pg_catalog.pg_index SET indkey = n.indkey"
" FROM pg_catalog.pg_index n" " FROM pg_catalog.pg_index n"
" WHERE pg_catalog.pg_index.indexrelid = %u" " WHERE pg_catalog.pg_index.indexrelid = %u"
" AND n.indexrelid = 'reorg.index_%u'::regclass", " AND n.indexrelid = 'reorg.index_%u'::regclass",
idx1, idx1); idx1, idx1);
#endif
if (SPI_processed != 1) if (SPI_processed != 1)
elog(ERROR, "failed to update pg_index.indkey (%u rows updated)", SPI_processed); elog(ERROR, "failed to update pg_index.indkey (%u rows updated)", SPI_processed);
} }