Question: What are the differences between a PostgreSQL cluster, database, and schema?


In PostgreSQL, the terms 'cluster', 'database', and 'schema' refer to different levels of organization for data storage and management. Understanding these distinctions is crucial for effective database architecture and administration.

PostgreSQL Cluster

A PostgreSQL 'cluster' refers to a PostgreSQL server instance which manages multiple databases. It includes the postmaster process, along with other worker processes like background writers, WAL writer, autovacuum daemons, etc. The cluster manages the shared memory and serves as the primary component that ties together databases managed by PostgreSQL on a single machine or across multiple machines.

Each cluster has its own set of configuration files (like postgresql.conf and pg_hba.conf) and operates on a specific version of PostgreSQL. Data directory (PGDATA) is unique per cluster, containing all the databases managed by that instance.

PostgreSQL Database

Within a PostgreSQL cluster, you can have multiple databases. A database is a collection of schemas and serves as a container for data. Each database is isolated; this means that by default, any data defined in one database is not visible in another database. Databases are suited to situations where data needs to be segregated for security reasons or for managing large applications.

Here's how you create a new database in PostgreSQL:

CREATE DATABASE my_database;

PostgreSQL Schema

A schema in PostgreSQL is essentially a namespace within a database. It allows you to organize database objects (like tables, types, functions, and more) into logical groups to make them more manageable. One database can have multiple schemas, and they are particularly useful in multi-user environments to help manage access permissions and to organize data more efficiently.

Here's how you can create a schema within a database:

CREATE SCHEMA my_schema;

And creating a table within that schema would look like this:

CREATE TABLE my_schema.my_table ( id SERIAL PRIMARY KEY, name TEXT NOT NULL );


In summary, a PostgreSQL cluster is the top-level structure that controls multiple databases. A database exists within a cluster and is used to group related data under a single name, isolating it from other databases. Within each database, schemas are used to organize data into logical groups.

Understanding these layers and using them appropriately forms the backbone of effective data management in PostgreSQL.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.