Deprecated List

Deprecated Interfaces
Interface and 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 and Description
org.apache.iceberg.actions.BaseExpireSnapshotsActionResult will be removed in 1.3.0.
org.apache.iceberg.spark.FileScanTaskSetManager will be removed in 1.3.0, use `ScanTaskSetManager` instead
org.apache.iceberg.parquet.ParquetWriteAdapter use `ParquetWriter`

Deprecated Exceptions
Exceptions and Description
org.apache.iceberg.exceptions.RuntimeIOException Use java.io.UncheckedIOException directly instead. Exception used to wrap `IOException` as a `RuntimeException` and add context.

Deprecated Fields
Field and Description
org.apache.iceberg.CatalogProperties.AUTH_DEFAULT_REFRESH_ENABLED Will be removed in 1.3.0; Use `OAuth2Properties.TOKEN_REFRESH_ENABLED` to control token refresh behavior.
org.apache.iceberg.CatalogProperties.AUTH_DEFAULT_REFRESH_ENABLED_DEFAULT Will be removed in 1.3.0; Use `OAuth2Properties.TOKEN_REFRESH_ENABLED_DEFAULT` to control default token refresh behavior.
org.apache.iceberg.spark.SparkReadOptions.FILE_SCAN_TASK_SET_ID will be removed in 1.3.0, use SCAN_TASK_SET_ID instead
org.apache.iceberg.TableProperties.HMS_TABLE_OWNER will be removed in 1.3.0, use the HMS_TABLE_OWNER constant from HiveCatalog
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.MERGE_CARDINALITY_CHECK_ENABLED will be removed once Spark 3.1 support is dropped, the cardinality check is always performed starting from 0.13.0.
org.apache.iceberg.TableProperties.MERGE_CARDINALITY_CHECK_ENABLED_DEFAULT will be removed once Spark 3.1 support is dropped, the cardinality check is always performed starting from 0.13.0.
org.apache.iceberg.TableProperties.OBJECT_STORE_PATH Use `TableProperties.WRITE_DATA_LOCATION` instead.
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsParser.tokenNames Use `IcebergSqlExtensionsParser.VOCABULARY` instead.
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsLexer.tokenNames Use `IcebergSqlExtensionsLexer.VOCABULARY` instead.
org.apache.iceberg.TableProperties.WRITE_FOLDER_STORAGE_LOCATION Use `TableProperties.WRITE_DATA_LOCATION` instead.

