io.delta.kernel.internal

Class DeltaErrors

Object

io.delta.kernel.internal.DeltaErrors

public final class DeltaErrors
extends Object

Contains methods to create user-facing Delta exceptions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DeltaErrors.SupplierWithIOException<T>

Method Summary

Modifier and Type	Method and Description
static KernelException	cannotModifyTableProperty(String key)
static KernelException	columnInvariantsNotSupported()
static ConcurrentWriteException	concurrentDomainMetadataAction(DomainMetadata domainMetadataAttempt, DomainMetadata winningDomainMetadata)
static KernelException	concurrentTransaction(String appId, long txnVersion, long lastUpdated)
static KernelException	dataSchemaMismatch(String tablePath, StructType tableSchema, StructType dataSchema)
static KernelException	domainMetadataUnsupported()
static KernelException	duplicateColumnsInSchema(StructType schema, java.util.List<String> duplicateColumns)
static KernelException	endVersionNotFound(String tablePath, long endVersionRequested, java.util.Optional<Long> latestAvailableVersion)
static KernelException	invalidColumnName(String columnName, String unsupportedChars)
static KernelException	invalidConfigurationValueException(String key, String value, String helpMessage)
static KernelException	invalidVersionRange(long startVersion, long endVersion)
static KernelException	metadataChangedException()
static KernelException	missingNumRecordsStatsForIcebergCompatV2(DataFileStatus dataFileStatus)
static KernelException	noCommitFilesFoundForVersionRange(String tablePath, long startVersion, long endVersion)
static KernelException	partitionColumnMissingInData(String tablePath, String partitionColumn)
static KernelException	protocolChangedException(long attemptVersion)
static KernelException	requiresSchemaForNewTable(String tablePath)
static KernelException	startVersionNotFound(String tablePath, long startVersionRequested, java.util.Optional<Long> earliestAvailableVersion)
static KernelException	tableAlreadyExists(String tablePath, String message)
static KernelException	timestampAfterLatestCommit(String tablePath, long providedTimestamp, long latestCommitTimestamp, long latestCommitVersion)
static KernelException	timestampBeforeFirstAvailableCommit(String tablePath, long providedTimestamp, long earliestCommitTimestamp, long earliestCommitVersion)
static KernelException	unknownConfigurationException(String confKey)
static KernelException	unsupportedDataType(DataType dataType)
static KernelException	unsupportedPartitionDataType(String colName, DataType dataType)
static KernelException	unsupportedReaderFeature(String tablePath, java.util.Set<String> unsupportedFeatures)
static KernelException	unsupportedReaderProtocol(String tablePath, int tableReaderVersion)
static KernelException	unsupportedWriterFeature(String tablePath, String writerFeature)
static KernelException	unsupportedWriterProtocol(String tablePath, int tableWriterVersion)
static KernelException	versionAfterLatestCommit(String tablePath, long versionToLoad, long latestVersion)
static KernelException	versionBeforeFirstAvailableCommit(String tablePath, long versionToLoad, long earliestVersion)
static KernelException	voidTypeEncountered()
static <T> T	wrapEngineException(java.util.function.Supplier<T> f, String msgString, Object... args)
static <T> T	wrapEngineExceptionThrowsIO(DeltaErrors.SupplierWithIOException<T> f, String msgString, Object... args)

Methods inherited from class Object

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

Method Detail

versionBeforeFirstAvailableCommit

public static KernelException versionBeforeFirstAvailableCommit(String tablePath,
                                                                long versionToLoad,
                                                                long earliestVersion)

versionAfterLatestCommit

public static KernelException versionAfterLatestCommit(String tablePath,
                                                       long versionToLoad,
                                                       long latestVersion)

timestampBeforeFirstAvailableCommit

public static KernelException timestampBeforeFirstAvailableCommit(String tablePath,
                                                                  long providedTimestamp,
                                                                  long earliestCommitTimestamp,
                                                                  long earliestCommitVersion)

