Partitioning best practices in PostgreSQL

Introduction

Partitioning helps organize large tables into smaller pieces, making data easier and faster to manage.

When you have a very large table that slows down queries.

When you want to archive old data separately but keep it accessible.

When you want to improve query speed by scanning only relevant parts of data.

When you want to manage data by time periods, like months or years.

When you want to delete or load data in chunks without affecting the whole table.

Syntax

PostgreSQL

CREATE TABLE table_name (
  column1 datatype,
  column2 datatype,
  ...
) PARTITION BY partition_method (column_name);

partition_method can be RANGE, LIST, or HASH depending on how you want to split data.

Each partition is a separate table holding a subset of data.

Examples

This creates a sales table partitioned by date ranges.

PostgreSQL

CREATE TABLE sales (
  id SERIAL PRIMARY KEY,
  sale_date DATE NOT NULL,
  amount NUMERIC
) PARTITION BY RANGE (sale_date);

This creates a logs table partitioned by specific log levels.

PostgreSQL

CREATE TABLE logs (
  id SERIAL PRIMARY KEY,
  log_level TEXT NOT NULL,
  message TEXT
) PARTITION BY LIST (log_level);

This creates a users table partitioned by hashing the id.

PostgreSQL

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  region TEXT NOT NULL,
  name TEXT
) PARTITION BY HASH (id);

Sample Program

This example creates an orders table partitioned by year. It inserts data into two partitions and queries orders from 2024.

PostgreSQL

CREATE TABLE orders (
  order_id SERIAL PRIMARY KEY,
  order_date DATE NOT NULL,
  customer_id INT,
  amount NUMERIC
) PARTITION BY RANGE (order_date);

CREATE TABLE orders_2023 PARTITION OF orders
  FOR VALUES FROM ('2023-01-01') TO ('2024-01-01');

CREATE TABLE orders_2024 PARTITION OF orders
  FOR VALUES FROM ('2024-01-01') TO ('2025-01-01');

INSERT INTO orders (order_date, customer_id, amount) VALUES
  ('2023-05-10', 1, 100.00),
  ('2024-03-15', 2, 150.00);

SELECT * FROM orders WHERE order_date >= '2024-01-01';

Important Notes

Always choose a partition key that matches your common query filters to speed up searches.

Keep partitions balanced in size to avoid some partitions becoming too large or too small.

Use partitioning to simplify data management tasks like archiving or deleting old data.

Summary

Partitioning breaks big tables into smaller, manageable parts.

Choose partition keys based on how you query your data.

Use RANGE, LIST, or HASH methods depending on your data and needs.

Practice

1. What is the main benefit of using table partitioning in PostgreSQL?

easy

A. It breaks a large table into smaller, manageable parts to improve performance.

B. It automatically creates backups of the table data.

C. It encrypts the table data for security.

D. It merges multiple tables into one large table.

Solution

1. Step 1: Understand what partitioning does

   Partitioning divides a big table into smaller pieces called partitions.

2. Step 2: Identify the benefit of smaller parts

   Smaller parts make queries faster and data easier to manage.

3. Final Answer:

   It breaks a large table into smaller, manageable parts to improve performance. -> Option A

4. Quick Check:

   Partitioning = smaller parts for performance [OK]

Hint: Partitioning splits big tables for easier handling [OK]

Common Mistakes:

• Thinking partitioning creates backups
• Confusing partitioning with encryption
• Believing partitioning merges tables

2. Which of the following is the correct syntax to create a range partitioned table in PostgreSQL?

easy

A. CREATE TABLE sales (id INT, sale_date DATE) PARTITION BY LIST (sale_date);

B. CREATE TABLE sales PARTITION BY RANGE (sale_date) (id INT, sale_date DATE);

C. CREATE TABLE sales (id INT, sale_date DATE) PARTITION ON RANGE sale_date;

D. CREATE TABLE sales (id INT, sale_date DATE) PARTITION BY RANGE (sale_date);

Solution

1. Step 1: Recall correct partition syntax

   PostgreSQL uses PARTITION BY RANGE (column) after table columns.

