farrokhi/pg_repack
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
pg_repack/doc/pg_repack-ja.html

355 lines
16 KiB
HTML
Raw Normal View History

Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<html>
<head>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<title>pg_repack</title>
<link rel="home" title="pg_repack " href="index.html">
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<link rel="stylesheet" TYPE="text/css" href="style.css">
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<h1 id="pg_repack">pg_repack 1.1.7</h1>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<div class="navigation">
<a href="index-ja.html">Top</a> &gt;
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<a href="pg_repack-ja.html">pg_repack</a>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
</div>
<hr>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<div class="index">
<ol>
<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>
version 1.1.7. Supports 9.2dev.
2011-08-07 04:20:23 +00:00
<li><a href="#releases">更新履歴</a></li>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<li><a href="#seealso">関連項目</a></li>
</ol>
</div>
<h2 id="name">名前</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
pg_repack -- PostgreSQLデータベース内のテーブルに対して、参照/更新処理をブロックせずに再編成を行います。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h2 id="synopsis">概要</h2>
<p>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
pg_repack [OPTIONS]
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</p>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<p>オプション OPTIONS には以下を指定できます。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
詳細は<a href="#options">オプション</a>を参照してください。</p>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<ul>
<li>固有オプション<ul>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<li>-a, --all : 全てのデータベースに対して実行します</li>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<li>-o [--order-by] columns [,...]</li>
<li>-n [--no-order]</li>
<li>-t [--table] table</li>
<li>-T [--wait-timeout] seconds</li>
<li>-Z [--no-analyze]</li>
</ul></li>
<li>接続オプション<ul>
<li>-d, --dbname=DBNAME : 接続するデータベース</li>
<li>-h, --host=HOSTNAME : データベースサーバホスト、またはソケットディレクトリ</li>
<li>-p, --port=PORT : データベースサーバのポート</li>
<li>-U, --username=USERNAME : このユーザとして接続します</li>
Fix -w and -W options. They were inverted.
2010-06-18 01:12:28 +00:00
<li>-w, --no-password : パスワードの入力を促しません</li>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<li>-W, --password : パスワード入力を強制します</li>
</ul></li>
<li>一般オプション<ul>
<li>-e, --echo : サーバに送信するSQLを表示します</li>
<li>-E, --elevel=LEVEL : ログ出力レベルを設定します</li>
<li>--help : ヘルプを表示し、終了します</li>
<li>--version : バージョン情報を出力し、終了します</li>
</ul></li>
</ul>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h2 id="description">説明</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack は、PostgreSQLデータベース内のテーブルを再編成(行の並び替え)するユーティリティです。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<a href="http://www.postgresql.jp/document/current/html/app-clusterdb.html">clusterdb</a> と異なり、参照/更新処理をブロックしません。
再編成の方式として、以下のいずれか1つを選択できます。</p>
<ul>
<li>オンライン CLUSTER (cluster index順に行を並び替える)</li>
<li>ユーザの指定した順に行を並び替える</li>
<li>オンライン VACUUM FULL (行の詰め合わせを行う)</li>
</ul>
<p>このユーティリティを使用するためには、以下のことに注意をしてください。</p>
<ul>
<li>このユーティリティは、スーパーユーザのみが実行することができます。</li>
<li>対象のテーブルはPRIMARY KEYを持っている必要があります。</li>
</ul>
<h2 id="examples">例</h2>
<p>testというデータベースをオンライン CLUSTER するには、下記のコマンドを実行します。</p>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<PRE><SAMP>$ </SAMP><KBD>pg_repack test</KBD></PRE>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<p>testという名前のデータベースのfooという1つのテーブルに対してオンライン VACUUM FULL を行うには、下記のコマンドを実行します。</p>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<PRE><SAMP>$ </SAMP><KBD>pg_repack --no-order --table foo -d test</KBD></PRE><p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</p>
<h2 id="options">オプション</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack では、下記のコマンドライン引数を指定できます。</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<h3>固有オプション</h3>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack を実行する対象と並び替えの基準を指定するパラメータです。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
何も指定されていない場合は、cluster index順にオンライン CLUSTER を行います。
この2つを同時に指定することはできません。
</p>
<dl>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-n<br>--no-order</dt>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>オンライン VACUUM FULL の処理を行います。</dd>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-o columns [,...]<br>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
--order-by columns [,...]</dt>
<dd>指定したカラムをキーにオンライン CLUSTER を行います。</dd>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dt>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
-t table<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--table=table
</dt>
<dd>オンライン CLUSTER 、または、オンライン VACUUM FULL を行うテーブルを指定します。
このオプションが指定されていない場合は、対象となったデータベースに存在する全ての対象テーブルに対して処理を行います。
</dd>
<dt>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
-T seconds<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--wait-timeout=seconds
</dt>
<dd>
再編成完了直前に一瞬だけ排他ロックを取得しますが、この排他ロックが取得できるまで待機する秒数を指定します。
この秒数が経過してもロックが取得できない場合には、対象のテーブルにアクセスしている他の全てのクエリを取り消します。
また、サーバのバージョンが 8.4 またはそれ以降の場合には、指定した秒数の2倍経過してもロックを取得できない場合には、強制的に切断します。
デフォルトは60秒です。
</dd>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-Z<br>--no-analyze</dt>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dd>再編成後に ANALYZE を行いません。
このオプションが指定されていない場合は、再編成後に ANALYZE します。</dd>
</dl>
<h3>接続オプション</h3>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<p>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
PostgreSQLに接続するためのパラメータです。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
--allと--dbnameまたは--tableを同時に指定することはできません。
</p>
<dl>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-a<br>--all</dt>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>対象となる全てのデータベースに対してオンライン CLUSTER、または、オンラインVACUUM FULLを行います。</dd>
<dt>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
-d DBNAME<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--dbname=DBNAME
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</dt>
<dd>オンライン CLUSTER、または、オンライン VACUUM FULL を行うデータベース名を指定します。
データベース名が指定されておらず、-a（または--all）も指定されていない場合、
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
データベース名はPGDATABASE環境変数から読み取られます。
この変数も設定されていない場合は、接続時に指定したユーザ名が使用されます。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-h HOSTNAME<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--host=HOSTNAME</dt>
<dd>サーバが稼働しているマシンのホスト名を指定します。ホスト名がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-p PORT<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--port=PORT</dt>
<dd>サーバが接続を監視するTCPポートもしくはUnixドメインソケットファイルの拡張子を指定します。</dd>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-U USERNAME<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--username=USERNAME</dt>
<dd>接続するユーザ名を指定します。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-w<br>
Fix -w and -W options. They were inverted.
2010-06-18 01:12:28 +00:00
--no-password</dt>
<dd>
パスワードの入力を促しません。
サーバがパスワード認証を必要とし、かつ、.pgpassファイルなどの他の方法が利用できない場合、接続試行は失敗します。
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
バッチジョブやパスワードを入力するユーザが存在しない場合にこのオプションは有用かもしれません。
Fix -w and -W options. They were inverted.
2010-06-18 01:12:28 +00:00
</dd>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-W<br>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
--password</dt>
Fix -w and -W options. They were inverted.
2010-06-18 01:12:28 +00:00
<dd>データベースに接続する前に、強制的にパスワード入力を促します。</dd>
<dd>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
サーバがパスワード認証を要求する場合 自動的にパスワード入力を促しますので、これが重要になることはありません。
しかし、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。
Fix -w and -W options. They were inverted.
2010-06-18 01:12:28 +00:00
こうした余計な接続試行を防ぐために -W の入力が有意となる場合もあります。
</dd>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
</dl>
<h3>一般オプション</h3>
<dl>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-e<br>--echo</dt>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dd>サーバに送信するSQLを表示します。</dd>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dt>-E<br>--elevel</dt>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dd>ログ出力レベルを設定します。
DEBUG, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC から選択します。
デフォルトは INFO です。</dd>
<dt>--help</dt>
<dd>使用方法について表示します。</dd>
<dt>--version</dt>
<dd>バージョン情報を表示します。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</dl>
<h2 id="environment">環境変数</h2>
<dl>
<dt>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
PGDATABASE<br>
PGHOST<br>
PGPORT<br>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
PGUSER
</dt>
<dd>デフォルトの接続パラメータです。</dd>
</dl>
<p>
また、このユーティリティは、他のほとんどの PostgreSQL ユーティリティと同様、libpq でサポートされる環境変数を使用します。詳細については、<a href="http://www.postgresql.jp/document/current/html/libpq-envars.html">環境変数の項目</a>を参照してください。
</p>
<h2 id="diagnostics">トラブルシューティング</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack の実行に失敗した場合にエラーが表示されます。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
想像されるエラー原因と対処を示します。</p>
<p>致命的なエラーで終了した場合、手動によるクリーンアップを行う必要があります。
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
クリーンアップは、エラーが発生したデータベースに対して、$PGHOME/share/contrib/uninstall_pg_repack.sql を実行し、その後、$PGHOME/share/contrib/pg_repack.sql を実行します。</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dl>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>pg_repack : repack database "template1" ... skipped</dt>
<dd>--allオプションを指定した際に、pg_repack がインストールされていないデータベースに対して表示されます。</dd>
<dd>pg_repack スキーマのインストールを行ってください。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>ERROR: pg_repack is not installed</dt>
<dd>--dbnameで指定したデータベースにpg_repack がインストールされていません。</dd>
<dd>pg_repack のインストールを行ってください。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dt>ERROR: relation "table" has no primary key</dt>
<dd>指定したテーブルにPRIMARY KEYが存在していません。</dd>
<dd>対象のテーブルにPRIMARY KEYの作成を行ってください。(ALTER TABLE ADD PRIMARY KEY)</dd>
<dt>ERROR: relation "table" has no cluster key</dt>
<dd>指定したテーブルに CLUSTER KEYが存在していません。</dd>
<dd>対象のテーブルに CLUSTER KEYの作成を行ってください。(ALTER TABLE CLUSTER)</dd>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>pg_repack : query failed: ERROR: column "col" does not exist</dt>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>--order-by で指定したカラムが対象のテーブルに存在していません。</dd>
<dd>対象のテーブルに存在するカラムを指定してください。</dd>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>ERROR: permission denied for schema repack</dt>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>操作を行おうとした対象に権限がありません。</dd>
<dd>スーパーユーザで操作を行ってください。</dd>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>pg_repack : query failed: ERROR: trigger "z_repack_trigger" for relation "tbl" already exists</dt>
<dd>操作を行おうとした対象にpg_repack が処理のために作成するトリガと同名のものが存在しています。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>トリガの改名か削除を行ってください。</dd>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dt>pg_repack : trigger conflicted for tbl</dt>
<dd>操作を行おうとした対象にpg_repack が処理のために作成するトリガより後に実行されるトリガが存在しています。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dd>トリガの改名か削除を行ってください。</dd>
</dl>
<h2 id="restrictions">使用上の注意と制約</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack を使用する際には、以下の制約があります。以下の制約に関する操作を行った場合の動作は保証されません。注意してください。</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h3>一時テーブルへの操作</h3>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack では、一時テーブルは操作の対象外です。</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h3>GiSTインデックスの使用</h3>
<p>インデックス種別がGiSTとなっているインデックスがクラスタインデックスとなっている
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
テーブルはpg_repack コマンドを使用して操作を行うことはできません。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
これは、GiSTインデックスのソート順序は一意ではないため、ORDER BYによる
ソートが行えないためです。</p>
<h3>DDLコマンドの発行</h3>
<p>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
pg_repack の実行中には、VACUUM と ANALYZE <STRONG>以外</STRONG> のDDL操作は行わないでください。
多くの場合、pg_repack は失敗しロールバックされます。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
しかし、以下の操作ではデータが破損するため、非常に危険です。
</p>
<dl>
<dt>TRUNCATE</dt>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dd>削除した行が pg_repack 実行後には復元しています。操作結果が消失します。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<dt>CREATE INDEX</dt>
<dd>スワップされない索引が残る可能性があります。データの不整合が生じます。</dd>
<dt>ALTER TABLE ... ADD COLUMN</dt>
<dd>追加された値が全てNULLに置換されてしまう可能性があります。データが消失します。</dd>
<dt>ALTER TABLE ... ALTER COLUMN TYPE</dt>
<dd>実行するとスキーマで定義された型と実際の格納状態に齟齬をきたします。データの不整合が生じます。</dd>
<dt>ALTER TABLE ... SET TABLESPACE</dt>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<dd>pg_repack 実行後にrelfilenodeとの不整合が起こるため、対象のテーブルに対する参照/更新操作時にエラーが発生します。</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</dl>
<h2 id="details">詳細</h2>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<p>pg_repack は repack スキーマに作業用テーブルを作成し、そこでデータの並び替えを行います。
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
最後にシステムカタログを直接書き換えることで、元のテーブルと名前を交換しています。</p>
<h2 id="install">インストール方法</h2>
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
<p>
UNIX や Linux では、make を実行すると自動的に pgxs を使ってビルドできます。
前もって PostgreSQL 開発用パッケージ (postgresql-devel 等) をインストールし、pg_config にパスを通してください。
</p>
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<pre>$ cd pg_repack
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
$ make
Add documentation to build the module with pgxs.
2010-07-09 04:54:27 +00:00
$ su
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
$ make install</pre>
<p>
Windows では Microsoft Visual C++ 2010 でビルドできます。
msvc フォルダ内にプロジェクトファイルがあります。
</p>
Add documentation to build the module with pgxs.
2010-07-09 04:54:27 +00:00
<p>その後、データベースに関数を登録します。</p>
<pre>$ pg_ctl start
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
$ psql -f $PGSHARE/contrib/pg_repack.sql -d your_database</pre>
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
<p>(注意: <code>CREATE EXTENSION</code> はまだサポートしていません。)</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h2 id="requirement">動作環境</h2>
<dl>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dt>PostgreSQLバージョン</dt>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<dd>PostgreSQL 8.2, 8.3, 8.4, 9.0, 9.1, 9.2</dd>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<dt>OS</dt>
<dd>RHEL 5.2, Windows XP SP3</dd>
<dt>ディスク容量</dt>
<dd>処理対象のテーブル、インデックスサイズの2倍以上のディスク空き容量 (対象が1GBならば、さらに追加で2GB)</dd>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
</dl>
version 1.1.7. Supports 9.2dev.
2011-08-07 04:20:23 +00:00
<h2 id="releases">更新履歴</h2>
<ul>
<li>1.1.7 (2011-08-07)<ul>
<li>バグ修正: DROPされた列を持つテーブルを再編成した場合に、そのテーブルを使用するビューや関数が破損する可能性があった。</li>
<li>PostgreSQL 9.1, 9.2dev のサポート (EXTENSION はまだ)</li>
</ul></li>
</ul>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<h2 id="seealso">関連項目</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-vacuumdb.html">vacuumdb</a>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
<hr>
pg_reorg version 1.1.0. - Add wait-timeout option and use SET statement_timeout instead of NOWAIT. This can avoid infinite NOWAIT loops to reorganize heavily accessed tables. - Support native build with MSVC on Windows.
2010-03-25 07:13:16 +00:00
<div class="navigation">
<a href="index-ja.html">Top</a> &gt;
Fork the pg_repack extension
2012-11-10 22:33:57 +00:00
<a href="pg_repack-ja.html">pg_repack</a>
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
</div>
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
<p class="footer">
Documentation fixes for the English and Japanese HTML doc pages * Get rid of duplicate documentation for "-Z" option * standardize which section "--all" appears under * note that 9.2 is a supported Postgres version * turn HTML docs into valid HTML 4.01 Commit by Josh Kupershmidt. Performed by me as git am was failing to apply this patch.
2012-09-22 19:58:49 +01:00
Portions Copyright (c) 2008-2011, NIPPON TELEGRAPH AND TELEPHONE CORPORATION<br>
Fixed database corruption when target tables have dropped columns, and there are views or functions depending on columns after dropped ones. The issue was reported by depesz, and original patch by Denish Patel. Improved documentation how to build binaries from source. COPYRIGHT updated.
2011-04-29 05:06:48 +00:00
Portions Copyright (c) 2011, Itagaki Takahiro
</p>
Support reorganizing tables with non-default operator class.
2009-12-28 08:25:00 +00:00
<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>
</html>
Reference in New Issue Copy Permalink