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

Commit 81c48ae

Browse files
committed
Restructure streaming docs so streaming seems more integrated in the
paragraphs, per suggestion from Dan Birken.
1 parent 7ab6f2d commit 81c48ae

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

doc/src/sgml/high-availability.sgml

+8-7
Original file line numberDiff line numberDiff line change
@@ -486,27 +486,28 @@ protocol to make nodes agree on a serializable transactional order.
486486
<para>
487487
Directly moving WAL records from one database server to another
488488
is typically described as log shipping. <productname>PostgreSQL</>
489-
implements file-based log shipping, which means that WAL records are
490-
transferred one file (WAL segment) at a time. WAL files (16MB) can be
489+
implements file-based log shipping by transfering WAL records
490+
one file (WAL segment) at a time. WAL files (16MB) can be
491491
shipped easily and cheaply over any distance, whether it be to an
492492
adjacent system, another system at the same site, or another system on
493493
the far side of the globe. The bandwidth required for this technique
494494
varies according to the transaction rate of the primary server.
495-
Record-based log shipping is also possible with streaming replication
496-
(see <xref linkend="streaming-replication">).
495+
Record-based log shipping is more granular and streams WAL changes
496+
incrementally over a network connection (see <xref
497+
linkend="streaming-replication">).
497498
</para>
498499

499500
<para>
500-
It should be noted that the log shipping is asynchronous, i.e., the WAL
501+
It should be noted that log shipping is asynchronous, i.e., the WAL
501502
records are shipped after transaction commit. As a result, there is a
502503
window for data loss should the primary server suffer a catastrophic
503504
failure; transactions not yet shipped will be lost. The size of the
504505
data loss window in file-based log shipping can be limited by use of the
505506
<varname>archive_timeout</varname> parameter, which can be set as low
506507
as a few seconds. However such a low setting will
507508
substantially increase the bandwidth required for file shipping.
508-
If you need a window of less than a minute or so, consider using
509-
streaming replication (see <xref linkend="streaming-replication">).
509+
Streaming replication (see <xref linkend="streaming-replication">)
510+
allows a much smaller window of data loss.
510511
</para>
511512

512513
<para>

0 commit comments

Comments
 (0)