↑↓ select↵ open⌫ change scopeOpen full search

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

Wiki / System Catalogs

pg_shmem_allocations_numa

The pg_shmem_allocations_numa shows how shared memory allocations in the server's main shared memory segment are distributed across NUMA nodes. This includes both memory allocated by PostgreSQL itself and memory allocated by extensions using the mechanisms detailed in Section 36.10.11. This view will output multiple rows for each of the shared memory segments provided that they are spread across multiple NUMA nodes. This view should not be queried by monitoring systems as it is very slow and may end up allocating shared memory in case it was not used earlier. Current limitation for this view is that won't show anonymous shared memory allocations. Note that this view does not include memory allocated using the dynamic shared memory infrastructure.

English manual coverage begins with PostgreSQL 7.4. Source history and runtime observations have their own recorded version boundaries.

Reading PG 18·Select a recorded version

kind
view
lang
en
measured attributes
true
metadata release
18.6
runtime columns
name, numa_node, size
runtime verified
false
source
english-manual

Definition PG 18

The pg_shmem_allocations_numa shows how shared memory allocations in the server's main shared memory segment are distributed across NUMA nodes. This includes both memory allocated by PostgreSQL itself and memory allocated by extensions using the mechanisms detailed in Section 36.10.11. This view will output multiple rows for each of the shared memory segments provided that they are spread across multiple NUMA nodes. This view should not be queried by monitoring systems as it is very slow and may end up allocating shared memory in case it was not used earlier. Current limitation for this view is that won't show anonymous shared memory allocations. Note that this view does not include memory allocated using the dynamic shared memory infrastructure.

Catalog columns

ColumnTypeNullabilityDescription
nametextNullableThe name of the shared memory allocation.
numa_nodeint4NullableID of NUMA node
sizeint8NullableSize of the allocation on this particular NUMA memory node in bytes

Compare versions

Source references

Full definition and evidence JSON

Definition sources

center · PostgreSQL 18 · catalog-bilingual-repair:ff53ca2198544e03e0217f3551bac0b17d9689c802469e9d8225e6ce431448d5

Text language: en · catalog-bilingual-repair:ff53ca2198544e03e0217f3551bac0b17d9689c802469e9d8225e6ce431448d5