Deprecated API

Contents

• Interfaces
• Classes
• Fields
• Methods
• Constructors

Deprecated Interfaces

Interface	Description
org.apache.iceberg.encryption.KmsClient	the API will be removed in v2.0.0 (replaced with KeyManagementClient interface).
org.apache.iceberg.metrics.MetricsContext.Counter	will be removed in 2.0.0, use Counter instead.

Deprecated Classes

Class	Description
org.apache.iceberg.data.avro.DataReader	will be removed in 2.0.0; use PlannedDataReader instead.
org.apache.iceberg.data.parquet.BaseParquetReaders	since 1.8.0, will be made package-private in 1.9.0
org.apache.iceberg.data.parquet.BaseParquetWriter	since 1.8.0, will be made package-private in 1.9.0
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.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	Use TableProperties.WRITE_DATA_LOCATION instead.
org.apache.iceberg.TableProperties.WRITE_FOLDER_STORAGE_LOCATION	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.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.ContentFile.path()	since 1.7.0, will be removed in 2.0.0; use ContentFile.location() 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.hadoop.Util.blockLocations(CombinedScanTask, Configuration)	since 1.8.0, will be removed in 1.9.0; use Util.blockLocations(ScanTaskGroup, Configuration) instead.
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.ParquetValueReader.setPageSource(PageReadStore, long)	since 1.8.0, will be removed in 1.9.0; use ParquetValueReader.setPageSource(PageReadStore) instead.
org.apache.iceberg.parquet.VectorizedReader.setRowGroupInfo(PageReadStore, Map<ColumnPath, ColumnChunkMetaData>, long)	since 1.8.0, will be removed in 1.9.0; use VectorizedReader.setRowGroupInfo(PageReadStore, Map) 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.SetStatistics.setStatistics(long, StatisticsFile)	since 1.8.0, will be removed in 1.9.0 or 2.0.0, use SetStatistics.setStatistics(StatisticsFile).
org.apache.iceberg.TableMetadata.Builder.addSchema(Schema, int)	since 1.8.0, will be removed in 1.9.0 or 2.0.0, use AddSchema(schema).
org.apache.iceberg.TableMetadata.Builder.setStatistics(long, StatisticsFile)	since 1.8.0, will be removed 1.9.0 or 2.0.0, use setStatistics(statisticsFile).
org.apache.iceberg.TableMetadata.updateSchema(Schema, int)	since 1.8.0, will be removed in 1.9.0 or 2.0.0, use updateSchema(schema).
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.withFieldId(int)	will be removed in 2.0.0; use Types.NestedField.Builder.withId(int) instead
org.apache.iceberg.UpdateStatistics.setStatistics(long, StatisticsFile)	since 1.8.0, will be removed 1.9.0 or 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.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.MetadataUpdate.AddSchema(Schema, int)	since 1.8.0, will be removed 1.9.0 or 2.0.0, use AddSchema(schema).
org.apache.iceberg.MetadataUpdate.SetStatistics(long, StatisticsFile)	since 1.8.0, will be removed in 1.9.0 or 2.0.0, use SetStatistics(statisticsFile).
org.apache.iceberg.parquet.ParquetValueReaders.StructReader(List<Type>, List<ParquetValueReader<?>>)	will be removed in 1.9.0; use StructReader(List) instead.