2. Step 2: Check each option

   CREATE TABLE sales (id INT, sale_date DATE) PARTITION BY RANGE (sale_date); matches syntax: columns first, then PARTITION BY RANGE.

3. Final Answer:

   CREATE TABLE sales (id INT, sale_date DATE) PARTITION BY RANGE (sale_date); -> Option D

4. Quick Check:

   PARTITION BY RANGE after columns = correct syntax [OK]

Hint: Partition type follows column definitions in CREATE TABLE [OK]

Common Mistakes:

• Placing PARTITION BY before columns
• Using PARTITION ON instead of PARTITION BY
• Confusing RANGE with LIST partition type

3. Given the following partition setup:

CREATE TABLE orders (id INT, region TEXT, order_date DATE) PARTITION BY LIST (region);
CREATE TABLE orders_us PARTITION OF orders FOR VALUES IN ('US');
CREATE TABLE orders_eu PARTITION OF orders FOR VALUES IN ('EU');

What will be the result of this query?

INSERT INTO orders VALUES (1, 'US', '2024-01-01');
SELECT * FROM orders WHERE region = 'US';

medium

A. Returns the row with id 1, region 'US', and date '2024-01-01'.

B. Returns no rows because the partition is missing.

C. Causes a syntax error due to missing partition key.

D. Returns rows from all partitions regardless of region.

Solution

1. Step 1: Understand LIST partitioning by region

   Rows with region 'US' go to orders_us partition.

2. Step 2: Insert and select behavior

   Insert puts row in orders_us; select filters region='US', so row is returned.

3. Final Answer:

   Returns the row with id 1, region 'US', and date '2024-01-01'. -> Option A

4. Quick Check:

   List partition returns matching rows [OK]

Hint: Rows go to partition matching partition key value [OK]

Common Mistakes:

• Assuming insert fails without default partition
• Expecting syntax error on insert
• Thinking select ignores partition keys

4. You have this partitioned table:

CREATE TABLE logs (id SERIAL, log_date DATE) PARTITION BY RANGE (log_date);
CREATE TABLE logs_2023 PARTITION OF logs FOR VALUES FROM ('2023-01-01') TO ('2024-01-01');

Which error will occur if you run this?

INSERT INTO logs (log_date) VALUES ('2022-12-31');

medium

A. ERROR: syntax error near VALUES

B. ERROR: no partition found for row

C. The row is inserted into logs_2023 partition

D. The row is inserted into a default partition automatically

Solution

1. Step 1: Check partition ranges

   logs_2023 covers dates from 2023-01-01 to 2024-01-01 only.

2. Step 2: Insert date outside partition range

   2022-12-31 is before 2023-01-01, so no matching partition exists.

3. Final Answer:

   ERROR: no partition found for row -> Option B

4. Quick Check:

   Insert outside range = no partition error [OK]

Hint: Insert date must fit partition range or error occurs [OK]

Common Mistakes:

• Expecting automatic default partition
• Thinking syntax error occurs
• Assuming row goes to nearest partition

5. You want to optimize queries filtering by user_id and created_at date on a large table. Which partitioning strategy is best practice?

hard

A. Use HASH partitioning on created_at only.

B. Use LIST partitioning on user_id only.

C. Use RANGE partitioning on created_at and subpartition by HASH on user_id.

D. Do not partition; use a single large table with indexes.

Solution

1. Step 1: Analyze query filters

   Queries filter by user_id and created_at, so both should guide partitioning.

2. Step 2: Choose partitioning methods

   RANGE on created_at handles date ranges well; HASH subpartitioning on user_id balances data.

3. Step 3: Evaluate other options

   LIST on user_id alone is inefficient for many users; HASH on created_at is unusual; no partitioning misses benefits.

4. Final Answer:

   Use RANGE partitioning on created_at and subpartition by HASH on user_id. -> Option C

5. Quick Check:

   Combine RANGE and HASH for multi-column filtering [OK]

Hint: Combine RANGE for dates and HASH for IDs for best performance [OK]

Common Mistakes:

• Using LIST for high-cardinality user_id
• Hash partitioning on date column only
• Skipping partitioning on large tables