DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

reindexdb(1)





NAME

       reindexdb - reindex a PostgreSQL database


SYNOPSIS

       reindexdb  [ connection-option... ]  [ --table | -t table  ]  [ --index
       | -i index  ]  [ dbname ]

       reindexdb [ connection-option... ]  [ --all | -a ]

       reindexdb [ connection-option... ]  [ --system | -s ]  [ dbname ]


DESCRIPTION

       reindexdb is a utility for rebuilding indexes in a PostgreSQL database.

       reindexdb  is  a  wrapper  around the SQL command REINDEX [reindex(5)].
       There is no effective difference between reindexing databases via  this
       utility and via other methods for accessing the server.


OPTIONS

       reindexdb accepts the following command-line arguments:

       -a

       --all  Reindex all databases.

       -s

       --system
              Reindex database's system catalogs.

       -t table

       --table table
              Reindex table only.

       -i index

       --index index
              Recreate index only.

       [-d] dbname

       [--dbname] dbname
              Specifies  the name of the database to be reindexed.  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.

       -e

       --echo Echo the commands that reindexdb  generates  and  sends  to  the
              server.

       -q

       --quiet
              Do not display a response.

       reindexdb also accepts the following command-line arguments for connec-
       tion parameters:

       -h host

       --host host
              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.

       -p port

       --port port
              Specifies the TCP port or local Unix domain socket  file  exten-
              sion on which the server is listening for connections.

       -U username

       --username username
              User name to connect as.

       -W

       --password
              Force password prompt.


ENVIRONMENT

       PGDATABASE

       PGHOST

       PGPORT

       PGUSER Default connection parameters

       This utility, like most other PostgreSQL utilities, also uses the envi-
       ronment variables supported by libpq (see in the documentation).


DIAGNOSTICS

       In case of difficulty, see REINDEX [reindex(5)] and psql(1) for discus-
       sions  of  potential  problems and error messages.  The database server
       must be running at the targeted host. Also, any default connection set-
       tings  and  environment  variables  used by the libpq front-end library
       will apply.


NOTES

       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 in the documentation for more information.


EXAMPLES

       To reindex the database test:

       $ reindexdb test

       To reindex the table foo and the index bar in a database named abcd:

       $ reindexdb --table foo --index bar abcd


SEE ALSO

       REINDEX [reindex(5)]

Application                       2008-06-08                      REINDEXDB(1)

Man(1) output converted with man2html