-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathapp-reindexdb.html
More file actions
301 lines (298 loc) · 24.9 KB
/
app-reindexdb.html
File metadata and controls
301 lines (298 loc) · 24.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>reindexdb</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="prev" href="app-psql.html" title="psql" /><link rel="next" href="app-vacuumdb.html" title="vacuumdb" /><meta name="viewport" content="width=device-width,initial-scale=1.0" /></head><body id="docContent" class="container-fluid col-10"><div class="other_version"><a href="https://www.postgresql.jp/document/">バージョンごとのドキュメント一覧</a></div><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="4" align="center"><a accesskey="h" href="index.html">PostgreSQL 18.3文書</a></th></tr><tr><td width="10%" align="left"></td><td width="10%" align="left"></td><td width="60%" align="center"><a href="reference-client.html" title="PostgreSQLクライアントアプリケーション">PostgreSQLクライアントアプリケーション</a></td><td width="20%" align="right"><div class="actions"><a class="issue" title="github" href="https://github.com/pgsql-jp/jpug-doc/issues/new?template=bug_report.yml&what-happened=version 18.3 : app-reindexdb.html">誤訳等の報告
</a></div></td></tr><tr><td width="10%" align="left"><a accesskey="p" href="app-psql.html" title="psql">前へ</a> </td><td width="10%" align="left"><a accesskey="u" href="reference-client.html" title="PostgreSQLクライアントアプリケーション">上へ</a></td><td width="60%" align="center"><span class="application">reindexdb</span></td><td width="20%" align="right"> <a accesskey="n" href="app-vacuumdb.html" title="vacuumdb">次へ</a></td></tr></table><hr /></div><div class="refentry" id="APP-REINDEXDB"><div class="titlepage"></div><a id="id-1.9.4.22.1" class="indexterm"></a><div class="refnamediv"><h2><span class="refentrytitle"><span class="application">reindexdb</span></span></h2><p>reindexdb<span class="original">
<refpurpose>reindex a <productname>PostgreSQL</productname> database</refpurpose>
</span> — <span class="productname">PostgreSQL</span>データベースのインデックスを再作成する</p></div><div class="refsynopsisdiv"><h2>概要</h2><div class="cmdsynopsis"><p id="id-1.9.4.22.4.1"><code class="command">reindexdb</code> [<em class="replaceable"><code>connection-option</code></em>...] [<em class="replaceable"><code>option</code></em>...]
[
<code class="option">-S</code> | <code class="option">--schema</code>
<em class="replaceable"><code>schema</code></em>
]
...
[
<code class="option">-t</code> | <code class="option">--table</code>
<em class="replaceable"><code>table</code></em>
]
...
[
<code class="option">-i</code> | <code class="option">--index</code>
<em class="replaceable"><code>index</code></em>
]
...
[
<code class="option">-s</code> | <code class="option">--system</code>
]
[
<em class="replaceable"><code>dbname</code></em> | <code class="option">-a</code> | <code class="option">--all</code>
]</p></div></div><div class="refsect1" id="id-1.9.4.22.5"><h2>説明</h2><span class="original">
<title>Description</title>
</span><p>
<span class="original">
<application>reindexdb</application> is a utility for rebuilding indexes
in a <productname>PostgreSQL</productname> database.
</span>
<span class="application">reindexdb</span>は、<span class="productname">PostgreSQL</span>データベース内のインデックスを再作成するユーティリティです。
</p><p>
<span class="original">
<application>reindexdb</application> is a wrapper around the SQL
command <link linkend="sql-reindex"><command>REINDEX</command></link>.
There is no effective difference between reindexing databases via
this utility and via other methods for accessing the server.
</span>
<span class="application">reindexdb</span>は、SQLコマンド<a class="link" href="sql-reindex.html" title="REINDEX"><code class="command">REINDEX</code></a>のラッパーです。
このユーティリティを使用しても他の方法でサーバにアクセスしても、データベースインデックスの再作成には実質的な違いはありません。
</p></div><div class="refsect1" id="id-1.9.4.22.6"><h2>オプション</h2><span class="original">
<title>Options</title>
</span><p>
<span class="original">
<application>reindexdb</application> accepts the following command-line arguments:
</span>
<span class="application">reindexdb</span>は以下のコマンドライン引数を受け付けます。
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-a</code><br /></span><span class="term"><code class="option">--all</code></span></dt><dd><p>
<span class="original">
Reindex all databases.
</span>
すべてのデータベースのインデックスを再作成します。
</p></dd><dt><span class="term"><code class="option">--concurrently</code></span></dt><dd><p>
<span class="original">
Use the <literal>CONCURRENTLY</literal> option. See
<xref linkend="sql-reindex"/>, where all the caveats of this option
are explained in detail.
</span>
<code class="literal">CONCURRENTLY</code>オプションを使います。
<a class="xref" href="sql-reindex.html" title="REINDEX"><span class="refentrytitle">REINDEX</span></a>を参照してください。このオプションの注意がすべて詳しく説明されています。
</p></dd><dt><span class="term"><code class="option">[<span class="optional">-d</span>] <em class="replaceable"><code>dbname</code></em></code><br /></span><span class="term"><code class="option">[<span class="optional">--dbname=</span>]<em class="replaceable"><code>dbname</code></em></code></span></dt><dd><p>
<span class="original">
Specifies the name of the database to be reindexed,
when <option>-a</option>/<option>&#45;-all</option> is not used.
If this is not specified, the database name is read
from the environment variable <envar>PGDATABASE</envar>. If
that is not set, the user name specified for the connection is
used. The <replaceable>dbname</replaceable> can be a <link
linkend="libpq-connstring">connection string</link>. If so,
connection string parameters will override any conflicting command
line options.
</span>
<code class="option">-a</code>/<code class="option">--all</code>が使用されていない場合に、インデックス再作成を行なうデータベースの名前を指定します。
これが指定されていなければ、環境変数<code class="envar">PGDATABASE</code>からデータベース名が決まります。
これも設定されていない場合は、接続時に指定したユーザ名が使用されます。
<em class="replaceable"><code>dbname</code></em>は<a class="link" href="libpq-connect.html#LIBPQ-CONNSTRING" title="32.1.1. 接続文字列">接続文字列</a>でも構いません。
その場合、接続文字列パラメータは衝突するコマンドラインオプションに優先します。
</p></dd><dt><span class="term"><code class="option">-e</code><br /></span><span class="term"><code class="option">--echo</code></span></dt><dd><p>
<span class="original">
Echo the commands that <application>reindexdb</application> generates
and sends to the server.
</span>
<span class="application">reindexdb</span>が生成しサーバに送信するコマンドを表示します。
</p></dd><dt><span class="term"><code class="option">-i <em class="replaceable"><code>index</code></em></code><br /></span><span class="term"><code class="option">--index=<em class="replaceable"><code>index</code></em></code></span></dt><dd><p>
<span class="original">
Recreate <replaceable class="parameter">index</replaceable> only.
Multiple indexes can be recreated by writing multiple
<option>-i</option> switches.
</span>
<em class="replaceable"><code>index</code></em>のみを再作成します。
複数の<code class="option">-i</code>スイッチを記述することで、複数のインデックスを再作成することができます。
</p></dd><dt><span class="term"><code class="option">-j <em class="replaceable"><code>njobs</code></em></code><br /></span><span class="term"><code class="option">--jobs=<em class="replaceable"><code>njobs</code></em></code></span></dt><dd><p>
<span class="original">
Execute the reindex commands in parallel by running
<replaceable class="parameter">njobs</replaceable>
commands simultaneously. This option may reduce the processing time
but it also increases the load on the database server.
</span>
<em class="replaceable"><code>njobs</code></em>個のコマンドを同時に実行することで、reindexコマンドを並列で実行します。
このオプションは処理時間を短縮することもありますが、データベースサーバの負荷も増加します。
</p><p>
<span class="original">
<application>reindexdb</application> will open
<replaceable class="parameter">njobs</replaceable> connections to the
database, so make sure your <xref linkend="guc-max-connections"/>
setting is high enough to accommodate all connections.
</span>
<span class="application">reindexdb</span>はデータベースに対する<em class="replaceable"><code>njobs</code></em>個の接続を開くので、<a class="xref" href="runtime-config-connection.html#GUC-MAX-CONNECTIONS">max_connections</a>の設定は、これらの接続を許容するだけ十分に大きくしてください。
</p><p>
<span class="original">
Note that this option is incompatible with the <option>&#45;-system</option> option.
</span>
このオプションは<code class="option">--system</code>オプションと両立しません。
</p></dd><dt><span class="term"><code class="option">-q</code><br /></span><span class="term"><code class="option">--quiet</code></span></dt><dd><p>
<span class="original">
Do not display progress messages.
</span>
進行メッセージを表示しません。
</p></dd><dt><span class="term"><code class="option">-s</code><br /></span><span class="term"><code class="option">--system</code></span></dt><dd><p>
<span class="original">
Reindex database's system catalogs only.
</span>
データベースのシステムカタログのみ、インデックスを再作成します。
</p></dd><dt><span class="term"><code class="option">-S <em class="replaceable"><code>schema</code></em></code><br /></span><span class="term"><code class="option">--schema=<em class="replaceable"><code>schema</code></em></code></span></dt><dd><p>
<span class="original">
Reindex <replaceable class="parameter">schema</replaceable> only.
Multiple schemas can be reindexed by writing multiple
<option>-S</option> switches.
</span>
<em class="replaceable"><code>schema</code></em>のみのインデックスを再作成します。
複数の<code class="option">-S</code>スイッチを指定することで、複数のスキーマのインデックスを再作成できます。
</p></dd><dt><span class="term"><code class="option">-t <em class="replaceable"><code>table</code></em></code><br /></span><span class="term"><code class="option">--table=<em class="replaceable"><code>table</code></em></code></span></dt><dd><p>
<span class="original">
Reindex <replaceable class="parameter">table</replaceable> only.
Multiple tables can be reindexed by writing multiple
<option>-t</option> switches.
</span>
<em class="replaceable"><code>table</code></em>のインデックスのみを再作成します。
複数の<code class="option">-t</code>を記述することで、複数のテーブルのインデックスを再作成することができます。
</p></dd><dt><span class="term"><code class="option">--tablespace=<em class="replaceable"><code>tablespace</code></em></code></span></dt><dd><p>
<span class="original">
Specifies the tablespace where indexes are rebuilt. (This name is
processed as a double-quoted identifier.)
</span>
インデックスを再作成するテーブル空間を指定します。
(この名前は二重引用符で囲まれた識別子として処理されます。)
</p></dd><dt><span class="term"><code class="option">-v</code><br /></span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
<span class="original">
Print detailed information during processing.
</span>
処理中に詳細な情報を表示します。
</p></dd><dt><span class="term"><code class="option">-V</code><br /></span><span class="term"><code class="option">--version</code></span></dt><dd><p>
<span class="original">
Print the <application>reindexdb</application> version and exit.
</span>
<span class="application">reindexdb</span>のバージョンを表示し、終了します。
</p></dd><dt><span class="term"><code class="option">-?</code><br /></span><span class="term"><code class="option">--help</code></span></dt><dd><p>
<span class="original">
Show help about <application>reindexdb</application> command line
arguments, and exit.
</span>
<span class="application">reindexdb</span>コマンドライン引数の使用方法を表示し、終了します。
</p></dd></dl></div><p>
</p><p>
<span class="original">
<application>reindexdb</application> also accepts
the following command-line arguments for connection parameters:
</span>
また、<span class="application">reindexdb</span>は、接続パラメータとして以下のコマンドライン引数を受け付けます。
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h <em class="replaceable"><code>host</code></em></code><br /></span><span class="term"><code class="option">--host=<em class="replaceable"><code>host</code></em></code></span></dt><dd><p>
<span class="original">
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.
</span>
サーバが稼働しているマシンのホスト名を指定します。
ホスト名がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。
</p></dd><dt><span class="term"><code class="option">-p <em class="replaceable"><code>port</code></em></code><br /></span><span class="term"><code class="option">--port=<em class="replaceable"><code>port</code></em></code></span></dt><dd><p>
<span class="original">
Specifies the TCP port or local Unix domain socket file
extension on which the server
is listening for connections.
</span>
サーバが接続を監視するTCPポートもしくはUnixドメインソケットファイルの拡張子を指定します。
</p></dd><dt><span class="term"><code class="option">-U <em class="replaceable"><code>username</code></em></code><br /></span><span class="term"><code class="option">--username=<em class="replaceable"><code>username</code></em></code></span></dt><dd><p>
<span class="original">
User name to connect as.
</span>
接続するユーザ名を指定します。
</p></dd><dt><span class="term"><code class="option">-w</code><br /></span><span class="term"><code class="option">--no-password</code></span></dt><dd><p>
<span class="original">
Never issue a password prompt. If the server requires
password authentication and a password is not available by
other means such as a <filename>.pgpass</filename> file, the
connection attempt will fail. This option can be useful in
batch jobs and scripts where no user is present to enter a
password.
</span>
パスワードの入力を促しません。
サーバがパスワード認証を必要とし、かつ、<code class="filename">.pgpass</code>ファイルなどの他の方法が利用できない場合、接続試行は失敗します。
バッチジョブやスクリプトなどパスワードを入力するユーザが存在しない場合にこのオプションは有用かもしれません。
</p></dd><dt><span class="term"><code class="option">-W</code><br /></span><span class="term"><code class="option">--password</code></span></dt><dd><p>
<span class="original">
Force <application>reindexdb</application> to prompt for a
password before connecting to a database.
</span>
データベースに接続する前に、<span class="application">reindexdb</span>は強制的にパスワード入力を促します。
</p><p>
<span class="original">
This option is never essential, since
<application>reindexdb</application> will automatically prompt
for a password if the server demands password authentication.
However, <application>reindexdb</application> will waste a
connection attempt finding out that the server wants a password.
In some cases it is worth typing <option>-W</option> to avoid the extra
connection attempt.
</span>
サーバがパスワード認証を要求する場合<span class="application">reindexdb</span>は自動的にパスワード入力を促しますので、これが重要になることはありません。
しかし、<span class="application">reindexdb</span>は、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。
こうした余計な接続試行を防ぐために<code class="option">-W</code>の入力が有意となる場合もあります。
</p></dd><dt><span class="term"><code class="option">--maintenance-db=<em class="replaceable"><code>dbname</code></em></code></span></dt><dd><p>
<span class="original">
When the <option>-a</option>/<option>&#45;-all</option> is used, connect
to this database to gather the list of databases to reindex.
If not specified, the <literal>postgres</literal> database will be used,
or if that does not exist, <literal>template1</literal> will be used.
This can be a <link linkend="libpq-connstring">connection
string</link>. If so, connection string parameters will override any
conflicting command line options. Also, connection string parameters
other than the database name itself will be re-used when connecting
to other databases.
</span>
<code class="option">-a</code>/<code class="option">--all</code>が使われている場合に、再インデックス付けするデータベースの一覧を集めるため、このデータベースに接続します。
指定されなければ<code class="literal">postgres</code>データベースが使用され、もし存在しなければ<code class="literal">template1</code>が使用されます。
これは<a class="link" href="libpq-connect.html#LIBPQ-CONNSTRING" title="32.1.1. 接続文字列">接続文字列</a>でも構いません。
その場合、接続文字列パラメータは衝突するコマンドラインオプションに優先します。
また、データベース名自身以外の接続文字列パラメータは他のデータベースに接続する際に再利用されます。
</p></dd></dl></div><p>
</p></div><div class="refsect1" id="id-1.9.4.22.7"><h2>環境</h2><span class="original">
<title>Environment</title>
</span><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">PGDATABASE</code><br /></span><span class="term"><code class="envar">PGHOST</code><br /></span><span class="term"><code class="envar">PGPORT</code><br /></span><span class="term"><code class="envar">PGUSER</code></span></dt><dd><p>
<span class="original">
Default connection parameters
</span>
デフォルトの接続パラメータです。
</p></dd><dt><span class="term"><code class="envar">PG_COLOR</code></span></dt><dd><p>
<span class="original">
Specifies whether to use color in diagnostic messages. Possible values
are <literal>always</literal>, <literal>auto</literal> and
<literal>never</literal>.
</span>
診断メッセージで色を使うかどうかを指定します。
指定可能な値は<code class="literal">always</code>、<code class="literal">auto</code>、<code class="literal">never</code>です。
</p></dd></dl></div><p>
<span class="original">
This utility, like most other <productname>PostgreSQL</productname> utilities,
also uses the environment variables supported by <application>libpq</application>
(see <xref linkend="libpq-envars"/>).
</span>
このユーティリティは、他のほとんどの<span class="productname">PostgreSQL</span>ユーティリティと同様、<span class="application">libpq</span>がサポートする環境変数(<a class="xref" href="libpq-envars.html" title="32.15. 環境変数">32.15</a>参照)も使います。
</p></div><div class="refsect1" id="id-1.9.4.22.8"><h2>診断</h2><span class="original">
<title>Diagnostics</title>
</span><p>
<span class="original">
In case of difficulty, see <xref linkend="sql-reindex"/>
and <xref linkend="app-psql"/> for
discussions of potential problems and error messages.
The database server must be running at the
targeted host. Also, any default connection settings and environment
variables used by the <application>libpq</application> front-end
library will apply.
</span>
問題が発生した場合、考えられる原因とエラーメッセージについての説明は<a class="xref" href="sql-reindex.html" title="REINDEX"><span class="refentrytitle">REINDEX</span></a>と<a class="xref" href="app-psql.html" title="psql"><span class="refentrytitle"><span class="application">psql</span></span></a>を参照してください。
データベースサーバは、指定したホストで稼働している必要があります。
また、<span class="application">libpq</span>フロントエンドライブラリのデフォルトの設定や環境変数が適用されることに注意してください。
</p></div><div class="refsect1" id="id-1.9.4.22.9"><h2>例</h2><span class="original">
<title>Examples</title>
</span><p>
<span class="original">
To reindex the database <literal>test</literal>:
</span>
データベース<code class="literal">test</code>のインデックスを再作成します。
</p><pre class="screen">
<code class="prompt">$ </code><strong class="userinput"><code>reindexdb test</code></strong>
</pre><p>
</p><p>
<span class="original">
To reindex the table <literal>foo</literal> and the index
<literal>bar</literal> in a database named <literal>abcd</literal>:
</span>
<code class="literal">abcd</code>というデータベース内のテーブル<code class="literal">foo</code>のインデックスとインデックス<code class="literal">bar</code>を再作成します。
</p><pre class="screen">
<code class="prompt">$ </code><strong class="userinput"><code>reindexdb --table=foo --index=bar abcd</code></strong>
</pre></div><div class="refsect1" id="id-1.9.4.22.10"><h2>関連項目</h2><span class="original">
<title>See Also</title>
</span><span class="simplelist"><a class="xref" href="sql-reindex.html" title="REINDEX"><span class="refentrytitle">REINDEX</span></a></span></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="app-psql.html" title="psql">前へ</a> </td><td width="20%" align="center"><a accesskey="u" href="reference-client.html" title="PostgreSQLクライアントアプリケーション">上へ</a></td><td width="40%" align="right"> <a accesskey="n" href="app-vacuumdb.html" title="vacuumdb">次へ</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="application">psql</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 18.3文書">ホーム</a></td><td width="40%" align="right" valign="top"> <span class="application">vacuumdb</span></td></tr></table></div></body></html>