Building SQL QueriesDocumentation

Connecting to Postgres in Heroku

By default, if you attach a single Postgres database to a Heroku app, Heroku will automatically set DATABASE_URL to the connection string. This means you can simply do:

import createConnectionPool from '@databases/pg';

const db = createConnectionPool();

Multiple Databases

If you connect a second database to your app, Heroku will assign it a different environment variable. In this case you can specify the connection string manually using either:

import createConnectionPool from '@databases/pg';

const db = createConnectionPool(process.env.HEROKU_POSTGRESQL_ROSE);


import createConnectionPool from '@databases/pg';

const db = createConnectionPool({
  connectionString: process.env.HEROKU_POSTGRESQL_ROSE,

Connecting from your local machine

Assuming you have installed the Heroku CLI, and authenticated (by running heroku login) you can connect to your Heroku database for one off scripts and debugging from your local machine using:

import {spawnSync} from 'child_process';
import createConnectionPool from '@databases/pg';

function getConnectionString(
  herokuInstanceID: string,
  environmentVariable: string = `DATABASE_URL`,
) {
  const result = spawnSync(
    [`config:get`, environmentVariable, `-a`, herokuInstanceID],
      stdio: [`inherit`, `pipe`, `inherit`],
      encoding: `utf8`,
  if (result.status !== 0) {
    return process.exit(result.status);
  return result.stdout.trim();

const db = createConnectionPool({
  connectionString: getConnectionString(`my-app-name`),
Google Cloud
Getting Started