io.delta.kernel.internal.coordinatedcommits

Class CommitFailedException

Object

Throwable

Exception

io.delta.kernel.internal.coordinatedcommits.CommitFailedException

All Implemented Interfaces:

java.io.Serializable

@Evolving
public class CommitFailedException
extends Exception

Exception raised by CommitCoordinatorClientHandler.commit(java.lang.String, java.util.Map<java.lang.String, java.lang.String>, long, io.delta.kernel.utils.CloseableIterator<io.delta.kernel.data.Row>, io.delta.kernel.internal.coordinatedcommits.UpdatedActions)

  | retryable | conflict  | meaning                                                         |
  |   no      |   no      | something bad happened (e.g. auth failure)                      |
  |   no      |   yes     | permanent transaction conflict (e.g. multi-table commit failed) |
  |   yes     |   no      | transient error (e.g. network hiccup)                           |
  |   yes     |   yes     | physical conflict (allowed to rebase and retry)                 |
  

Since:

3.3.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CommitFailedException(boolean retryable, boolean conflict, String message)

Method Summary

Modifier and Type	Method and Description
boolean	getConflict() Returns whether the commit failed due to a conflict.
boolean	getRetryable() Returns whether the commit attempt can be retried.

Methods inherited from class Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CommitFailedException

public CommitFailedException(boolean retryable,
                             boolean conflict,
                             String message)

Method Detail

getRetryable

public boolean getRetryable()

Returns whether the commit attempt can be retried.

Returns:

whether the commit attempt can be retried.

getConflict

public boolean getConflict()

Returns whether the commit failed due to a conflict.

Returns:

whether the commit failed due to a conflict.