PostgreSQL

Creating the data source

PostgreSQL is the most efficient general purpose database for creating Data Warehouses and Data Lakes due to its efficiency in complex joins and high availability during insertions of high volumes of information.

 

Click here to access the tutorial on how to connect to your visualization tool:
Looker Studio
Power BI

 

In this article, we will show how to register a PostgreSQL database as a destination on the Kondado platform. 

Before adding the database, make sure that the database's username and server are accessible to our IPs that are listed here and then follow the steps below:

1) On the Kondado platform, go to the add new destinations page and select the PostgreSQL data destination

2) Fill in your database information as shown below:

  • Name: This is the internal description of your destination on the Kondado platform
  • Address: Your database server address (IP or DNS)
  • Port: Your database port (usually 5432)
  • Database: the name of the database
  • User: the username that Kondado will use to enter data into your database. This user must have permissions to DROP, INSERT, CREATE, ALTER, SELECT and DELETE tables and schemas 
  • Password: the user's password
  • Schema: inform a schema or leave the default “public” [1]

Click save and your new destination will be created!

[1] Kondado will try to create the schema with the value informed in the “schema” parameter and if this is not possible (for example, due to lack of permission), the public schema will be used. Even if the schema already exists, Kondado must have permission to create schemas (“GRANT CREATE ON DATABASE db TO user”) if you do not want to use the public schema. For existing schemas, it is also important that the user registered at Kondado has permission to use the schema (“GRANT USAGE ON SCHEMA schema_name TO user;”)

Pipelines

Summary

Relationship chart

Click to expand

Notes

  • Part of this documentation was automatically generated by AI and may contain errors. We recommend verifying critical information

Create a PostgreSQL data source on Kondado

Set up a PostgreSQL connection on Kondado to integrate your relational database into a cloud Data Warehouse or Data Lake for analytics.

1
Whitelist Kondado IPs

Configure your database server and VPC firewall to allow connections from Kondado's IP addresses on the PostgreSQL port. This secure network step is essential before any data integration can begin.

2
Gather connection credentials

Collect your PostgreSQL host address, port, database name, username, and password. You'll need these handy to authenticate when adding the source on the Kondado platform.

3
Add the PostgreSQL source on Kondado

Navigate to the data sources page on the Kondado platform, select PostgreSQL, give your source a descriptive name, and enter the credentials from the previous step.

4
Configure schema and save

Note that the schema parameter is for reference only—Kondado will discover all schemas, tables, views, and materialized views. Save the source to start integrating your data into your destination.

5
Set up incremental sync (optional)

For tables with a datetime/timestamp column tracking changes, enable incremental integration by defining the primary key (single or composite columns) to uniquely identify records.

Frequently asked questions

What PostgreSQL objects can Kondado integrate?
Kondado can integrate tables, views, and materialized views (mat views) from your PostgreSQL database. The platform discovers all schemas automatically, so you don't need to specify a single schema during setup.
How do I enable incremental data integration from PostgreSQL?
To enable incremental integration, your table needs a datetime/timestamp column that records when each row was inserted or modified. You must also define the primary key—this can be a single column or a composite of multiple columns that uniquely identify each record.
What happens to columns with special characters in their names?
Columns whose names contain special characters will be ignored during integration. Only columns with valid naming conventions will be synced to your destination Data Warehouse or Data Lake.
Why do I need to whitelist Kondado IPs before connecting?
Whitelisting Kondado's IP addresses on your database server and VPC is a security requirement that allows Kondado's infrastructure to establish a secure connection to your PostgreSQL instance over the specified port. Without this step, the connection will be blocked by your firewall.
Does the schema parameter limit which tables are integrated?
No. The value you provide in the "schema" parameter serves only as a reference. Kondado will consider all existing schemas when listing and integrating tables and views, giving you full coverage of your PostgreSQL data integration.

Written by·Published 2023-08-02·Updated 2026-06-01