How to connect to PostgreSQL

Vero can connect to your PostgreSQL database, run queries against it and use the results of those queries to send email messages to your customers. In Vero, database connections are referred to as Data Sources.

Adding your database

To add an external database, click Data Sources and Add Data Source. In the menu that appears, choose the database you want to add:

choose-database-type

To add a database you will need the following credentials:

  • Host. The web or IP address of the database.
  • Port. The port that is accepting connections (e.g. typically 5432 for PostgreSQL).
  • Username.
  • Password.
  • Database name. The name of the database to connect to.

enter-database-credentials

Testing your connection

Once you’ve entered your database credentials, select Connect. Vero will automatically test the connection:

test-database-connection

If there is a problem connecting to your database, please check your database credentials are correct and try again.

Create a read-only user

Vero will only execute SELECT queries against your database: it is read only by design.

That said, we would recommend creating a user login that only has read access to your database.

Vero will show users all available tables when using the SQL editor in our UI. Limiting the tables and columns that Vero has access to is good practice.

Direct connect with IP whitelisting

Vero will connect directly to your database over the public internet. This approach requires your network and database to be configured to allow Vero’s servers to connect to it.

In order to use Direct Connect, your database must:

  • Be publicly accessible over the internet
  • Be allowed to accept incoming connections from our IP addresses (listed below)

We would recommend whitelisting access to your database via a single IP address. Vero will always make queries via the following IP address: 3.208.52.255.

Currently supported database versions

Vero Connect officially supports PostgreSQL (9.6+).

At the moment we support PostgreSQL-style databases and it’s possible configurations outside of the above may work. That said, we currently only provide support for the databases listed above.

We will be adding support for more database and data stores in the future, please let us know what you would like to see us support on our Vero Connect feedback board.

FAQs

Query limits

Vero will show your query results in blocks of 100 in the UI. In order to load an audience you will need to load your entire query (without a LIMIT clause).

There is no technical limit to the number of rows you can query using Vero’s UI but we have currently tested up to one million rows consistently.

Query timeout

Vero will currently timeout queries after 12 hours.

Authors

  • Chris Hexton
    CEO and Co-Founder