Additional docs for toast_tuple_target changes
authorSimon Riggs
Mon, 27 Nov 2017 09:51:51 +0000 (09:51 +0000)
committerSimon Riggs
Mon, 27 Nov 2017 09:51:51 +0000 (09:51 +0000)
doc/src/sgml/storage.sgml

index 128b19cbc9888551619569ad23c0257f1337a216..c0e548fa5bc862a305bc5a5c1453843249ce91f1 100644 (file)
@@ -429,7 +429,7 @@ when a row value to be stored in a table is wider than
 TOAST_TUPLE_THRESHOLD bytes (normally 2 kB).
 The TOAST code will compress and/or move
 field values out-of-line until the row value is shorter than
-TOAST_TUPLE_TARGET bytes (also normally 2 kB)
+TOAST_TUPLE_TARGET bytes (also normally 2 kB, adjustable)
 or no more gains can be had.  During an UPDATE
 operation, values of unchanged fields are normally preserved as-is; so an
 UPDATE of a row with out-of-line values incurs no TOAST costs if
@@ -483,6 +483,11 @@ of that data type, but the strategy for a given table column can be altered
 with ALTER TABLE ... SET STORAGE.
 
 
+
+TOAST_TUPLE_TARGET can be adjusted for each table using
+ALTER TABLE ... SET (toast_tuple_target = N)
+
+
 
 This scheme has a number of advantages compared to a more straightforward
 approach such as allowing row values to span pages.  Assuming that queries are