Skip to main content
Documents
Basic SyntaxMath FunctionsDate FunctionsJSON FunctionsDatabasesTables & Schema ManagementString FunctionsTriggersIndexes

PostgreSQL B-Tree Indexes

Indexes in PostgreSQL are used to improve the performance of database queries by allowing faster retrieval of records. The B-Tree index is the default and most commonly used type of index, ideal for data retrieval operations involving comparisons.

Usage

B-Tree indexes are used when you need to efficiently search, retrieve, and sort data for operations using equality or range queries. They are automatically created on primary keys but can be manually created on other columns to optimize query performance.

CREATE INDEX index_name ON table_name (column_name);

In this syntax, CREATE INDEX creates a new index with a specified name on a particular column of a table, enhancing search and retrieval speeds. B-Tree indexes also store NULL values, which can be particularly useful when queries involve checking for the presence or absence of such values.

Examples

1. Basic Index Creation

CREATE INDEX idx_employee_name ON employees (name);

This example creates a B-Tree index on the name column of the employees table to speed up queries filtering or sorting by employee names.

SELECT * FROM employees WHERE name = 'John Doe';

This query benefits from the index, improving search speed.

2. Multi-Column Index

CREATE INDEX idx_order_date_customer ON orders (order_date, customer_id);

This syntax creates a B-Tree index on both order_date and customer_id columns, beneficial for queries involving both fields in the orders table.

SELECT * FROM orders WHERE order_date = '2023-10-01' AND customer_id = 123;

Here, the index optimizes retrieval by both order_date and customer_id.

3. Unique Index

CREATE UNIQUE INDEX idx_unique_email ON users (email);

A unique B-Tree index is created on the email column, ensuring all email addresses in the users table are distinct, while also improving query performance.

SELECT * FROM users WHERE email = 'example@example.com';

The unique index speeds up this query by quickly locating the specific email address.

Tips and Best Practices

  1. Index selectively. Only create indexes on columns frequently used in search conditions or join operations.
  2. Monitor index usage. Regularly analyze index usage with PostgreSQL tools like pg_stat_user_indexes and EXPLAIN to ensure they are beneficial.
  3. Be cautious with updates. Remember that indexes can slow down INSERT, UPDATE, and DELETE operations, so balance the need for speed with the overhead of maintaining indexes.
  4. Consider index size. Large indexes can consume significant disk space, so manage them wisely.
  5. Use partial indexes. Create partial indexes when only a subset of data is queried, improving performance and reducing index size. For example: 
    CREATE INDEX idx_active_users ON users (status) WHERE status = 'active';

Index Maintenance

  • Use REINDEX to rebuild indexes periodically, which can improve performance and reclaim storage space as data changes over time. For example: 
    REINDEX INDEX idx_employee_name;