Wiki / Statistics & Metrics / pg_stat_database
pg_stat_database.numbackends
Number of backends currently connected to this database, or NULL for shared objects. This is the only column in this view that returns a value reflecting current state; all other columns return the accumulated values since the last reset.
Reading PostgreSQL 18.6.
Description
Number of backends currently connected to this database, or NULL for shared objects. This is the only column in this view that returns a value reflecting current state; all other columns return the accumulated values since the last reset.
- View
- pg_stat_database
- Field
- numbackends
- SQL type
- integer
- Units named in the field definition
- Not specified
- Reset observation
- Time at which these statistics were last reset
Usage
SELECT numbackends FROM pg_catalog.pg_stat_database;View semantics
The pg_stat_database view will contain one row for each database in the cluster, plus one for shared objects, showing database-wide statistics.
Collection and reset context
Read the same-version statistics collection and view documentation below for reset scope and visibility. No per-field reset rule is inferred from the field name.
Inspect this field
Example query; no execution result or measured value is asserted.
SELECT numbackends FROM pg_catalog.pg_stat_database;Related entries
Documentation and source
Source build
- Version
- 18.6
- Build
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- Source fingerprint
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
Compare versions
PostgreSQL 17 → 18: unchanged.
Compares recorded interfaces and attributes. Source fingerprints and build metadata are excluded; an absent sample is not proof of the introduction or removal release.
Related entries
pg_stat_database.active_timepg_stat_database.blk_read_timepg_stat_database.blk_write_timepg_stat_database.blks_hitpg_stat_database.blks_readpg_stat_database.checksum_failurespg_stat_database.checksum_last_failurepg_stat_database.conflictspg_stat_database.datidpg_stat_database.datnamepg_stat_database.deadlockspg_stat_database.idle_in_transaction_time
Export JSON · Back to Statistics & Metrics · Recorded in PostgreSQL 10 through 20; the first sample is not necessarily its introduction.