PostgreSQL connection

To access your data in PostgreSQL, create a connection asset for it.

PostgreSQL is an open source and customizable object-relational database.

Supported versions

  • PostgreSQL 15.0 and later
  • PostgreSQL 14.0 and later
  • PostgreSQL 13.0 and later
  • PostgreSQL 12.0 and later
  • PostgreSQL 11.0 and later
  • PostgreSQL 10.1 and later
  • PostgreSQL 9.6 and later

Create a connection to PostgreSQL

To create the connection asset, you need the following connection details:

  • Database name
  • Hostname or IP address
  • Port number
  • Username and password
  • SSL certificate (if required by the database server)

Select Server proxy to access the PostgreSQL data source through a server proxy. Depending on its setup, a server proxy can provide load balancing, increased security, and privacy. The server proxy settings are independent of the authentication credentials and the personal or shared credentials selection. The server proxy settings cannot be stored in a vault.

  • Proxy hostname or IP address: The proxy URL. For example, https://proxy.example.com.
  • Server proxy port: The port number to connect to the proxy server. For example, 8080 or 8443.
  • The Proxy username and Proxy password fields are optional.

For Credentials and Certificates, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

Choose the method for creating a connection based on where you are in the platform

In a project
Click Assets > New asset > Prepare data > Connect to a data source. See Adding a connection to a project.
In a deployment space
Click Import assets > Data access > Connection. See Adding data assets to a deployment space.
In the Platform assets catalog
Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Where you can use this connection

You can use PostgreSQL connections in the following workspaces and tools:

Projects

  • AutoAI (Watson Machine Learning)
  • Decision Optimization (Watson Studio and Watson Machine Learning)
  • Data Refinery (Watson Studio)
  • Notebooks (Watson Studio). Click Read data on the Code snippets pane to get the connection credentials and load the data into a data structure. For more information, see Load data from data source connections.
  • SPSS Modeler (SPSS Modeler service)
  • Synthetic Data Generator (Synthetic Data Generator service)
  • Watson Machine Learning Accelerator (Watson Machine Learning Accelerator service)

Catalogs

  • Platform assets catalog

Federal Information Processing Standards (FIPS) compliance

This connection can be used on a FIPS-enabled cluster (FIPS tolerant); however, it is not FIPS-compliant.

PostgreSQL setup

PostgreSQL installation

Running SQL statements

To ensure that your SQL statements run correctly, refer to the SQL Syntax in the PostgreSQL documentation.

Learn more

PostgreSQL documentation

Parent topic: Supported connections