Joining data from multiple Postgres databases

With the heyday of bigdata and people running lots of Postgres databases, sometimes one needs to join or search data from multiple absolutely regular and independent PostgreSQL databases (i.e. no built in clustering extensions or such are in use) to present it as one logical entity. Think sales reporting aggregations over logical clusters or matching click-stream info with sales orders based on customer ID-s.

So how to solve such ad-hoc tasks? One could of course solve it also on application level with some simple scripting but let’s say we only know SQL. Luckily PostgreSQL (plus the ecosystem) provide some options out of the box and there are also some 3rd party tools for cases when you for example can’t use the Postgres options (no superuser rights or extensions can be installed). So let’s look at the following 4 options:

  • dblink extension
  • postgres_fdw extension
  • Presto distributed SQL engine
  • UnityJDBC virtual driver + SQuirrelL SQL client

The dblink extension

Around since ever, this method might easily be the simplest way to join independent Postgres databases. Basically you just need to create the extension (requires „contrib“), declare a named connection and then use the dblink function to specify a query, including a list of output columns and their datatypes. The query will be sent over to the specified connection, and the pulled in dataset will be handeled as a normal subselect – thus from thereon one could use all the functionality that Postgres has to offer! Full documentation on the extension here.

Things to note:

  • Remote data is pulled onto the server without any extra information (statistics, indexes) so if the data amounts are bigger and there are many operations on higher nodes, most probably things will be non-optimal performancewise.
  • Increasing work_mem/temp_buffers might alleviate the IO penalty when working with bigger amounts of data pulled in from dblink.
  • One can also declare the connection directly in the dblink function itself, but then your SQL-s might get a bit unwieldy for larger amount of involved databases.

Pros: easiest setup possible, flexibility on connecting to X amount of Postgres DBs
Cons: SQLs could get ugly for mutiple joins, possible performance issues for bigger datasets, basic transaction support

The Postgres foreign-data wrapper

On board since 9.3, the Postgres foreign-data wrapper (postgres_fdw extension, available in „contrib“) is an improvement over dblink and is well suitable for more permanent data crunching and one could even build complex sharding/scaling architectures on top of it with the introduction of „foreign table inheritance“ in 9.6. Basically what you get here is a permanent „symlink / synonym“ to a table/view on another database, with the benefit that the local Postgres database (where the user is connected) already has the column details on the table – most importantly size and data distribution statistics, so that it can figure out better execution plans. True, in older Postgres versions the plans were not always too optimal but recent 9.6 version got a lot of attention in that area. NB! The FDW also supports writing/changing data and transactions! Full documentation here.

Overview of steps required for setup:

  1. Install the extension
  2. Create a foreign server
  3. Create an user mapping (so that different users could do be allowed to perform different operations on the remote tables)
  4. Define foreign tables by specifying columns yourself or importing whole tables/schemas automatically (9.5+)
  5. Run some SQL..

Pros: schema introspection, performance, allows data modifications, full transaction support
Cons: quite some steps needed for setup + user management


Presto is an open source distributed SQL query engine, meant to connect the most different „bigdata“ datasources via SQL, thus not really Postgres-centric but DB-agnostic. Created by Facebook to juggle Terabytes of data for analytical workloads, one can expect it to handle your data amounts efficiently though. Basically it is a Java-based query parser/coordinator/worker framework, so not the most light-weight approach, but definitely worth a try even for smaller amounts of data. For bigger amounts of data it assumes nodes with a lot of RAM!

Setup might look scary at first, but it will actually only take minutes to get going as the docs are great. Process in general can be seen below. See docs for setup details here.

  1. Download the tarball
  2. Create a couple of simple config files as shown in the deplyment manual
  3. Start the server with „bin/launcher start“
  4. Launch the query client with „./presto –server localhost:8080 –catalog hive –schema default“
  5. Run some SQLs over independent DB-s
presto:default> SELECT count(*) FROM postgres.public.t1 x INNER JOIN kala.public.t1 y ON x.c1 = y.c1;
(1 row)

Query 20170731_122315_00004_s3nte, FINISHED, 1 node
Splits: 67 total, 67 done (100.00%)
0:00 [3 rows, 0B] [12 rows/s, 0B/s]

Pros: Lot of datasources, good SQL support, good documentation, monitoring dashboard
Cons: Setup (server + client), full SQL re-implementation thus you’ll lose Postgres analytic functions etc

UnityJDBC + SQuirrelL SQL Client

Another „generic“ solution for connecting various databases, including Postgres, via standard SQL can be performed by using the Unity „virtual datasource“ plugin for the popular SQL client called SQuirreL. Actually some other SQL client can be used also, SQuirreL just seems to be well documented.

General process here is following:

  1. Install the SQuirreL SQL client
  2. Place the Postgres JDBC and the Unity JDBC driver in the „lib“ folder
  3. Register normal Postgres data sources (called „aliases“) in SQuirreL
  4. Registrer the virtual driver
  5. Connect to the virtual driver and on the following screen add previously registered „normal“ data sources to the session
  6. Run SQL

Pros: relatively easy setup, user level access, many other datasources (MySQL, MSSQL, Oracle, MongoDB) supported
Cons: Commercial licence, limited to 100 result rows/2 DBs in trial mode, SQL-92 compliant thus don’t expect all the fancy Postgres syntax to work

SQuirrel SQL Client

That’s all. Hope you found out something new and let me know in the comments if you know some other cool approaches for ad hoc mixing of data from different Postgres databases. Thanks a lot!

Kaarel Moppel
I’ve been interested with databases for the last 10 years, working last 6 years exclusively with PostgreSQL. And still I’m constantly surprised by it’s powerful set of features and the fast pace of development by the globally friendly community. On my spare time I enjoy playing soccer and travelling.