Ok, I had to change --retries to --tries ("retries" was misleading as it wasn't really the number of retries but actually the total number of tries), and enhance it thusly:
"""
=item --tries
type: array
How many times to try critical operations. If certain operations fail due
to non-fatal, recoverable errors, the tool waits and tries the operation
again. These are the operations that are retried, with their default number
of tries and wait time between tries (in seconds):
Ok, I had to change --retries to --tries ("retries" was misleading as it wasn't really the number of retries but actually the total number of tries), and enhance it thusly:
"""
=item --tries
type: array
How many times to try critical operations. If certain operations fail due
to non-fatal, recoverable errors, the tool waits and tries the operation
again. These are the operations that are retried, with their default number
of tries and wait time between tries (in seconds):
=for comment ignore- pt-internal- value
MAGIC_tries
OPERATION TRIES WAIT ======= ======= = ===== ==== foreign_ keys 10 1
====
create_triggers 10 1
drop_triggers 10 1
copy_rows 10 0.25
swap_tables 10 1
update_
To change the defaults, specify the new values like:
--tries create_ triggers: 5:0.5,drop_ triggers: 5:0.5
That makes the tool try C<create_triggers> and C<drop_triggers> 2 times
with a 0.5 second wait between tries. So the format is:
operation: tries:wait[ ,operation: tries:wait]
All three values must be specified.
...
"""