Package io.delta.kernel.internal
Class DeltaErrors
Object
io.delta.kernel.internal.DeltaErrors
Contains methods to create user-facing Delta exceptions.
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic KernelException
cannotModifyAppendOnlyTable
(String tablePath) static KernelException
static KernelException
static KernelException
static KernelException
columnNotFoundInSchema
(Column column, StructType tableSchema) static ConcurrentWriteException
concurrentDomainMetadataAction
(DomainMetadata domainMetadataAttempt, DomainMetadata winningDomainMetadata) static KernelException
concurrentTransaction
(String appId, long txnVersion, long lastUpdated) static KernelException
conflictWithReservedInternalColumnName
(String columnName) static KernelException
dataSchemaMismatch
(String tablePath, StructType tableSchema, StructType dataSchema) static KernelException
static KernelException
static KernelException
duplicateColumnsInSchema
(StructType schema, List<String> duplicateColumns) static KernelException
enablingClusteringOnPartitionedTableNotAllowed
(String tablePath, Set<String> partitionColNames, List<Column> clusteringCols) static KernelException
static KernelException
endVersionNotFound
(String tablePath, long endVersionRequested, long latestAvailableVersion) static KernelException
icebergCompatIncompatibleTableFeatures
(String compatVersion, Set<TableFeature> incompatibleFeatures) static KernelException
icebergCompatIncompatibleVersionEnabled
(String compatVersion, String incompatibleIcebergCompatVersion) static KernelException
icebergCompatMissingNumRecordsStats
(String compatVersion, DataFileStatus dataFileStatus) static KernelException
icebergCompatRequiredFeatureMissing
(String compatVersion, String feature) static KernelException
icebergCompatUnsupportedTypeColumns
(String compatVersion, List<DataType> dataTypes) static KernelException
icebergCompatUnsupportedTypePartitionColumn
(String compatVersion, DataType dataType) static KernelException
icebergWriterCompatInvalidPhysicalName
(List<String> invalidFields) 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
static KernelException
missingCheckpoint
(String tablePath, long checkpointVersion) static KernelException
static KernelException
noCommitFilesFoundForVersionRange
(String tablePath, long startVersion, long endVersion) static KernelException
overlappingTablePropertiesSetAndUnset
(Set<String> violatingKeys) static KernelException
partitionColumnMissingInData
(String tablePath, String partitionColumn) static KernelException
protocolChangedException
(long attemptVersion) static KernelException
static KernelException
requiresSchemaForNewTable
(String tablePath) static KernelException
static KernelException
startVersionNotFound
(String tablePath, long startVersionRequested, Optional<Long> earliestAvailableVersion) static KernelException
statsTypeMismatch
(String fieldName, DataType expected, DataType actual) 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
unsupportedReaderFeatures
(String tablePath, Set<String> readerFeatures) static KernelException
unsupportedReaderProtocol
(String tablePath, int tableReaderVersion) static KernelException
unsupportedStatsDataType
(DataType dataType) static KernelException
unsupportedTableFeature
(String feature) static KernelException
unsupportedWriterFeatures
(String tablePath, Set<String> writerFeatures) static KernelException
unsupportedWriterProtocol
(String tablePath, int tableWriterVersion) static KernelException
versionBeforeFirstAvailableCommit
(String tablePath, long versionToLoad, long earliestVersion) static KernelException
versionToLoadAfterLatestCommit
(String tablePath, long versionToLoad, long latestVersion) static KernelException
static <T> T
wrapEngineException
(Supplier<T> f, String msgString, Object... args) static <T> T
wrapEngineExceptionThrowsIO
(DeltaErrors.SupplierWithIOException<T> f, String msgString, Object... args)
-
Method Details
-
missingCheckpoint
-
versionBeforeFirstAvailableCommit
public static KernelException versionBeforeFirstAvailableCommit(String tablePath, long versionToLoad, long earliestVersion) -
versionToLoadAfterLatestCommit
public static KernelException versionToLoadAfterLatestCommit(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, Optional<Long> earliestAvailableVersion) -
endVersionNotFound
public static KernelException endVersionNotFound(String tablePath, long endVersionRequested, long latestAvailableVersion) -
invalidVersionRange
-
unsupportedReaderProtocol
-
unsupportedWriterProtocol
-
unsupportedTableFeature
-
unsupportedReaderFeatures
public static KernelException unsupportedReaderFeatures(String tablePath, Set<String> readerFeatures) -
unsupportedWriterFeatures
public static KernelException unsupportedWriterFeatures(String tablePath, Set<String> writerFeatures) -
columnInvariantsNotSupported
-
unsupportedDataType
-
unsupportedStatsDataType
-
unsupportedPartitionDataType
-
duplicateColumnsInSchema
public static KernelException duplicateColumnsInSchema(StructType schema, List<String> duplicateColumns) -
conflictWithReservedInternalColumnName
-
invalidColumnName
-
requiresSchemaForNewTable
-
requireSchemaForReplaceTable
-
tableAlreadyExists
-
dataSchemaMismatch
public static KernelException dataSchemaMismatch(String tablePath, StructType tableSchema, StructType dataSchema) -
statsTypeMismatch
public static KernelException statsTypeMismatch(String fieldName, DataType expected, DataType actual) -
columnNotFoundInSchema
-
overlappingTablePropertiesSetAndUnset
-
icebergCompatMissingNumRecordsStats
public static KernelException icebergCompatMissingNumRecordsStats(String compatVersion, DataFileStatus dataFileStatus) -
icebergCompatIncompatibleVersionEnabled
public static KernelException icebergCompatIncompatibleVersionEnabled(String compatVersion, String incompatibleIcebergCompatVersion) -
icebergCompatUnsupportedTypeColumns
public static KernelException icebergCompatUnsupportedTypeColumns(String compatVersion, List<DataType> dataTypes) -
icebergCompatUnsupportedTypePartitionColumn
public static KernelException icebergCompatUnsupportedTypePartitionColumn(String compatVersion, DataType dataType) -
icebergCompatIncompatibleTableFeatures
public static KernelException icebergCompatIncompatibleTableFeatures(String compatVersion, Set<TableFeature> incompatibleFeatures) -
icebergCompatRequiredFeatureMissing
public static KernelException icebergCompatRequiredFeatureMissing(String compatVersion, String feature) -
enablingIcebergWriterCompatV1OnExistingTable
-
icebergWriterCompatInvalidPhysicalName
-
disablingIcebergWriterCompatV1OnExistingTable
-
partitionColumnMissingInData
public static KernelException partitionColumnMissingInData(String tablePath, String partitionColumn) -
enablingClusteringOnPartitionedTableNotAllowed
-
concurrentTransaction
public static KernelException concurrentTransaction(String appId, long txnVersion, long lastUpdated) -
metadataChangedException
-
protocolChangedException
-
voidTypeEncountered
-
cannotModifyTableProperty
-
unknownConfigurationException
-
invalidConfigurationValueException
public static KernelException invalidConfigurationValueException(String key, String value, String helpMessage) -
domainMetadataUnsupported
-
concurrentDomainMetadataAction
public static ConcurrentWriteException concurrentDomainMetadataAction(DomainMetadata domainMetadataAttempt, DomainMetadata winningDomainMetadata) -
missingNumRecordsStatsForRowTracking
-
rowTrackingSupportedWithDomainMetadataUnsupported
-
cannotToggleRowTrackingOnExistingTable
-
cannotModifyAppendOnlyTable
-
wrapEngineException
-
wrapEngineExceptionThrowsIO
public static <T> T wrapEngineExceptionThrowsIO(DeltaErrors.SupplierWithIOException<T> f, String msgString, Object... args) throws IOException - Throws:
IOException
-