D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
opt
/
alt
/
postgresql11
/
usr
/
share
/
man
/
man1
/
Filename :
reindexdb.1
back
Copy
'\" t .\" Title: reindexdb .\" Author: The PostgreSQL Global Development Group .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> .\" Date: 2017-11-06 .\" Manual: PostgreSQL 9.2.24 Documentation .\" Source: PostgreSQL 9.2.24 .\" Language: English .\" .TH "REINDEXDB" "1" "2017-11-06" "PostgreSQL 9.2.24" "PostgreSQL 9.2.24 Documentation" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" reindexdb \- reindex a PostgreSQL database .\" reindexdb .SH "SYNOPSIS" .HP \w'\fBreindexdb\fR\ 'u \fBreindexdb\fR [\fIconnection\-option\fR...] [\fB\-\-table\fR | \fB\-t\fR \fItable\fR] [\fB\-\-index\fR | \fB\-i\fR \fIindex\fR] [\fIdbname\fR] .HP \w'\fBreindexdb\fR\ 'u \fBreindexdb\fR [\fIconnection\-option\fR...] \fB\-\-all\fR | \fB\-a\fR .HP \w'\fBreindexdb\fR\ 'u \fBreindexdb\fR [\fIconnection\-option\fR...] \fB\-\-system\fR | \fB\-s\fR [\fIdbname\fR] .SH "DESCRIPTION" .PP reindexdb is a utility for rebuilding indexes in a PostgreSQL database\&. .PP reindexdb is a wrapper around the SQL command \fBREINDEX\fR(7)\&. There is no effective difference between reindexing databases via this utility and via other methods for accessing the server\&. .SH "OPTIONS" .PP reindexdb accepts the following command\-line arguments: .PP \fB\-a\fR, \fB\-\-all\fR .RS 4 Reindex all databases\&. .RE .PP \fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR, \fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR .RS 4 Specifies the name of the database to be reindexed\&. If this is not specified and \fB\-a\fR (or \fB\-\-all\fR) is not used, the database name is read from the environment variable \fBPGDATABASE\fR\&. If that is not set, the user name specified for the connection is used\&. .RE .PP \fB\-e\fR, \fB\-\-echo\fR .RS 4 Echo the commands that reindexdb generates and sends to the server\&. .RE .PP \fB\-i \fR\fB\fIindex\fR\fR, \fB\-\-index=\fR\fB\fIindex\fR\fR .RS 4 Recreate \fIindex\fR only\&. .RE .PP \fB\-q\fR, \fB\-\-quiet\fR .RS 4 Do not display progress messages\&. .RE .PP \fB\-s\fR, \fB\-\-system\fR .RS 4 Reindex database\*(Aqs system catalogs\&. .RE .PP \fB\-t \fR\fB\fItable\fR\fR, \fB\-\-table=\fR\fB\fItable\fR\fR .RS 4 Reindex \fItable\fR only\&. .RE .PP \fB\-V\fR, \fB\-\-version\fR .RS 4 Print the reindexdb version and exit\&. .RE .PP \fB\-?\fR, \fB\-\-help\fR .RS 4 Show help about reindexdb command line arguments, and exit\&. .RE .PP reindexdb also accepts the following command\-line arguments for connection parameters: .PP \fB\-h \fR\fB\fIhost\fR\fR, \fB\-\-host=\fR\fB\fIhost\fR\fR .RS 4 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\&. .RE .PP \fB\-p \fR\fB\fIport\fR\fR, \fB\-\-port=\fR\fB\fIport\fR\fR .RS 4 Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. .RE .PP \fB\-U \fR\fB\fIusername\fR\fR, \fB\-\-username=\fR\fB\fIusername\fR\fR .RS 4 User name to connect as\&. .RE .PP \fB\-w\fR, \fB\-\-no\-password\fR .RS 4 Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a \&.pgpass 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\&. .RE .PP \fB\-W\fR, \fB\-\-password\fR .RS 4 Force reindexdb to prompt for a password before connecting to a database\&. .sp This option is never essential, since reindexdb will automatically prompt for a password if the server demands password authentication\&. However, reindexdb will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing \fB\-W\fR to avoid the extra connection attempt\&. .RE .PP \fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR .RS 4 Specifies the name of the database to connect to discover what other databases should be reindexed\&. If not specified, the postgres database will be used, and if that does not exist, template1 will be used\&. .RE .SH "ENVIRONMENT" .PP \fBPGDATABASE\fR, \fBPGHOST\fR, \fBPGPORT\fR, \fBPGUSER\fR .RS 4 Default connection parameters .RE .PP This utility, like most other PostgreSQL utilities, also uses the environment variables supported by libpq (see Section 31.14, \(lqEnvironment Variables\(rq, in the documentation)\&. .SH "DIAGNOSTICS" .PP In case of difficulty, see \fBREINDEX\fR(7) and \fBpsql\fR(1) 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 libpq front\-end library will apply\&. .SH "NOTES" .PP reindexdb might need to connect several times to the PostgreSQL server, asking for a password each time\&. It is convenient to have a ~/\&.pgpass file in such cases\&. See Section 31.15, \(lqThe Password File\(rq, in the documentation for more information\&. .SH "EXAMPLES" .PP To reindex the database test: .sp .if n \{\ .RS 4 .\} .nf $ \fBreindexdb test\fR .fi .if n \{\ .RE .\} .PP To reindex the table foo and the index bar in a database named abcd: .sp .if n \{\ .RS 4 .\} .nf $ \fBreindexdb \-\-table foo \-\-index bar abcd\fR .fi .if n \{\ .RE .\} .SH "SEE ALSO" \fBREINDEX\fR(7)