Deprecated API

Contents

• Interfaces
• Classes
• Fields
• Methods
• Constructors

Deprecated Interfaces

Interface	Description
org.apache.iceberg.actions.FileRewriter	since 1.9.0, will be removed in 1.10.0; use FileRewritePlanner and FileRewriteRunner
org.apache.iceberg.encryption.KmsClient	the API will be removed in v2.0.0 (replaced with KeyManagementClient interface).
org.apache.iceberg.io.CredentialSupplier	since 1.10.0, will be removed in 2.0.0
org.apache.iceberg.metrics.MetricsContext.Counter	will be removed in 2.0.0, use Counter instead.

Deprecated Classes

Class	Description
org.apache.iceberg.actions.SizeBasedDataRewriter	since 1.9.0, will be removed in 1.10.0; use BinPackRewriteFilePlanner and FileRewriteRunner
org.apache.iceberg.actions.SizeBasedFileRewriter	since 1.9.0, will be removed in 1.10.0; use SizeBasedFileRewritePlanner and FileRewriteRunner
org.apache.iceberg.actions.SizeBasedPositionDeletesRewriter	since 1.9.0, will be removed in 1.10.0; use BinPackRewritePositionDeletePlanner and FileRewriteRunner
org.apache.iceberg.aws.RESTSigV4Signer	since 1.9.0, will be removed in 1.10.0; use RESTSigV4AuthManager instead.
org.apache.iceberg.data.avro.DataReader	will be removed in 2.0.0; use PlannedDataReader instead.
org.apache.iceberg.flink.source.FlinkSource	since 1.7.0, will be removed in 2.0.0. Use IcebergSource instead, which implement the newer FLIP-27 source interface. This class implements the old SourceFunction that has been marked as deprecated in Flink since Aug 2023.
org.apache.iceberg.flink.source.reader.AvroGenericRecordReaderFunction	since 1.7.0. Will be removed in 2.0.0; use IcebergSource.forOutputType(RowDataConverter) and AvroGenericRecordConverter instead.
org.apache.iceberg.MetadataUpdate.EnableRowLineage	will be removed in 1.10.0; row lineage is required for all v3+ tables.
org.apache.iceberg.MetadataUpdate.RemoveSnapshot	since 1.9.0, will be removed in 1.10.0; Use MetadataUpdate.RemoveSnapshots instead.
org.apache.iceberg.parquet.ParquetWriteAdapter	use ParquetWriter
org.apache.iceberg.SystemProperties	Use SystemConfigs instead; will be removed in 2.0.0

Deprecated Fields

Field	Description
org.apache.iceberg.SystemConfigs.NETFLIX_UNSAFE_PARQUET_ID_FALLBACK_ENABLED	will be removed in 2.0.0; use name mapping instead
org.apache.iceberg.TableProperties.MANIFEST_LISTS_ENABLED	will be removed in 2.0.0, writing manifest lists is always enabled
org.apache.iceberg.TableProperties.MANIFEST_LISTS_ENABLED_DEFAULT	will be removed in 2.0.0, writing manifest lists is always enabled
org.apache.iceberg.TableProperties.OBJECT_STORE_PATH	will be removed in 2.0.0, use TableProperties.WRITE_DATA_LOCATION instead.
org.apache.iceberg.TableProperties.ROW_LINEAGE	will be removed in 1.10.0; row lineage is required for all v3+ tables.
org.apache.iceberg.TableProperties.WRITE_FOLDER_STORAGE_LOCATION	will be removed in 2.0.0, use TableProperties.WRITE_DATA_LOCATION instead.
org.apache.iceberg.util.ThreadPools.WORKER_THREAD_POOL_SIZE_PROP	Use WORKER_THREAD_POOL_SIZE instead; will be removed in 2.0.0
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsLexer.tokenNames	Use IcebergSqlExtensionsLexer.VOCABULARY instead.
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsParser.tokenNames	Use IcebergSqlExtensionsParser.VOCABULARY instead.

