How to use Hash Joins in PostgreSQL?

In PostgreSQL, hash joins are used to join two tables based on a join condition that involves equality comparisons. The optimizer automatically chooses this join method if it determines that a hash join would be more efficient than other join methods, such as nested loop or merge joins, based on the query and the statistics of the participating tables. Here’s how hash joins work and some considerations for their use:

Understanding Hash Joins

  1. Operation: A hash join operates in two phases: the build phase and the probe phase. In the build phase, PostgreSQL reads rows from one of the join tables (typically the smaller one, referred to as the “inner” table) and creates a hash table in memory based on the join key. In the probe phase, it scans the other table (the “outer” table) and uses the hash table to quickly find matching rows from the inner table.
  2. Memory Use: Hash joins are memory-intensive because they require enough memory to store the hash table created from the inner table. The amount of memory available for hash joins (and other operations like sorting) is controlled by the work_mem configuration parameter. If the hash table exceeds the available memory specified by work_mem, PostgreSQL will spill data to disk, which can significantly slow down the join operation.

How to Influence PostgreSQL to Use Hash Joins

While PostgreSQL’s query planner automatically selects the join method based on cost estimates, you can influence its decisions through:

  1. Adjusting work_mem: Increasing work_mem can make hash joins more attractive to the planner by reducing the cost associated with creating the hash table. Be cautious, as setting work_mem too high can lead to excessive memory consumption, especially with many concurrent queries.SET work_mem = '64MB';
  2. Changing the Query Structure: While you typically should not need to force the planner’s hand, making sure that the statistics are up to date (ANALYZE), and writing queries that clearly express intended joins, can help the planner make better decisions.
  3. Enabling or Disabling Join Methods: In rare cases, for testing or very specific workloads, you might want to enable or disable certain join methods. This can be done using enable_hashjoinenable_mergejoin, and enable_nestloop configuration parameters. To encourage hash joins, ensure enable_hashjoin is set to on.SET enable_hashjoin = on;

Monitoring and Analysis

To see whether PostgreSQL is using a hash join for a particular query, use the EXPLAIN statement to examine the query plan:

Look for the “Hash Join” line in the output, which indicates that PostgreSQL has chosen to use a hash join for this query.


Hash joins can be an efficient way to perform joins on large datasets, especially when the join condition is based on equality and the size of one of the tables is significantly smaller than the other. PostgreSQL automatically optimizes queries to use hash joins when appropriate, but understanding how they work and how to influence the planner can help you troubleshoot and optimize query performance. Always consider the overall workload and system resources when tuning parameters like work_mem.

About Shiv Iyer 444 Articles
Open Source Database Systems Engineer with a deep understanding of Optimizer Internals, Performance Engineering, Scalability and Data SRE. Shiv currently is the Founder, Investor, Board Member and CEO of multiple Database Systems Infrastructure Operations companies in the Transaction Processing Computing and ColumnStores ecosystem. He is also a frequent speaker in open source software conferences globally.