Skip to content

Commit 1b6c239

Browse files
author
James William Pye
committed
Avoid the 'aborted copy' terminology.
Rather, just use failed. The contrast was rather slight.
1 parent d25b964 commit 1b6c239

1 file changed

Lines changed: 9 additions & 13 deletions

File tree

postgresql/documentation/copyman.txt

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -81,9 +81,8 @@ an iterator for controlling the COPY operation.
8181
be used until ``__exit__`` is ran.
8282

8383
``CopyManager.__exit__(typ, val, tb)``
84-
Finish, abort, or fail the COPY operation. Aborts in the case of an incomplete
85-
COPY or an unidentified exception, and fails in the case of an untrapped
86-
fault.
84+
Finish the COPY operation. Fails in the case of an incomplete
85+
COPY, or an untrapped exception.
8786

8887
``CopyManager.__iter__()``
8988
Returns the CopyManager instance.
@@ -106,7 +105,7 @@ The CopyManager generalizes some exceptions that occur during transfer. While
106105
inside the context manager, `postgresql.copyman.Fault` may be raised if a
107106
Receiver raises an exception. The Manager assumes the Fault is fatal to a
108107
Receiver, and immediately removes it from the set of target receivers.
109-
Additionally, if the Fault goes untrapped, the copy will be aborted.
108+
Additionally, if the Fault goes untrapped, the copy will fail.
110109

111110
The Fault exception references the Manager that raised the exception, and the
112111
actual exceptions that occurred, associated with the Receiver that caused them::
@@ -210,14 +209,11 @@ processes of the `postgresql.copyman` module:
210209

211210
Realignment
212211
The process of providing compensating data to the receivers so that the
213-
connection will be on a message boundary. Occurs when the COPY operation is
214-
aborted.
215-
216-
Aborted Copy
217-
An aborted copy is a COPY operation that terminated prematurely. This happens
218-
if a CopyManager's for-loop is terminated early by breaking or by an
219-
unidentified exception being raised.
212+
connection will be on a message boundary. Occurs when the COPY operation
213+
fails.
220214

221215
Failed Copy
222-
A failed copy is an aborted COPY operation that was
223-
*terminated due to a fault*, or a producer failure.
216+
A failed copy is an aborted COPY operation. This occurs in situations of
217+
untrapped exceptions or an incomplete COPY. Specifically, the COPY will be
218+
noted as failed in cases where the Manager's iterator is *not* ran until
219+
exhaustion.

0 commit comments

Comments
 (0)