Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit c8f8d0e

Browse files
committed
Doc: add Buffer Access Strategy to the glossary
It seems useful to add this to the glossary as there's discussion around adding an option to VACUUM to disable and adjust the size of the buffer access strategy that VACUUM uses. Author: Melanie Plageman Reviewed-by: Justin Pryzby, David Rowley Discussion: https://postgr.es/m/ZBYDTrD1kyGg%2BHkS%40telsasoft.com
1 parent df4f3ab commit c8f8d0e

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

doc/src/sgml/glossary.sgml

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,34 @@
252252
</glossdef>
253253
</glossentry>
254254

255+
<glossentry id="glossary-buffer-access-strategy">
256+
<glossterm>Buffer Access Strategy</glossterm>
257+
<glossdef>
258+
<para>
259+
Some operations will access a large number of
260+
<glossterm linkend="glossary-data-page">pages</glossterm>. A
261+
<firstterm>Buffer Access Strategy</firstterm> helps to prevent these
262+
operations from evicting too many pages from
263+
<glossterm linkend="glossary-shared-memory">shared buffers</glossterm>.
264+
</para>
265+
<para>
266+
A Buffer Access Strategy sets up references to a limited number of
267+
<glossterm linkend="glossary-shared-memory">shared buffers</glossterm> and
268+
reuses them circularly. When the operation requires a new page, a victim
269+
buffer is chosen from the buffers in the strategy ring, which may require
270+
flushing the page's dirty data and possibly also unflushed
271+
<glossterm linkend="glossary-wal">WAL</glossterm> to permanent storage.
272+
</para>
273+
<para>
274+
Buffer Access Strategies are used for various operations such as
275+
sequential scans of large tables, <command>VACUUM</command>,
276+
<command>COPY</command>, <command>CREATE TABLE AS SELECT</command>,
277+
<command>ALTER TABLE</command>, <command>CREATE DATABASE</command>,
278+
<command>CREATE INDEX</command>, and <command>CLUSTER</command>.
279+
</para>
280+
</glossdef>
281+
</glossentry>
282+
255283
<glossentry id="glossary-cast">
256284
<glossterm>Cast</glossterm>
257285
<glossdef>

0 commit comments

Comments
 (0)