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.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.data.avro.DataReader	will be removed in 2.0.0; use PlannedDataReader instead.
org.apache.iceberg.data.PartitionStatsHandler	since 1.10.0, will be removed in 1.11.0; use PartitionStatsHandler from core module
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.PartitionStatsUtil	since 1.10.0, will be removed in 1.11.0; use PartitionStatsHandler directly
org.apache.iceberg.rest.auth.RefreshingAuthManager	since 1.10.0, will be removed in 1.11.0; use ThreadPools.authRefreshPool().
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.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.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(S3BaseClientBuilder), 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.aws.s3.S3InputFile.fromLocation(String, long, S3Client, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3InputFile.fromLocation(String, long, PrefixedS3Client, MetricsContext) instead.
org.apache.iceberg.aws.s3.S3InputFile.fromLocation(String, long, S3Client, S3AsyncClient, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3InputFile.fromLocation(String, long, PrefixedS3Client, MetricsContext) instead.
org.apache.iceberg.aws.s3.S3InputFile.fromLocation(String, S3Client, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3InputFile.fromLocation(String, PrefixedS3Client, MetricsContext) instead.
org.apache.iceberg.aws.s3.S3InputFile.fromLocation(String, S3Client, S3AsyncClient, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3InputFile.fromLocation(String, PrefixedS3Client, MetricsContext) instead.
org.apache.iceberg.aws.s3.S3OutputFile.fromLocation(String, S3Client, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3OutputFile.fromLocation(String, PrefixedS3Client, MetricsContext) instead.
org.apache.iceberg.aws.s3.S3OutputFile.fromLocation(String, S3Client, S3AsyncClient, S3FileIOProperties, MetricsContext)	since 1.10.0, will be removed in 1.11.0; use S3OutputFile.fromLocation(String, PrefixedS3Client, MetricsContext) instead.
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.encryption.EncryptionUtil.createEncryptionManager(Map<String, String>, KeyManagementClient)	will be removed in 1.11.0; use EncryptionUtil.createEncryptionManager(List, Map, KeyManagementClient) instead.
org.apache.iceberg.flink.FlinkSchemaUtil.convert(TableSchema)	will be removed in 2.0.0; use FlinkSchemaUtil.convert(ResolvedSchema) instead.
org.apache.iceberg.flink.FlinkSchemaUtil.convert(Schema, TableSchema)	since 1.10.0, will be removed in 2.0.0. Use FlinkSchemaUtil.convert(Schema, ResolvedSchema) instead.
org.apache.iceberg.flink.FlinkSchemaUtil.toSchema(RowType)	since 1.10.0, will be removed in 2.0.0. Use FlinkSchemaUtil.toResolvedSchema(RowType) instead
org.apache.iceberg.flink.FlinkSchemaUtil.toSchema(Schema)	since 1.10.0, will be removed in 2.0.0. Use FlinkSchemaUtil.toResolvedSchema(Schema) instead
org.apache.iceberg.flink.sink.FlinkSink.forRow(DataStream<Row>, TableSchema)	since 1.10.0, will be removed in 2.0.0. Use FlinkSink.forRow(DataStream, ResolvedSchema) instead.
org.apache.iceberg.flink.sink.IcebergSink.forRow(DataStream<Row>, TableSchema)	Use IcebergSink.forRow(DataStream, 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.project(TableSchema)	since 1.10.0, will be removed in 2.0.0. Use IcebergSource.Builder.project(ResolvedSchema) instead.
org.apache.iceberg.flink.source.IcebergSource.Builder.properties(Map<String, String>)	will be removed in 2.0.0; 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.flink.util.FlinkCompatibilityUtil.isPhysicalColumn(TableColumn)	since 1.10.0, will be removed in 2.0.0.
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.PartitionStats.appendStats(PartitionStats)	since 1.10.0, visibility will be reduced in 1.11.0
org.apache.iceberg.PartitionStats.deletedEntry(Snapshot)	since 1.10.0, visibility will be reduced in 1.11.0
org.apache.iceberg.PartitionStats.liveEntry(ContentFile<?>, Snapshot)	since 1.10.0, visibility will be reduced in 1.11.0
org.apache.iceberg.PartitionStatsHandler.schema(Types.StructType)	since 1.10.0, will be removed in 1.11.0. Use PartitionStatsHandler.schema(StructType, int) instead.
org.apache.iceberg.rest.auth.OAuth2Util.exchangeToken(RESTClient, Map<String, String>, String, String, String, String, String)	since 1.10.0, will be removed in 1.11.0; use OAuth2Util.exchangeToken(RESTClient, Map, String, String, String, String, String, String, Map) instead.
org.apache.iceberg.rest.auth.OAuth2Util.exchangeToken(RESTClient, Map<String, String>, String, String, String, String, String, String)	since 1.10.0, will be removed in 1.11.0; use OAuth2Util.exchangeToken(RESTClient, Map, String, String, String, String, String, String, Map) instead.
org.apache.iceberg.rest.auth.OAuth2Util.fetchToken(RESTClient, Map<String, String>, String, String)	since 1.10.0, will be removed in 1.11.0; use OAuth2Util.fetchToken(RESTClient, Map, String, String, String, Map) instead.
org.apache.iceberg.rest.auth.OAuth2Util.fetchToken(RESTClient, Map<String, String>, String, String, String)	since 1.10.0, will be removed in 1.11.0; use OAuth2Util.fetchToken(RESTClient, Map, String, String, String, 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.RewriteTablePathUtil.rewriteDataManifest(ManifestFile, OutputFile, FileIO, int, Map<Integer, PartitionSpec>, String, String)	since 1.10.0, will be removed in 1.11.0
org.apache.iceberg.RewriteTablePathUtil.rewriteDeleteManifest(ManifestFile, OutputFile, FileIO, int, Map<Integer, PartitionSpec>, String, String, String)	since 1.10.0, will be removed in 1.11.0
org.apache.iceberg.RewriteTablePathUtil.stagingPath(String, String)	since 1.10.0, will be removed in 1.11.0. Use RewriteTablePathUtil.stagingPath(String, String, String) instead to avoid filename conflicts
org.apache.iceberg.TableMetadataParser.read(FileIO, InputFile)	since 1.10.0, will be removed in 1.11.0; use TableMetadataParser.read(InputFile) instead.
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.SnapshotUtil.newFiles(Long, long, Function<Long, Snapshot>, FileIO)	will be removed in 2.0.0, use SnapshotUtil.newFilesBetween(Long, long, Function, FileIO) instead.
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.aws.s3.S3FileIO(SerializableSupplier<S3Client>, S3FileIOProperties)	since 1.10.0, will be removed in 1.11.0; use S3FileIO(SerializableSupplier) with S3FileIO.initialize(Map) instead
org.apache.iceberg.aws.s3.S3FileIO(SerializableSupplier<S3Client>, SerializableSupplier<S3AsyncClient>, S3FileIOProperties)	since 1.10.0, will be removed in 1.11.0; use S3FileIO(SerializableSupplier, SerializableSupplier) with S3FileIO.initialize(Map) instead
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.flink.IcebergTableSink(TableLoader, TableSchema, ReadableConfig, Map<String, String>)	since 1.10.0, will be removed in 2.0.0. Use IcebergTableSink(TableLoader, ResolvedSchema, ReadableConfig, Map) instead
org.apache.iceberg.gcp.gcs.GCSFileIO(SerializableSupplier<Storage>, GCPProperties)	since 1.10.0, will be removed in 1.11.0; use GCSFileIO(SerializableSupplier) with GCSFileIO.initialize(Map) instead