Deprecated Methods
Method and Description
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.Transforms.bucket(Type, int) use `Transforms.bucket(int)` instead; will be removed in 2.0.0
org.apache.iceberg.rest.HTTPClient.builder() will be removed in 1.3.0; use `HTTPClient.builder(Map)`
org.apache.iceberg.spark.data.vectorized.VectorizedSparkParquetReaders.buildReader(Schema, MessageType, boolean) will be removed in 1.3.0, use `VectorizedSparkParquetReaders.buildReader(Schema, MessageType, Map, DeleteFilter)` instead.
org.apache.iceberg.spark.data.vectorized.VectorizedSparkParquetReaders.buildReader(Schema, MessageType, boolean, Map<Integer, ?>) will be removed in 1.3.0, use `VectorizedSparkParquetReaders.buildReader(Schema, MessageType, Map, DeleteFilter)` instead.
org.apache.iceberg.spark.data.vectorized.VectorizedSparkParquetReaders.buildReader(Schema, MessageType, boolean, Map<Integer, ?>, DeleteFilter<InternalRow>) will be removed in 1.3.0, use `VectorizedSparkParquetReaders.buildReader(Schema, MessageType, Map, DeleteFilter)` instead.
org.apache.iceberg.aws.AwsClientFactories.configureEndpoint(T, String) Not for public use. To configure the endpoint for a client, please use `AwsProperties.applyS3EndpointConfigurations(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 `AwsProperties.applyHttpClientConfigurations(AwsSyncClientBuilder)`. It will be removed in 2.0.0
org.apache.iceberg.metrics.MetricsContext.Counter.count() Use `Counter.value()`
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.DefaultMetricsContext.counter(String, Class<T>, MetricsContext.Unit) will be removed in 2.0.0, use `Counter` instead.
org.apache.iceberg.transforms.Transforms.day(Type) use `Transforms.day()` instead; will be removed in 2.0.0
org.apache.iceberg.spark.SparkReadConf.fileScanTaskSetId() will be removed in 1.3.0, use `SparkReadConf.scanTaskSetId()` instead
org.apache.iceberg.MetricsConfig.fromProperties(Map<String, String>) use `MetricsConfig.forTable(Table)`
org.apache.iceberg.spark.Spark3Util.getPartitions(SparkSession, Path, String, Map<String, String>) use `Spark3Util.getPartitions(SparkSession, Path, String, Map, PartitionSpec)`
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsParser.getTokenNames()
org.apache.spark.sql.catalyst.parser.extensions.IcebergSqlExtensionsLexer.getTokenNames()
org.apache.iceberg.Partitioning.groupingKeyType(Collection<PartitionSpec>) use `Partitioning.groupingKeyType(Schema, Collection)` instead; will be removed in 1.3.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.spark.SparkTableUtil.listPartition(SparkTableUtil.SparkPartition, PartitionSpec, SerializableConfiguration, MetricsConfig) use `TableMigrationUtil.listPartition(Map, String, String, PartitionSpec, Configuration, MetricsConfig, NameMapping)`
org.apache.iceberg.spark.SparkTableUtil.listPartition(SparkTableUtil.SparkPartition, PartitionSpec, SerializableConfiguration, MetricsConfig, NameMapping) use `TableMigrationUtil.listPartition(Map, String, String, PartitionSpec, Configuration, MetricsConfig, NameMapping)`
org.apache.iceberg.spark.SparkTableUtil.loadCatalogMetadataTable(SparkSession, Table, MetadataTableType) since 0.14.0, will be removed in 0.15.0; use `SparkTableUtil.loadMetadataTable(SparkSession, Table, MetadataTableType)`.
org.apache.iceberg.transforms.Transforms.month(Type) use `Transforms.month()` instead; will be removed in 2.0.0
org.apache.iceberg.BaseMetadataTable.operations() will be removed in 2.0.0; do not use metadata table TableOperations
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.properties(Map<String, String>) Use `IcebergSource.Builder.setAll(java.util.Map<java.lang.String, java.lang.String>)` instead.
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.jdbc.JdbcCatalog.setConf(Configuration) will be removed in 1.3.0; use `JdbcCatalog.setConf(Object)`
org.apache.iceberg.rest.RESTSessionCatalog.setConf(Configuration) will be removed in 1.3.0; use `RESTSessionCatalog.setConf(Object)`
org.apache.iceberg.rest.RESTCatalog.setConf(Configuration) will be removed in 1.3.0; use `RESTCatalog.setConf(Object)`
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.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

Deprecated Constructors
Constructor and Description
org.apache.iceberg.rest.auth.OAuth2Util.AuthSession(Map<String, String>, String, String) will be removed in 1.3.0; use `AuthSession(Map, String, String, String, String)` instead.
org.apache.iceberg.actions.BaseFileGroupRewriteResult(RewriteDataFiles.FileGroupInfo, int, int) Will be removed in 1.3.0; use `BaseFileGroupRewriteResult#BaseFileGroupRewriteResult(FileGroupInfo, int, int, long)` instead.
org.apache.iceberg.BaseMetadataTable(TableOperations, Table, String) will be removed in 1.3.0; use BaseMetadataTable(Table, String) instead.
org.apache.iceberg.DataTableScan(TableOperations, Table) will be removed in 1.3.0; use DataTableScan(Table, Schema, TableScanContext) instead.
org.apache.iceberg.DataTableScan(TableOperations, Table, Schema, TableScanContext) will be removed in 1.3.0; use DataTableScan(Table, Schema, TableScanContext) instead.

Deprecated API

Contents