PostgreSQL – Multicolumn Indexes

Last Updated : 17 Jul, 2024

In PostgreSQL, multicolumn indexes, also known as composite indexes, combined indexes, or concatenated indexes, are indexes defined on more than one column of a table. These indexes can significantly improve query performance by allowing the database to quickly locate rows based on multiple column values.

Let us better understand the Multicolumn Indexes in PostgreSQL from this article.

What are Multicolumn Indexes?

A multicolumn index is an index created on multiple columns of a table. PostgreSQL supports multicolumn indexes with a maximum of 32 columns, though this limit can be changed by modifying the ‘pg_config_manual.h' file when building PostgreSQL. Only B-tree, GIST, GIN, and BRIN index types support multicolumn indexes.

Syntax

The following syntax shows how to create a multicolumn index:

CREATE INDEX index_name
ON table_name(a, b, c, ...);

Optimizing Multicolumn Index Usage

When defining a multicolumn index, one should place the columns which are often used in the WHERE clause at the beginning of the column list and the columns that are less frequently used in the condition after.

The PostgreSQL optimizer considers using the index in the following cases:

‘WHERE a = v1 and b = v2 and c = v3‘;
‘WHERE a = v1 and b = v2‘;
‘WHERE a = v1‘;

However, it will not consider using the index in the following cases:

‘WHERE c = v3;’
‘WHERE b = v2 and c = v3;’

PostgreSQL Multicolumn Indexes Example

To demonstrate multicolumn indexes, we will create a new table named ‘people’ with three columns: id, ‘first_name’, and ‘last_name’:

CREATE TABLE people(
    id INT GENERATED BY DEFAULT AS IDENTITY,
    first_name VARCHAR(50) NOT NULL,
    last_name VARCHAR(50) NOT NULL
);

You can add data to the people through this file.

The following statement finds people whose last name is Adams.

Query Without Index:

SELECT
    *
FROM
    people
WHERE
    last_name = 'Adams';

This will result in the following:

PostgreSQL Multicolumn Indexes Example

As shown clearly in the output, PostgreSQL performed the sequential scan on the ‘people’ table to find the corresponding rows because there was no index defined for the ‘last_name’ column.

Let’s define a B-tree index on both ‘last_name’ and ‘first_name’ columns. Assuming that searching for people by the last name is more often than by the first name, we define the index with the following column order.

CREATE INDEX idx_people_names 
ON people (last_name, first_name);

Now, if you search for people whose last name is Adams, the PostgreSQL optimizer will use the index as shown in the output of the following statement:

Query With Index:

EXPLAIN SELECT *
FROM
    people
WHERE
    last_name = 'Adams';

This will output the below:

PostgreSQL Multicolumn Indexes Example

The following statement finds the person whose last name is Adams and the first name is Lou.

Complex Query With Index:

SELECT
    *
FROM
    people
WHERE
    last_name = 'Adams'
AND first_name = 'Lou';

This will lead to the following:

PostgreSQL Multicolumn Indexes Example

The PostgreSQL Optimizer used the index for this statement because both columns in the WHERE clause are all in the index.

EXPLAIN SELECT *
FROM
    people
WHERE
    last_name = 'Adams'
AND first_name = 'Lou';

However, if you search for people whose first name is Lou, PostgreSQL will perform sequential scan the table instead of using the index as shown in the output of the following statement.

Query Not Using the Index:

EXPLAIN SELECT *
FROM
    people
WHERE
    first_name = 'Lou';

Output:

PostgreSQL Multicolumn Indexes Example

Important Points About PostgreSQL Multicolumn Indexes

The order of columns in a multicolumn index is crucial. Place the most frequently queried columns first to ensure the index is used effectively.

Multicolumn indexes can be large and may require additional maintenance. Regularly analyze and vacuum your database to maintain performance.

Ensure that the indexed columns have high selectivity. Columns with low selectivity (many duplicate values) may not benefit from indexing.

While multicolumn indexes can improve query performance, they also add overhead to write operations (INSERT, UPDATE, DELETE).

Always use the EXPLAIN command to analyze how PostgreSQL executes your queries.