timestampAfterLatestCommit

public static KernelException timestampAfterLatestCommit(String tablePath,
                                                         long providedTimestamp,
                                                         long latestCommitTimestamp,
                                                         long latestCommitVersion)

noCommitFilesFoundForVersionRange

public static KernelException noCommitFilesFoundForVersionRange(String tablePath,
                                                                long startVersion,
                                                                long endVersion)

startVersionNotFound

public static KernelException startVersionNotFound(String tablePath,
                                                   long startVersionRequested,
                                                   java.util.Optional<Long> earliestAvailableVersion)

endVersionNotFound

public static KernelException endVersionNotFound(String tablePath,
                                                 long endVersionRequested,
                                                 java.util.Optional<Long> latestAvailableVersion)

invalidVersionRange

public static KernelException invalidVersionRange(long startVersion,
                                                  long endVersion)

unsupportedReaderProtocol

public static KernelException unsupportedReaderProtocol(String tablePath,
                                                        int tableReaderVersion)

unsupportedReaderFeature

public static KernelException unsupportedReaderFeature(String tablePath,
                                                       java.util.Set<String> unsupportedFeatures)

unsupportedWriterProtocol

public static KernelException unsupportedWriterProtocol(String tablePath,
                                                        int tableWriterVersion)

unsupportedWriterFeature

public static KernelException unsupportedWriterFeature(String tablePath,
                                                       String writerFeature)

columnInvariantsNotSupported

public static KernelException columnInvariantsNotSupported()

unsupportedDataType

public static KernelException unsupportedDataType(DataType dataType)

unsupportedPartitionDataType

public static KernelException unsupportedPartitionDataType(String colName,
                                                           DataType dataType)

duplicateColumnsInSchema

public static KernelException duplicateColumnsInSchema(StructType schema,
                                                       java.util.List<String> duplicateColumns)

invalidColumnName

public static KernelException invalidColumnName(String columnName,
                                                String unsupportedChars)

requiresSchemaForNewTable

public static KernelException requiresSchemaForNewTable(String tablePath)

tableAlreadyExists

public static KernelException tableAlreadyExists(String tablePath,
                                                 String message)

dataSchemaMismatch

public static KernelException dataSchemaMismatch(String tablePath,
                                                 StructType tableSchema,
                                                 StructType dataSchema)

missingNumRecordsStatsForIcebergCompatV2

public static KernelException missingNumRecordsStatsForIcebergCompatV2(DataFileStatus dataFileStatus)

partitionColumnMissingInData

public static KernelException partitionColumnMissingInData(String tablePath,
                                                           String partitionColumn)

concurrentTransaction

public static KernelException concurrentTransaction(String appId,
                                                    long txnVersion,
                                                    long lastUpdated)

metadataChangedException

public static KernelException metadataChangedException()

protocolChangedException

public static KernelException protocolChangedException(long attemptVersion)

voidTypeEncountered

public static KernelException voidTypeEncountered()

cannotModifyTableProperty

public static KernelException cannotModifyTableProperty(String key)

unknownConfigurationException

public static KernelException unknownConfigurationException(String confKey)

invalidConfigurationValueException

public static KernelException invalidConfigurationValueException(String key,
                                                                 String value,
                                                                 String helpMessage)

domainMetadataUnsupported

public static KernelException domainMetadataUnsupported()

concurrentDomainMetadataAction

public static ConcurrentWriteException concurrentDomainMetadataAction(DomainMetadata domainMetadataAttempt,
                                                                      DomainMetadata winningDomainMetadata)

wrapEngineException

public static <T> T wrapEngineException(java.util.function.Supplier<T> f,
                                        String msgString,
                                        Object... args)

wrapEngineExceptionThrowsIO

public static <T> T wrapEngineExceptionThrowsIO(DeltaErrors.SupplierWithIOException<T> f,
                                                String msgString,
                                                Object... args)
                                         throws java.io.IOException

Throws:

java.io.IOException