Imported upstream version 1.5
[manpages-zh.git] / src / man1 / clusterdb.1
blob67c9cf10e8fd2bbb2995ec13d7eea24a16859a86
1 .\\" auto-generated by docbook2man-spec $Revision: 1.1 $
2 .TH "CLUSTERDB" "1" "2003-11-02" "Application" "PostgreSQL Client Applications"
3 .SH NAME
4 clusterdb \- 对一个PostgreSQL数据库进行建簇
6 .SH SYNOPSIS
7 .sp
8 \fBclusterdb\fR\fR [ \fR\fB\fIconnection-option\fB\fR...\fB \fR\fR]\fR\fR [ \fR\fB--table | -t \fItable\fB  \fR\fR]\fR\fR [ \fR\fB\fIdbname\fB \fR\fR]\fR
10 \fBclusterdb\fR\fR [ \fR\fB\fIconnection-option\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--all\fR\fR | \fR\fB-a\fR\fR ]\fR
11 .SH "DESCRIPTION 描述"
12 .PP
13 \fBclusterdb\fR 是一个用于对某个 PostgreSQL  数据库中的表进行重新建簇的工具。它寻找以前建过簇的表,然后在上次用过的同一个索引上再次建簇。将不会动那些从未建簇的表。
14 .PP
15 \fBclusterdb\fR 是对 SQL 命令 CLUSTER[\fBcluster\fR(7)] 的封装。 使用这两种方法对数据库建簇实际上没有任何区别。
16 .SH "OPTIONS 选项"
17 .PP
18 \fBclusterdb\fR 接受下列命令行参数:
19 .TP
20 \fB-a\fR
21 .TP
22 \fB--all\fR
23  对所有数据库建簇。
24 .TP
25 \fB[-d] \fIdbname\fB\fR
26 .TP
27 \fB[--dbname] \fIdbname\fB\fR
28  声明要建簇的数据库名字。如果没有声明这个并且没有使用 -a(或者 --all), 那么数据库名从环境变量 PGDATABASE 中读取。 如果那个也没有设置,那么使用用于连接的用户名。
29 .TP
30 \fB-e\fR
31 .TP
32 \fB--echo\fR
33  回显 clusterdb 生成并发送给服务器的命令。
34 .TP
35 \fB-q\fR
36 .TP
37 \fB--quiet\fR
38  不要显示响应。
39 .TP
40 \fB-t \fItable\fB\fR
41 .TP
42 \fB--table \fItable\fB\fR
43  只对表 table 建簇。
44 .PP
45 .PP
46 \fBclusterdb\fR 还接受下列命令行参数获取连接参数:
47 .TP
48 \fB-h \fIhost\fB\fR
49 .TP
50 \fB--host \fIhost\fB\fR
51  声明服务器运行所在的机器的主机名。如果值以斜杠开头, 那么就用作 Unix 域套接字的目录。
52 .TP
53 \fB-p \fIport\fB\fR
54 .TP
55 \fB--port \fIport\fB\fR
56  声明服务器监听的网际网 TCP 端口或者本地 Unix 域套接字文件扩展。
57 .TP
58 \fB-U \fIusername\fB\fR
59 .TP
60 \fB--username \fIusername\fB\fR
61  进行连接的用户名
62 .TP
63 \fB-W\fR
64 .TP
65 \fB--password\fR
66  强制提示口令。
67 .PP
68 .SH "ENVIRONMENT 环境"
69 .TP
70 \fBPGDATABASE\fR
71 .TP
72 \fBPGHOST\fR
73 .TP
74 \fBPGPORT\fR
75 .TP
76 \fBPGUSER\fR
77  缺省连接参数。
78 .SH "DIAGNOSTICS 诊断"
79 .PP
80  出现困难的时候,参阅 CLUSTER [\fBcluster\fR(7)] 和 \fBpsql\fR(1) 获取有关可能的错误和错误信息的讨论。 数据库服务器必须在目标主机上运行。同样,任何缺省连接设置和 libpq 前端库使用的环境变量都将得以应用。
81 .SH "EXAMPLES 例子"
82 .PP
83  对数据库 test 建簇:
84 .sp
85 .nf
86 $ \fBclusterdb test\fR
87 .sp
88 .fi
89 .PP
90  对一个叫做 xyzzy 的数据库里的表 foo 建簇:
91 .sp
92 .nf
93 $ \fBclusterdb --table foo xyzzy\fR
94 .sp
95 .fi
96 .SH "SEE ALSO 参见"
97 CLUSTER [\fBcluster\fR(7)]
99 .SH "译者"
100 .B Postgresql 中文网站
101 .B 何伟平 <laser@pgsqldb.org>