select open change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

Supported versions: Current (18) / 17 / 16 / 15 / 14
Development versions: 19 / devel
Unsupported versions: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3
Historical version. PostgreSQL 7.3 reached end of support in November 2007. See the current version for supported releases.

4.2. Connecting to the Database Server

One connects to a database using the following statement:

EXEC SQL CONNECT TO target [AS connection-name] [USER user-name];

The target can be specified in the following ways:

  • dbname[@hostname][:port]

  • tcp:postgresql://hostname[:port][/dbname][?options]

  • unix:postgresql://hostname[:port][/dbname][?options]

  • character variable

  • character string

  • DEFAULT

There are also different ways to specify the user name:

  • userid

  • userid/password

  • userid IDENTIFIED BY password

  • userid USING password

The userid and password may be a constant text, a character variable, or a character string.

The connection-name is used to handle multiple connections in one program. It can be omitted if a program uses only one connection.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current version.