dbname
The database name. Defaults to be the same as the user name. In certain contexts, the value is checked for extended formats; see Section 32.1.1 for more details on those.
Reading PG 18·Select a recorded version
- Client library
- libpq 18.6
- Manual definition
- Documented
- Source environment fallback
- PGDATABASE
- Compiled fallback expression
- NULL
- default evidence
- Unknown
- documented
- true
- environment
- map[description:PGDATABASE behaves the same as the dbname connection parameter. name:PGDATABASE source_url:/docs/18/libpq-envars.html]
- keyword
- dbname
- manual path
- libpq-connect.html#LIBPQ-CONNECT-DBNAME
- signature
- dbname
Definition PG 18
dbname-
The database name. Defaults to be the same as the user name. In certain contexts, the value is checked for extended formats; see Section 32.1.1 for more details on those.
Environment fallback
| Variable | Documented behavior |
|---|---|
| PGDATABASE | PGDATABASE behaves the same as the dbname connection parameter. |
Compare versions
Complete source facts
precedence evidence
The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example., Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\postgresql\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR ., Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.
source option
{"compiled_default_expression":"NULL","declaration":"\"dbname\", \"PGDATABASE\", NULL, NULL, \"Database-Name\", \"\", 20, offsetof(struct pg_conn, dbName)","environment":"PGDATABASE","keyword":"dbname","source_notes":[]}Source references
- 18.6 English manual · libpq-connect.html
- 18.6 libpq connection option declarations
- 18.6 English manual · libpq-envars.html
- 18.6 English manual · libpq-pgservice.html
- Pinned PostgreSQL source archive
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8
Text language: en · ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8