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

If you have set up an integrated cloud service, select the service instance to automatically fill in the fields in the connection form. Confirm that all the fields are complete.

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 Private connectivity, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a secure connection.

Where you can use this connection

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

Projects

• Cognos Dashboards (Cognos Dashboard Embedded service)
• Decision Optimization (watsonx.ai Studio and watsonx.ai Runtime)
• Data quality rules (IBM Knowledge Catalog)
• Data Refinery (watsonx.ai Studio or IBM Knowledge Catalog)
• DataStage (DataStage service). For more information, see Connecting to a data source in DataStage.
• Metadata enrichment (IBM Knowledge Catalog)
• Metadata import (IBM Knowledge Catalog)
• SPSS Modeler (watsonx.ai Studio)

Catalogs

• Platform assets catalog

• Other catalogs (IBM Knowledge Catalog)

Data lineage

• Metadata import (lineage) (IBM Knowledge Catalog and IBM Manta Data Lineage)

Data Virtualization service

You can connect to this data source from Data Virtualization.

PostgreSQL setup

PostgreSQL installation

Configuring lineage metadata import for PostgreSQL

When you create a metadata import for the PostgreSQL connection, you can set options specific to this data source, and define the scope of data for which lineage is generated. For details about metadata import, see Designing metadata imports.

To import lineage metadata for PostgreSQL, complete these steps:

1. Create a data source definition. Select PostgreSQL as the data source type.
2. Create a connection to the data source in a project.
3. Create a metadata import. Learn more about options that are specific to PostgreSQL data source:
   • When you define a scope, you can analyze the entire data source or use the include and exclude options to define the exact databases and schemas that you want to be analyzed. See Include and exclude lists.
   • Optionally, you can provide external input in the form of a .zip file. You add this file in the Add inputs from file field. The file must have a supported structure. See External inputs.
   • Optionally, specify advanced import options.

    <database_name>
        <schema_name>
           <script_name.sql>
    <database_name>
        <script_name.sql>
    <script_name.sql>
    replace.csv

Learn more

PostgreSQL documentation

Parent topic: Supported connections