Deprecated Methods

Method	Description
org.apache.iceberg.actions.RewriteFileGroup.fileScans()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.fileScanTasks()
org.apache.iceberg.actions.RewriteFileGroup.numFiles()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.inputFileNum()
org.apache.iceberg.actions.RewriteFileGroup.sizeInBytes()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.inputFilesSizeInBytes()
org.apache.iceberg.actions.RewritePositionDeletesGroup.numRewrittenDeleteFiles()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.inputFileNum()
org.apache.iceberg.actions.RewritePositionDeletesGroup.rewrittenBytes()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.inputFilesSizeInBytes()
org.apache.iceberg.actions.RewritePositionDeletesGroup.tasks()	since 1.9.0, will be removed in 1.10.0; use RewriteGroupBase.fileScanTasks()
org.apache.iceberg.avro.AvroSchemaUtil.pruneColumns(Schema, Set<Integer>, NameMapping)	will be removed in 2.0.0; use applyNameMapping and pruneColumns(Schema, Set) instead.
org.apache.iceberg.aws.AwsClientFactories.configureEndpoint(T, String)	Not for public use. To configure the endpoint for a client, please use S3FileIOProperties.applyEndpointConfigurations(S3ClientBuilder), AwsProperties.applyGlueEndpointConfigurations(GlueClientBuilder), or AwsProperties.applyDynamoDbEndpointConfigurations(DynamoDbClientBuilder) accordingly. It will be removed in 2.0.0
org.apache.iceberg.aws.AwsClientFactories.configureHttpClientBuilder(String)	Not for public use. To configure the httpClient for a client, please use HttpClientProperties.applyHttpClientConfigurations(AwsSyncClientBuilder). It will be removed in 2.0.0
org.apache.iceberg.aws.AwsClientFactories.s3Configuration(Boolean, Boolean)	Not for public use. To build an S3Configuration object, use S3Configuration.builder() directly. It will be removed in 2.0.0
org.apache.iceberg.common.DynConstructors.Ctor.invokeChecked(Object, Object...)	since 1.7.0, visibility will be reduced in 1.8.0
org.apache.iceberg.connect.Committer.start(Catalog, IcebergSinkConfig, SinkTaskContext)	will be removed in 2.0.0. Use Committer.open(Catalog, IcebergSinkConfig, SinkTaskContext, Collection) instead.
org.apache.iceberg.connect.Committer.stop()	will be removed in 2.0.0. Use Committer.close(Collection) instead.
org.apache.iceberg.ContentFile.path()	since 1.7.0, will be removed in 2.0.0; use ContentFile.location() instead.
org.apache.iceberg.data.parquet.GenericParquetReaders.createStructReader(List<Type>, List<ParquetValueReader<?>>, Types.StructType)	will be removed in 1.10.0; use GenericParquetReaders.createStructReader(List, StructType) instead.
org.apache.iceberg.data.parquet.GenericParquetWriter.buildWriter(MessageType)	will be removed in 1.10.0; use GenericParquetWriter.create(Schema, MessageType) instead.
org.apache.iceberg.data.parquet.GenericParquetWriter.createStructWriter(List<ParquetValueWriter<?>>)	will be removed in 1.10.0; use BaseParquetWriter.createWriter(Types.StructType, MessageType) instead.
org.apache.iceberg.data.parquet.InternalReader.createStructReader(List<Type>, List<ParquetValueReader<?>>, Types.StructType)	will be removed in 1.10.0; use InternalReader.createStructReader(List, StructType) instead.
org.apache.iceberg.data.parquet.InternalWriter.create(MessageType)	will be removed in 1.10.0; use InternalWriter.createWriter(Schema, MessageType) instead.
org.apache.iceberg.data.parquet.InternalWriter.createStructWriter(List<ParquetValueWriter<?>>)	will be removed in 1.10.0; use BaseParquetWriter.createWriter(Types.StructType, MessageType) instead.
org.apache.iceberg.flink.FlinkSchemaUtil.convert(TableSchema)	Use FlinkSchemaUtil.convert(ResolvedSchema) instead.
org.apache.iceberg.flink.source.FlinkSource.Builder.properties(Map<String, String>)	Use FlinkSource.Builder.setAll(java.util.Map<java.lang.String, java.lang.String>) instead.
org.apache.iceberg.flink.source.IcebergSource.builder()	since 1.7.0. Will be removed in 2.0.0; useIcebergSource.forRowData() or IcebergSource.forOutputType(RowDataConverter) instead
org.apache.iceberg.flink.source.IcebergSource.Builder.properties(Map<String, String>)	Use IcebergSource.Builder.setAll(java.util.Map<java.lang.String, java.lang.String>) instead.
org.apache.iceberg.flink.source.IcebergSource.Builder.readerFunction(ReaderFunction<T>)	since 1.7.0. Will be removed in 2.0.0; useIcebergSource.forOutputType(RowDataConverter) instead to produce output type other than RowData.
org.apache.iceberg.io.ContentCache.invalidateAll()	since 1.7.0, will be removed in 2.0.0; This method does only best-effort invalidation and is susceptible to a race condition. If the caller changed the state that could be cached (perhaps files on the storage) and calls this method, there is no guarantee that the cache will not contain stale entries some time after this method returns.
org.apache.iceberg.metrics.DefaultMetricsContext.counter(String, Class<T>, MetricsContext.Unit)	will be removed in 2.0.0, use Counter instead.
org.apache.iceberg.metrics.MetricsContext.counter(String, Class<T>, MetricsContext.Unit)	will be removed in 2.0.0, use MetricsContext.counter(String, Unit) instead.
org.apache.iceberg.metrics.MetricsContext.Counter.count()	Use MetricsContext.Counter.value()
org.apache.iceberg.MetricsConfig.fromProperties(Map<String, String>)	use MetricsConfig.forTable(Table)
org.apache.iceberg.parquet.Parquet.ReadBuilder.callInit()	will be removed in 2.0.0; use Parquet.ReadBuilder.createReaderFunc(Function) instead
org.apache.iceberg.parquet.Parquet.ReadBuilder.readSupport(ReadSupport<?>)	will be removed in 2.0.0; use Parquet.ReadBuilder.createReaderFunc(Function) instead
org.apache.iceberg.parquet.ParquetValueWriters.recordWriter(List<ParquetValueWriter<?>>)	will be removed in 1.10.0; use ParquetValueWriters.recordWriter(Types.StructType, List) instead.
org.apache.iceberg.PartitionStats.totalRecordCount()	since 1.9.0, will be removed in 1.10.0, use PartitionStats.totalRecords() instead.
org.apache.iceberg.RewriteFiles.rewriteFiles(Set<DataFile>, Set<DataFile>)	since 1.3.0, will be removed in 2.0.0
org.apache.iceberg.RewriteFiles.rewriteFiles(Set<DataFile>, Set<DataFile>, long)	since 1.3.0, will be removed in 2.0.0
org.apache.iceberg.RewriteFiles.rewriteFiles(Set<DataFile>, Set<DeleteFile>, Set<DataFile>, Set<DeleteFile>)	since 1.3.0, will be removed in 2.0.0
org.apache.iceberg.TableMetadata.Builder.enableRowLineage()	will be removed in 1.10.0; row lineage is required for all v3+ tables.
org.apache.iceberg.TableMetadata.rowLineageEnabled()	will be removed in 1.10.0; row lineage is required for all v3+ tables.
org.apache.iceberg.TableScan.appendsAfter(long)	since 1.0.0, will be removed in 2.0.0; use Table.newIncrementalAppendScan() instead.
org.apache.iceberg.TableScan.appendsBetween(long, long)	since 1.0.0, will be removed in 2.0.0; use Table.newIncrementalAppendScan() instead.
org.apache.iceberg.transforms.Transform.apply(S)	use Transform.bind(Type) instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transform.toHumanString(T)	use Transform.toHumanString(Type, Object) instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.bucket(Type, int)	use Transforms.bucket(int) instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.day(Type)	use Transforms.day() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.fromString(Type, String)	use Transforms.identity() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.hour(Type)	use Transforms.hour() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.identity(Type)	use Transforms.identity() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.month(Type)	use Transforms.month() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.truncate(Type, int)	use Transforms.truncate(int) instead; will be removed in 2.0.0
org.apache.iceberg.transforms.Transforms.year(Type)	use Transforms.year() instead; will be removed in 2.0.0
org.apache.iceberg.transforms.UnknownTransform.apply(S)	will be removed in 2.0.0; use UnknownTransform.bind(Type) instead
org.apache.iceberg.types.Types.NestedField.Builder.withInitialDefault(Object)	will be removed in 2.0.0; use Types.NestedField.Builder.withInitialDefault(Literal) instead.
org.apache.iceberg.types.Types.NestedField.Builder.withWriteDefault(Object)	will be removed in 2.0.0; use Types.NestedField.Builder.withWriteDefault(Literal) instead.
org.apache.iceberg.types.Types.NestedField.of(int, boolean, String, Type)	will be removed in 2.0.0; use Types.NestedField.builder() instead.
org.apache.iceberg.types.Types.NestedField.of(int, boolean, String, Type, String)	will be removed in 2.0.0; use Types.NestedField.builder() instead.
org.apache.iceberg.types.Types.NestedField.withFieldId(int)	will be removed in 2.0.0; use Types.NestedField.Builder.withId(int) instead
org.apache.iceberg.types.TypeUtil.SchemaVisitor.variant()	will be removed in 2.0.0; use TypeUtil.SchemaVisitor.variant(Types.VariantType) instead.
org.apache.iceberg.UpdateStatistics.setStatistics(long, StatisticsFile)	since 1.8.0, will be removed in 2.0.0, use UpdateStatistics.setStatistics(StatisticsFile).
org.apache.iceberg.util.ThreadPools.newWorkerPool(String)	will be removed in 2.0.0. Use ThreadPools.newExitingWorkerPool(String, int) for long-lived thread pools that require a shutdown hook, or ThreadPools.newFixedThreadPool(String, int) for short-lived thread pools where you manage the lifecycle.
org.apache.iceberg.util.ThreadPools.newWorkerPool(String, int)	will be removed in 2.0.0. Use ThreadPools.newExitingWorkerPool(String, int) for long-lived thread pools that require a shutdown hook, or ThreadPools.newFixedThreadPool(String, int) for short-lived thread pools where you manage the lifecycle.
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsLexer.getTokenNames()
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsParser.getTokenNames()

Deprecated Constructors

Constructor	Description
org.apache.iceberg.actions.RewriteFileGroup(RewriteDataFiles.FileGroupInfo, List<FileScanTask>)	since 1.9.0, will be removed in 1.10.0
org.apache.iceberg.actions.RewritePositionDeletesGroup(RewritePositionDeleteFiles.FileGroupInfo, List<PositionDeletesScanTask>)	since 1.9.0, will be removed in 1.10.0
org.apache.iceberg.data.avro.RawDecoder(Schema, Function<Schema, DatumReader<?>>, Schema)	will be removed in 2.0.0; use RawDecoder.create(org.apache.iceberg.Schema, Function, Schema) instead
org.apache.iceberg.GenericManifestFile(String, long, int, ManifestContent, long, long, Long, int, long, int, long, int, long, List<ManifestFile.PartitionFieldSummary>, ByteBuffer)	will be removed in 1.10.0; use ManifestWriter.toManifestFile() instead.