Skip to Main Content
Practical PostgreSQL
book

Practical PostgreSQL

by Joshua D. Drake, John C. Worsley
January 2002
Intermediate to advanced content levelIntermediate to advanced
640 pages
16h 39m
English
O'Reilly Media, Inc.
Content preview from Practical PostgreSQL

Cluster

Provides the backend server with clustering information about a table.

Synopsis

CLUSTER indexname ON tablename

Parameters

indexname

The name of the index to use in clustering.

tablename

The name of the table you wish to cluster.

Results

CLUSTER

The message returned when a table is successfully clustered.

ERROR: CLUSTER: "indexname" is not an index for table "tablename"

The error returned if you attempt to cluster an index indexname which is not placed on the specified table (tablename).

ERROR: Index "indexname" does not exist

The error returned if the specified index (indexname) cannot be found in the connected database.

ERROR: Relation "tablename" does not exist

The error returned if the specified table (tablename) cannot be found in the connected database.

ERROR: Relation "child_table" inherits from "tablename"

The error returned if the specified table (tablename) is inherited by another table (child_table).

Description

Use the CLUSTER command to cluster a table on a specific index. The table (identified by the tablename parameter) must already, exist and the index (identified by the indexname parameter) must exist, and be placed on the table.

During clustering, a table is reordered for performance in an arrangement based on the specified index. A cluster is a one-time operation upon a table; to recluster a table, you must execute the command again.

Note

Description

When a cluster is created, the rows of ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

PostgreSQL: Up and Running, 2nd Edition

PostgreSQL: Up and Running, 2nd Edition

Regina O. Obe, Leo S. Hsu
Learning PostgreSQL 11 - Third Edition

Learning PostgreSQL 11 - Third Edition

Christopher Travers, Andrey Volkov
Learn PostgreSQL

Learn PostgreSQL

Luca Ferrari, Enrico Pirozzi
PostgreSQL 13 Cookbook

PostgreSQL 13 Cookbook

Vallarapu Naga Avinash Kumar

Publisher Resources

ISBN: 9781449309770Supplemental ContentErrata Page