pgsql: Add pg_buffercache_evict() function for testing.

From: Thomas Munro <tmunro(at)postgresql(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Add pg_buffercache_evict() function for testing.
Date: 2024-04-08 05:02:55
Message-ID: E1rth9i-0014dZ-MS@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Add pg_buffercache_evict() function for testing.

When testing buffer pool logic, it is useful to be able to evict
arbitrary blocks. This function can be used in SQL queries over the
pg_buffercache view to set up a wide range of buffer pool states. Of
course, buffer mappings might change concurrently so you might evict a
block other than the one you had in mind, and another session might
bring it back in at any time. That's OK for the intended purpose of
setting up developer testing scenarios, and more complicated interlocking
schemes to give stronger guararantees about that would likely be less
flexible for actual testing work anyway. Superuser-only.

Author: Palak Chaturvedi <chaturvedipalak1911(at)gmail(dot)com>
Author: Thomas Munro <thomas(dot)munro(at)gmail(dot)com> (docs, small tweaks)
Reviewed-by: Nitin Jadhav <nitinjadhavpostgres(at)gmail(dot)com>
Reviewed-by: Andres Freund <andres(at)anarazel(dot)de>
Reviewed-by: Cary Huang <cary(dot)huang(at)highgo(dot)ca>
Reviewed-by: Cédric Villemain <cedric(dot)villemain+pgsql(at)abcsql(dot)com>
Reviewed-by: Jim Nasby <jim(dot)nasby(at)gmail(dot)com>
Reviewed-by: Maxim Orlov <orlovmg(at)gmail(dot)com>
Reviewed-by: Thomas Munro <thomas(dot)munro(at)gmail(dot)com>
Reviewed-by: Melanie Plageman <melanieplageman(at)gmail(dot)com>
Discussion: https://postgr.es/m/CALfch19pW48ZwWzUoRSpsaV9hqt0UPyaBPC4bOZ4W+c7FF566A@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/13453eedd3f692f8dcf8e334396eee84f00fdde2

Modified Files
--------------
contrib/pg_buffercache/Makefile | 2 +-
contrib/pg_buffercache/meson.build | 1 +
.../pg_buffercache/pg_buffercache--1.4--1.5.sql | 6 +++
contrib/pg_buffercache/pg_buffercache.control | 2 +-
contrib/pg_buffercache/pg_buffercache_pages.c | 20 +++++++
doc/src/sgml/pgbuffercache.sgml | 39 +++++++++++---
src/backend/storage/buffer/bufmgr.c | 63 ++++++++++++++++++++++
src/include/storage/bufmgr.h | 2 +
8 files changed, 127 insertions(+), 8 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Andres Freund 2024-04-08 05:13:02 pgsql: Remove references to old function name
Previous Message John Naylor 2024-04-08 03:52:14 pgsql: Fix alignment of stack variable